01: /*
02: * BEGIN_HEADER - DO NOT EDIT
03: *
04: * The contents of this file are subject to the terms
05: * of the Common Development and Distribution License
06: * (the "License"). You may not use this file except
07: * in compliance with the License.
08: *
09: * You can obtain a copy of the license at
10: * https://open-esb.dev.java.net/public/CDDLv1.0.html.
11: * See the License for the specific language governing
12: * permissions and limitations under the License.
13: *
14: * When distributing Covered Code, include this CDDL
15: * HEADER in each file and include the License file at
16: * https://open-esb.dev.java.net/public/CDDLv1.0.html.
17: * If applicable add the following below this CDDL HEADER,
18: * with the fields enclosed by brackets "[]" replaced with
19: * your own identifying information: Portions Copyright
20: * [year] [name of copyright owner]
21: */
22:
23: /*
24: * @(#)WsdlFactory.java
25: * Copyright 2004-2007 Sun Microsystems, Inc. All Rights Reserved.
26: *
27: * END_HEADER - DO NOT EDIT
28: */
29: package com.sun.jbi.wsdl2;
30:
31: /**
32: * This interface defines a factory API that enables applications to obtain
33: * instances of WSDL 2.0 API objects needed to begin using the API. The objects
34: * that can be created by this factory are:
35: * <ul>
36: * <li><b>Description.</b> An empty WSDL definitions component. This is useful for
37: * programatic creation of WSDL components.</li>
38: * <li><b>WsdlReader.</b> An object that can be used to read existing WSDL
39: * documents from a variety of sources, producing a Description component.</li>
40: * <li><b>WsdlWriter.</b> An object that can used to write a Description component
41: * to a variety of destinations. This is useful for persisting Description
42: * that were programatically created.</li>
43: * </ul>
44: *
45: * @author Sun Microsystems, Inc.
46: */
47: public interface WsdlFactory {
48: /**
49: * Create a new instance of a WSDL reader. A reader is useful for creating WSDL
50: * Description components from existing XML sources (that is, it can deserialize
51: * the XML presentation of WSDL).
52: *
53: * @return A new instance of a WSDL reader.
54: */
55: WsdlReader newWsdlReader();
56:
57: /**
58: * Create a new instance of a WSDL writer. A writer is useful for converting WSDL
59: * Description components in memory into a proper XML serialization.
60: *
61: * @return A new instance of a WSDL writer.
62: */
63: WsdlWriter newWsdlWriter();
64:
65: /**
66: * Create a new instance of a WSDL Description component. This is useful for
67: * programmatic creation of service descriptions.
68: *
69: * @param targetNamespace Target namespace for the new component.
70: * @return A new, empty WSDL Description component for the given target namespace.
71: */
72: Description newDescription(String targetNamespace);
73:
74: /**
75: * Create a new instance of a WSDL Definitions . This is useful for
76: * programmatic creation of service definitions. This method is for
77: * backward compatibility.
78: *
79: * @deprecated - replaced by newDescritption(String targetNamespace)
80: * @param targetNamespace Target namespace for the new component.
81: * @return A new, empty WSDL Definitions component for the given target namespace.
82: */
83: Definitions newDefinitions(String targetNamespace);
84:
85: }
|