Difference between revisions of "DataRetriever"
Line 5: | Line 5: | ||
! Attribute !! Type !! Description | ! Attribute !! Type !! Description | ||
|- | |- | ||
− | | cacheable || optional || | + | | cacheable || optional || If true the calculated function value, for the given parameters set, is cached for future access during the service processing.<br/> The cache is cancelled at service end. <br/> Default false. |
|- | |- | ||
− | | DataRetriever || optional || | + | | DataRetriever || optional || The helper function. Might contain [[placeholders]]. |
|- | |- | ||
| method || required || Helper function name. | | method || required || Helper function name. | ||
Line 13: | Line 13: | ||
| signature || optional || Comma-separated list of parameters name to be substituted in the function. | | signature || optional || Comma-separated list of parameters name to be substituted in the function. | ||
|} | |} | ||
+ | |||
+ | |||
+ | ==Examples of GenericRetriever services== | ||
+ | |||
+ | <syntaxhighlight lang="xml"> | ||
+ | <RetrieverConfig> | ||
+ | <GenericRetriever class="it.greenvulcano.gvesb.datahandling.utils.GenericRetriever" | ||
+ | type="retriever"> | ||
+ | |||
+ | <DataRetriever cacheable="true" method="getCityID" signature="NAME"> | ||
+ | select ID from CITY | ||
+ | where NAME='@{{NAME}}' | ||
+ | </DataRetriever> | ||
+ | |||
+ | <DataRetriever cacheable="true" method="getCityName" signature="ID"> | ||
+ | select NAME from CITY | ||
+ | where ID=@{{ID}} | ||
+ | </DataRetriever> | ||
+ | |||
+ | <DataRetriever method="getPersonID" signature="NAME,CITY"> | ||
+ | select ID from PERSON | ||
+ | where NAME='@{{NAME}}' | ||
+ | and ID_CITY=(select ID from CITY where NAME='@{{CITY}}') | ||
+ | </DataRetriever> | ||
+ | |||
+ | <DataRetriever cacheable="true" method="getCardID" signature="NUMBER,ID_OWNER"> | ||
+ | select ID from CREDIT_CARD | ||
+ | where CNUMBER='@{{NUMBER}}' | ||
+ | and ID_OWNER=@{{ID_OWNER}} | ||
+ | </DataRetriever> | ||
+ | |||
+ | <DataRetriever method="getSeqVal"> | ||
+ | select SEQ_PERSON_ID.nextval from dual | ||
+ | </DataRetriever> | ||
+ | </GenericRetriever> | ||
+ | </RetrieverConfig> | ||
+ | </syntaxhighlight> |
Revision as of 17:55, 23 February 2012
The GreenVulcano® ESB element DataRetriever defines a helper function.
It is defined by four parameters:
Attribute | Type | Description |
---|---|---|
cacheable | optional | If true the calculated function value, for the given parameters set, is cached for future access during the service processing. The cache is cancelled at service end. Default false. |
DataRetriever | optional | The helper function. Might contain placeholders. |
method | required | Helper function name. |
signature | optional | Comma-separated list of parameters name to be substituted in the function. |
Examples of GenericRetriever services
<RetrieverConfig>
<GenericRetriever class="it.greenvulcano.gvesb.datahandling.utils.GenericRetriever"
type="retriever">
<DataRetriever cacheable="true" method="getCityID" signature="NAME">
select ID from CITY
where NAME='@{{NAME}}'
</DataRetriever>
<DataRetriever cacheable="true" method="getCityName" signature="ID">
select NAME from CITY
where ID=@{{ID}}
</DataRetriever>
<DataRetriever method="getPersonID" signature="NAME,CITY">
select ID from PERSON
where NAME='@{{NAME}}'
and ID_CITY=(select ID from CITY where NAME='@{{CITY}}')
</DataRetriever>
<DataRetriever cacheable="true" method="getCardID" signature="NUMBER,ID_OWNER">
select ID from CREDIT_CARD
where CNUMBER='@{{NUMBER}}'
and ID_OWNER=@{{ID_OWNER}}
</DataRetriever>
<DataRetriever method="getSeqVal">
select SEQ_PERSON_ID.nextval from dual
</DataRetriever>
</GenericRetriever>
</RetrieverConfig>