|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
javax.xml.rpc Interface Service
public interface Service
Implements:
RegistryEntry
Service 实例是提供关于 Organization 所提供服务(例如,Web 服务)的信息的 RegistryObject。一个 Service 可以包含一组 ServiceBinding 实例。映射到 UDDI 中的 BusinessService。
See also | javax.xml.registry.infomodel.ServiceBinding |
Service
class acts as a factory of the following:
- Dynamic proxy for the target service endpoint.
- Instance of the type
javax.xml.rpc.Call
for the dynamic invocation of a remote operation on the target service endpoint. - Instance of a generated stub class
Method Summary | |
---|---|
Call |
createCall()
Creates a Call object not associated with
specific operation or target service endpoint. |
Call |
createCall(QName portName)
Creates a Call instance. |
Call |
createCall(QName portName,
QName operationName)
Creates a Call instance. |
Call |
createCall(QName portName,
String operationName)
Creates a Call instance. |
Call[] |
getCalls(QName portName)
Gets an array of preconfigured Call objects for
invoking operations on the specified port. |
HandlerRegistry |
getHandlerRegistry()
Returns the configured HandlerRegistry instance
for this Service instance. |
Remote |
getPort(Class serviceEndpointInterface)
The getPort method returns either an instance of a generated stub implementation class or a dynamic proxy. |
Remote |
getPort(QName portName,
Class serviceEndpointInterface)
The getPort method returns either an instance of a generated stub implementation class or a dynamic proxy. |
Iterator |
getPorts()
Returns an Iterator for the list of
QName s of service endpoints grouped by this
service |
QName |
getServiceName()
Gets the name of this service. |
TypeMappingRegistry |
getTypeMappingRegistry()
Gets the TypeMappingRegistry for this
Service object. |
URL |
getWSDLDocumentLocation()
Gets the location of the WSDL document for this Service. |
Method Detail |
---|
英文文档:
getPort
Remote getPort(QName portName, Class serviceEndpointInterface) throws ServiceException
- The getPort method returns either an instance of a generated
stub implementation class or a dynamic proxy. A service client
uses this dynamic proxy to invoke operations on the target
service endpoint. The
serviceEndpointInterface
specifies the service endpoint interface that is supported by the created dynamic proxy or stub instance. - Parameters:
portName
- Qualified name of the service endpoint in the WSDL service descriptionserviceEndpointInterface
- Service endpoint interface supported by the dynamic proxy or stub instance- Returns:
- java.rmi.Remote Stub instance or dynamic proxy that supports the specified service endpoint interface
- Throws:
ServiceException
- This exception is thrown in the following cases:- If there is an error in creation of the dynamic proxy or stub instance
- If there is any missing WSDL metadata as required by this method
- Optionally, if an illegal
serviceEndpointInterface
orportName
is specified
- See Also:
Proxy
,InvocationHandler
英文文档:
getPort
Remote getPort(Class serviceEndpointInterface) throws ServiceException
- The getPort method returns either an instance of a generated
stub implementation class or a dynamic proxy. The parameter
serviceEndpointInterface
specifies the service endpoint interface that is supported by the returned stub or proxy. In the implementation of this method, the JAX-RPC runtime system takes the responsibility of selecting a protocol binding (and a port) and configuring the stub accordingly. The returnedStub
instance should not be reconfigured by the client. - Parameters:
serviceEndpointInterface
- Service endpoint interface- Returns:
- Stub instance or dynamic proxy that supports the specified service endpoint interface
- Throws:
ServiceException
-- If there is an error during creation of stub instance or dynamic proxy
- If there is any missing WSDL metadata as required by this method
- Optionally, if an illegal
serviceEndpointInterface
is specified
英文文档:
getCalls
Call[] getCalls(QName portName) throws ServiceException
- Gets an array of preconfigured
Call
objects for invoking operations on the specified port. There is oneCall
object per operation that can be invoked on the specified port. EachCall
object is pre-configured and does not need to be configured using the setter methods onCall
interface.Each invocation of the
getCalls
method returns a new array of preconfiguredCall
objectsThis method requires the
Service
implementation class to have access to the WSDL related metadata. - Parameters:
portName
- Qualified name for the target service endpoint- Returns:
- Call[] Array of pre-configured Call objects
- Throws:
ServiceException
- If this Service class does not have access to the required WSDL metadata or if an illegalportName
is specified.
英文文档:
createCall
Call createCall(QName portName) throws ServiceException
- Creates a
Call
instance. - Parameters:
portName
- Qualified name for the target service endpoint- Returns:
- Call instance
- Throws:
ServiceException
- If any error in the creation of theCall
object
英文文档:
createCall
Call createCall(QName portName, QName operationName) throws ServiceException
- Creates a
Call
instance. - Parameters:
portName
- Qualified name for the target service endpointoperationName
- Qualified Name of the operation for which thisCall
object is to be created.- Returns:
- Call instance
- Throws:
ServiceException
- If any error in the creation of theCall
object
英文文档:
createCall
Call createCall(QName portName, String operationName) throws ServiceException
- Creates a
Call
instance. - Parameters:
portName
- Qualified name for the target service endpointoperationName
- Name of the operation for which thisCall
object is to be created.- Returns:
- Call instance
- Throws:
ServiceException
- If any error in the creation of theCall
object
英文文档:
createCall
Call createCall() throws ServiceException
- Creates a
Call
object not associated with specific operation or target service endpoint. ThisCall
object needs to be configured using the setter methods on theCall
interface. - Returns:
- Call object
- Throws:
ServiceException
- If any error in the creation of theCall
object
英文文档:
getServiceName
QName getServiceName()
- Gets the name of this service.
- Returns:
- Qualified name of this service
英文文档:
getPorts
Iterator getPorts() throws ServiceException
- Returns an
Iterator
for the list ofQName
s of service endpoints grouped by this service - Returns:
- Returns
java.util.Iterator
with elements of typejavax.xml.namespace.QName
- Throws:
ServiceException
- If this Service class does not have access to the required WSDL metadata
英文文档:
getWSDLDocumentLocation
URL getWSDLDocumentLocation()
- Gets the location of the WSDL document for this Service.
- Returns:
- URL for the location of the WSDL document for this service
英文文档:
getTypeMappingRegistry
TypeMappingRegistry getTypeMappingRegistry()
- Gets the
TypeMappingRegistry
for thisService
object. The returnedTypeMappingRegistry
instance is pre-configured to support the standard type mapping between XML and Java types types as required by the JAX-RPC specification. - Returns:
- The TypeMappingRegistry for this Service object.
- Throws:
java.lang.UnsupportedOperationException
- if the
Service
class does not support the configuration ofTypeMappingRegistry
.
英文文档:
getHandlerRegistry
HandlerRegistry getHandlerRegistry()
- Returns the configured
HandlerRegistry
instance for thisService
instance. - Returns:
- HandlerRegistry
- Throws:
java.lang.UnsupportedOperationException
- if theService
class does not support the configuration of aHandlerRegistry
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Submit a bug or feature
Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.
PS : 未经我党受权你也可自由散发此文档。 如有任何错误请自行修正;若因此而造成任何损失请直接找人民主席,请勿与本人联系。谢谢!