• If no replications are in process when the replicate call is made, the call stops the replication schedule, runs the
replication, and restarts the schedule from the time the call was made. For example, if replications had been scheduled on the hour, and the call is made at 9:15, replications will then occur at 10:15, 11:15, and so forth.
• If there is a replication in process when the replicate call is made, scheduling is stopped, the call waits for the current
process to conclude, runs the replication, and restarts schedule from the time the call was made as in the previous scenario.
WSDL
You can find the WSDL specification in the file replication_v3.wsdl
[http:www.systinet.comdocsr-65wsdl replication_v3.wsdl].
API Endpoint
You can find the Replication API endpoint at http:host name:portcontextuddireplication.
Java
The Java API is generated from the Replication WSDL. You are encouraged to browse its org.systinet.uddi.replication.v3.ReplicationApi
.
2.2.7. Statistics
The Statistics API provides useful information about Oracle Service Registry usage.
Data Structures
The following structures are used by the Statistics API:
accessStatisticsDetail
Table 24. Attributes
Required Attribute
yes enable
This structure is a container for zero or more apiStatisticsDetail
elements. The enable attribute is used to distinguish whether the returned data is consistent or not. If set to false, the Statistics interceptor has been configured not to run and
returned data will be outdated.
apiStatisticsDetail
Page 455
apiStatisticsDetail
Table 25. Attributes
Required Attribute
Yes apiName
Yes requestCount
Yes exceptionCount
Yes lastCall
This structure contains information about usage of the API specified in the attribute apiName and its methods. It also serves as a container for
methodStatisticsDetail elements.
The requestCount attribute holds a number indicating how many times this API has been used since its last reset or since Oracle Service Registry installation.
The exceptionCount attribute indicates the number of exceptions that have interrupted execution of the APIs methods. The lastCall attribute contains the time this API was last invoked.
methodStatisticsDetail
Table 26. Attributes
Required Attribute
Yes methodName
Yes requestCount
Yes exceptionCount
Yes lastCall
This element contains information about usage of the method specified in the attribute methodName. The requestCount attribute holds a number indicating how many times this method has been called since its last reset
or since Oracle Service Registry installation. The exceptionCount attribute indicates the number of exceptions that have interrupted execution of this method.
The lastCall attribute contains the time this method was last invoked.
structureStatisticsDetail
This structure serves as a container for the structure element.
Page 456
structureStatisticsDetail
Structure
Table 27. Attributes
Required Attribute
Yes name
Yes count
The structure element indicates how many UDDI structures of the type given by the name attribute are stored in the registry.
Operations get_accessStatistics
The get_accessStatistics API call is used to fetch information about usage of selected UDDI APIs in Oracle Service Registry. The filter element is used to specify which APIs statistics will be returned. If it is empty, the statistics for all
APIs are returned.
Arguments
• statistics:authInfo
- This optional argument is an element that contains an authentication token. •
statistics:filter - Optional regular expression to match selected APIs by their name. The wildcard characters
? and
are supported.
Returns
Upon successful completion, an accessStatisticsDetail structure is returned.
Permissions
This API call requires API manager permission for org.systinet.uddi.statistics.StatisticsApi and the action get_accessStatistics.
get_structureStatistics
The get_structureStatistics API call is used to get overview information about how many UDDI structures is stored within Oracle Service Registry.
Arguments
• statistics:authInfo
- This optional argument is an element that contains an authentication token.
Returns
Upon successful completion, an structureStatisticsDetail structure is returned.
Page 457
Returns
Permissions
This API call requires API manager permission for org.systinet.uddi.statistics.StatisticsApi and the action get_structureStatistics.
reset_accessStatistics
The reset_accessStatistics API call is used to reset API usage statistics in Oracle Service Registry. The optional filter element is used to limit affected APIs, if it is not set, statistics for all APIs is removed.
Arguments
• statistics:authInfo
- This optional argument is an element that contains an authentication token. •
statistics:filter - Optional regular expression to match selected APIs by their name. The wildcard characters
? and
are supported.
Permissions
This API call requires API manager permission for org.systinet.uddi.statistics.StatisticsApi and the action reset_accessStatistics.
WSDL
You can find the WSDL specification in the file statistics.wsdl
[http:www.systinet.comdocsr-65wsdlstatistics.wsdl].
API Endpoint
You can find the Statistics API endpoint at http:host name:portcontextuddistatistics.
Java
Java API is generated directly from WSDL. You are encouraged to browse org.systinet.uddi.statistics.StatisticsApi
.
2.2.8. WSDL Publishing
Oracle Service Registry WSDL-to-UDDI mapping is compliant with OASISs Technical Note, Using WSDL in a UDDI
registry Version 2.0 [http:www.oasis-open.orgcommitteesuddi-specdoctnuddi-spec-tc-tn-wsdl-v2.htm]. It enables
the automatic publishing of WSDL documents to UDDI, enables precise and flexible UDDI queries based on specific WSDL artifacts and metadata, and provides a consistent mapping for UDDI v2 and UDDI v3.
Data Structures wsdlDetail
wsdlDetail completes information about the WSDL to be mapped.
Page 458
wsdlDetail
Arguments
• wsdl2uddi:wsdl
- Contains URI or physical location of mapped WSDL. •
wsdl2uddi:wsdlMapping - Describes wsdl:types to be mapped.
wsdl
WSDL contains information about location of a mapped WSDL.
Arguments
• wsdlLocation
- The URI or physical location of a mapped WSDL. •
any - Used to make extensible documents see
XML schema [http:www.w3.orgTRxmlschema-1]. It is generally
used as the DOM pattern of a mapped WSDL.
wsdlMapping
WsdlMapping describes the wsdl:types to be mapped. It is used to alter the default behavior of mapping the specified WSDL. In contained structures, it is possible to describe each mapped wsdl:type correctly. This is to ensure exact
mapping and prevent duplication of data in the registry.
Arguments
• uddi:businessKey
- Represents the businessKey of an existing uddi:businessEntity to which the assigned wsdl:types
will be mapped. •
uddi:businessEntity - Represents an existing businessEntity to which the assigned wsdl:types will be mapped.
• wsdl2uddi:porttypes
- Represents the container of wsdl:portTypes to be mapped. wsdl2uddi:porttypes makes it possible map a uddi:tModel to its corresponding
wsdl:portType .
• wsdl2uddi:bindings
- Represents the container of wsdl:bindings to be mapped. wsdl2uddi:bindings makes it possible to map a uddi:tModel to its corresponding wsdl:binding.
• wsdl2uddi:services
- Represents the container of wsdl:services to be mapped. wsdl2uddi:services makes it possible to map a uddi:businessService to its corresponding wsdl:service.
Note
Note that uddi:businessKey and uddi:businessEntity are mutually exclusive.
Page 459
Arguments
