< prev index next >
src/java.xml.ws/share/classes/javax/xml/soap/SOAPElementFactory.java
Print this page
@@ -1,7 +1,7 @@
/*
- * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
@@ -24,20 +24,20 @@
*/
package javax.xml.soap;
/**
- * <code>SOAPElementFactory</code> is a factory for XML fragments that
+ * {@code SOAPElementFactory} 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>.
+ * can be inserted as children of the {@code SOAPHeader} or
+ * {@code SOAPBody} or {@code SOAPEnvelope}.
*
* <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.
+ * @deprecated - Use {@code javax.xml.soap.SOAPFactory} for creating SOAPElements.
* @see javax.xml.soap.SOAPFactory
* @since 1.6
*/
public class SOAPElementFactory {
@@ -46,21 +46,21 @@
private SOAPElementFactory(SOAPFactory soapFactory) {
this.soapFactory = soapFactory;
}
/**
- * Create a <code>SOAPElement</code> object initialized with the
- * given <code>Name</code> object.
+ * Create a {@code SOAPElement} object initialized with the
+ * given {@code Name} object.
*
- * @param name a <code>Name</code> object with the XML name for
+ * @param name a {@code Name} object with the XML name for
* the new element
*
- * @return the new <code>SOAPElement</code> object that was
+ * @return the new {@code SOAPElement} object that was
* created
*
* @exception SOAPException if there is an error in creating the
- * <code>SOAPElement</code> object
+ * {@code SOAPElement} object
*
* @deprecated Use
* javax.xml.soap.SOAPFactory.createElement(javax.xml.soap.Name)
* instead
*
@@ -70,21 +70,21 @@
public SOAPElement create(Name name) throws SOAPException {
return soapFactory.createElement(name);
}
/**
- * Create a <code>SOAPElement</code> object initialized with the
+ * Create a {@code SOAPElement} object initialized with the
* given local name.
*
- * @param localName a <code>String</code> giving the local name for
+ * @param localName a {@code String} giving the local name for
* the new element
*
- * @return the new <code>SOAPElement</code> object that was
+ * @return the new {@code SOAPElement} object that was
* created
*
* @exception SOAPException if there is an error in creating the
- * <code>SOAPElement</code> object
+ * {@code SOAPElement} object
*
* @deprecated Use
* javax.xml.soap.SOAPFactory.createElement(String localName) instead
*
* @see javax.xml.soap.SOAPFactory#createElement(java.lang.String)
@@ -92,21 +92,21 @@
public SOAPElement create(String localName) throws SOAPException {
return soapFactory.createElement(localName);
}
/**
- * Create a new <code>SOAPElement</code> object with the given
+ * Create a new {@code SOAPElement} object with the given
* local name, prefix and uri.
*
- * @param localName a <code>String</code> giving the local name
+ * @param localName a {@code String} 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
+ * @param prefix the prefix for this {@code SOAPElement}
+ * @param uri a {@code String} 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
+ * {@code SOAPElement} object
*
* @deprecated Use
* javax.xml.soap.SOAPFactory.createElement(String localName,
* String prefix,
* String uri)
@@ -118,16 +118,16 @@
throws SOAPException {
return soapFactory.createElement(localName, prefix, uri);
}
/**
- * Creates a new instance of <code>SOAPElementFactory</code>.
+ * Creates a new instance of {@code SOAPElementFactory}.
*
- * @return a new instance of a <code>SOAPElementFactory</code>
+ * @return a new instance of a {@code SOAPElementFactory}
*
* @exception SOAPException if there was an error creating the
- * default <code>SOAPElementFactory</code>
+ * default {@code SOAPElementFactory}
*/
public static SOAPElementFactory newInstance() throws SOAPException {
try {
return new SOAPElementFactory(SOAPFactory.newInstance());
} catch (Exception ex) {
< prev index next >