1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123
/* * $Id: SOAPElementFactory.java,v 1.4.2.7 2004/08/27 19:00:36 goodwin Exp $ * $Revision: 1.4.2.7 $ * $Date: 2004/08/27 19:00:36 $ */ /* * Copyright 2005 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package javax.xml.soap; /** * <code>SOAPElementFactory</code> is a factory for XML fragments that * will eventually end up in the SOAP part. These fragments * can be inserted as children of the <code>SOAPHeader</code> or * <code>SOAPBody</code> or <code>SOAPEnvelope</code>. * * <p>Elements created using this factory do not have the properties * of an element that lives inside a SOAP header document. These * elements are copied into the XML document tree when they are * inserted. * @deprecated - Use <code>javax.xml.soap.SOAPFactory</code> for creating SOAPElements. * @see javax.xml.soap.SOAPFactory */ public class SOAPElementFactory { private SOAPFactory soapFactory; private SOAPElementFactory(SOAPFactory soapFactory) { this.soapFactory = soapFactory; } /** * Create a <code>SOAPElement</code> object initialized with the * given <code>Name</code> object. * * @param name a <code>Name</code> object with the XML name for * the new element * * @return the new <code>SOAPElement</code> object that was * created * * @exception SOAPException if there is an error in creating the * <code>SOAPElement</code> object * * @deprecated Use * javax.xml.soap.SOAPFactory.createElement(javax.xml.soap.Name) * instead * * @see javax.xml.soap.SOAPFactory#createElement(javax.xml.soap.Name) * @see javax.xml.soap.SOAPFactory#createElement(javax.xml.namespace.QName) */ public SOAPElement create(Name name) throws SOAPException { return soapFactory.createElement(name); } /** * Create a <code>SOAPElement</code> object initialized with the * given local name. * * @param localName a <code>String</code> giving the local name for * the new element * * @return the new <code>SOAPElement</code> object that was * created * * @exception SOAPException if there is an error in creating the * <code>SOAPElement</code> object * * @deprecated Use * javax.xml.soap.SOAPFactory.createElement(String localName) instead * * @see javax.xml.soap.SOAPFactory#createElement(java.lang.String) */ public SOAPElement create(String localName) throws SOAPException { return soapFactory.createElement(localName); } /** * Create a new <code>SOAPElement</code> object with the given * local name, prefix and uri. * * @param localName a <code>String</code> giving the local name * for the new element * @param prefix the prefix for this <code>SOAPElement</code> * @param uri a <code>String</code> giving the URI of the * namespace to which the new element belongs * * @exception SOAPException if there is an error in creating the * <code>SOAPElement</code> object * * @deprecated Use * javax.xml.soap.SOAPFactory.createElement(String localName, * String prefix, * String uri) * instead * * @see javax.xml.soap.SOAPFactory#createElement(java.lang.String, java.lang.String, java.lang.String) */ public SOAPElement create(String localName, String prefix, String uri) throws SOAPException { return soapFactory.createElement(localName, prefix, uri); } /** * Creates a new instance of <code>SOAPElementFactory</code>. * * @return a new instance of a <code>SOAPElementFactory</code> * * @exception SOAPException if there was an error creating the * default <code>SOAPElementFactory</code> */ public static SOAPElementFactory newInstance() throws SOAPException { try { return new SOAPElementFactory(SOAPFactory.newInstance()); } catch (Exception ex) { throw new SOAPException( "Unable to create SOAP Element Factory: " + ex.getMessage()); } } }