Service (Java EE 5)

Java EE API


javax.xml.rpc Interface Service


public interface Service

Implements: RegistryEntry

Service 实例是提供关于 Organization 所提供服务(例如,Web 服务)的信息的 RegistryObject。一个 Service 可以包含一组 ServiceBinding 实例。映射到 UDDI 中的 BusinessService。
英文文档:

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

Version:
1.0
Author:
Rahul Sharma
See Also:
Call, Stub

Method Summary
 Call
 Call
 Call
 Call
 Call[]
 HandlerRegistry
 Remote
 Remote
 Iterator
 QName
 TypeMappingRegistry
 URL
 

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 description
serviceEndpointInterface - 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 or portName 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 returned Stub 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 one Call object per operation that can be invoked on the specified port. Each Call object is pre-configured and does not need to be configured using the setter methods on Call interface.

Each invocation of the getCalls method returns a new array of preconfigured Call objects

This 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 illegal portName 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 the Call object

英文文档:

createCall

Call createCall(QName portName,
                QName operationName)
                throws ServiceException
Creates a Call instance.

Parameters:
portName - Qualified name for the target service endpoint
operationName - Qualified Name of the operation for which this Call object is to be created.
Returns:
Call instance
Throws:
ServiceException - If any error in the creation of the Call object

英文文档:

createCall

Call createCall(QName portName,
                String operationName)
                throws ServiceException
Creates a Call instance.

Parameters:
portName - Qualified name for the target service endpoint
operationName - Name of the operation for which this Call object is to be created.
Returns:
Call instance
Throws:
ServiceException - If any error in the creation of the Call object

英文文档:

createCall

Call createCall()
                throws ServiceException
Creates a Call object not associated with specific operation or target service endpoint. This Call object needs to be configured using the setter methods on the Call interface.

Returns:
Call object
Throws:
ServiceException - If any error in the creation of the Call 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 of QNames of service endpoints grouped by this service

Returns:
Returns java.util.Iterator with elements of type javax.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 this Service object. The returned TypeMappingRegistry 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 of TypeMappingRegistry.

英文文档:

getHandlerRegistry

HandlerRegistry getHandlerRegistry()
Returns the configured HandlerRegistry instance for this Service instance.

Returns:
HandlerRegistry
Throws:
java.lang.UnsupportedOperationException - if the Service class does not support the configuration of a HandlerRegistry


Submit a bug or feature

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.

一看就知道只有菜鸟才干这么无知的事啦。

PS : 未经我党受权你也可自由散发此文档。 如有任何错误请自行修正;若因此而造成任何损失请直接找人民主席,请勿与本人联系。谢谢!