001: /*
002: * Copyright (c) 1998-2004 Caucho Technology -- all rights reserved
003: *
004: * This file is part of Resin(R) Open Source
005: *
006: * Each copy or derived work must preserve the copyright notice and this
007: * notice unmodified.
008: *
009: * Resin Open Source is free software; you can redistribute it and/or modify
010: * it under the terms of the GNU General Public License as published by
011: * the Free Software Foundation; either version 2 of the License, or
012: * (at your option) any later version.
013: *
014: * Resin Open Source is distributed in the hope that it will be useful,
015: * but WITHOUT ANY WARRANTY; without even the implied warranty of
016: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, or any warranty
017: * of NON-INFRINGEMENT. See the GNU General Public License for more
018: * details.
019: *
020: * You should have received a copy of the GNU General Public License
021: * along with Resin Open Source; if not, write to the
022: * Free SoftwareFoundation, Inc.
023: * 59 Temple Place, Suite 330
024: * Boston, MA 02111-1307 USA
025: *
026: * @author Scott Ferguson
027: */
028:
029: package javax.xml.rpc;
030:
031: import javax.xml.namespace.QName;
032: import javax.xml.rpc.encoding.TypeMappingRegistry;
033: import javax.xml.rpc.handler.HandlerRegistry;
034: import java.net.URL;
035: import java.rmi.Remote;
036: import java.util.Iterator;
037:
038: /**
039: * Abstract implementation of a XML-RPC service.
040: */
041: public interface Service {
042: /**
043: * Returns an implementation of the generated stub.
044: */
045: public Remote getPort(QName portName, Class serviceEndpoingInterface)
046: throws ServiceException;
047:
048: /**
049: * Returns an implementation of the generated stub.
050: */
051: public Remote getPort(Class serviceEndpoingInterface)
052: throws ServiceException;
053:
054: /**
055: * Returns the calls for the port.
056: */
057: public Call[] getCalls(QName portName) throws ServiceException;
058:
059: /**
060: * Returns the call for the port.
061: */
062: public Call createCall(QName portName) throws ServiceException;
063:
064: /**
065: * Returns the call for the port.
066: */
067: public Call createCall(QName portName, QName operationName)
068: throws ServiceException;
069:
070: /**
071: * Returns the call for the port.
072: */
073: public Call createCall(QName portName, String operationName)
074: throws ServiceException;
075:
076: /**
077: * Returns the call for the port.
078: */
079: public Call createCall() throws ServiceException;
080:
081: /**
082: * Returns the name of the service.
083: */
084: public QName getServiceName() throws ServiceException;
085:
086: /**
087: * Returns the service endpoing ports.
088: */
089: public Iterator getPorts() throws ServiceException;
090:
091: /**
092: * Returns the location of WSDL document.
093: */
094: public URL getWSDLDocumentLocation() throws ServiceException;
095:
096: /**
097: * Returns the TypeMappingRegistry for the Service.
098: */
099: public TypeMappingRegistry getTypeMappingRegistry();
100:
101: /**
102: * Returns the HandlerRegistry for the Service.
103: */
104: public HandlerRegistry getHandlerRegistry();
105: }
|