This convenience factory method works as if by invoking the - * {@link net.jxta.id.IDFactory#fromURI(URI)} method; any - * {@link java.net.URISyntaxException} thrown is caught and wrapped in a - * new {@link IllegalArgumentException} object, which is then thrown. - * - *
This method is provided for use in situations where it is known that
- * the given string is a legal ID, for example for ID constants declared
- * within in a program, and so it would be considered a programming error
- * for the URI not to parse as such. The {@link net.jxta.id.IDFactory},
- * which throws {@link java.net.URISyntaxException} directly, should be used
- * situations where a ID is being constructed from user input or from some
- * other source that may be prone to errors.
- *
- * @param fromURI The URI to be parsed into an ID
- * @return The new ID
- *
- * @throws NullPointerException If {@code fromURI} is {@code null}.
- * @throws IllegalArgumentException If the given URI is not a valid ID.
- */
- public static CodatID create(URI fromURI) {
- return (CodatID) ID.create(fromURI);
- }
-
- /**
- * {@inheritDoc}
- */
- public CodatID intern() {
- return (CodatID) super.intern();
- }
-
- /**
- * Returns PeerGroupID of the Peer Group to which this Codat ID belongs.
- *
- * @return PeerGroupID of the Peer Group which this ID is part of.
- */
- public abstract ID getPeerGroupID();
-
- /**
- * Returns true if this CodatID is associated with a static Codat.
- *
- * @return true if the codatId is for a Codat with static content
- * otherwise false.
- */
- public abstract boolean isStatic();
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/codat/Metadata.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/codat/Metadata.java
deleted file mode 100644
index 1d1f7bbd..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/codat/Metadata.java
+++ /dev/null
@@ -1,105 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * Each Advertisement holds a document that represents the advertisement.
- * Advertisements are typically represented as a text document (XML). The
- * {@link Advertisement#getDocument(MimeMediaType) getDocument(mimetype)}
- * method is used to generate representations of the advertisement. Different
- * representations are available via mime type selection. Typical mime types
- * are "text/xml" or "text/plain" that generate textual representations for the
- * Advertisements.
- *
- * Advertisements are created via {@link AdvertisementFactory} rather than
- * through use of constructors. This is done because public the Advertisement
- * sub-classes are typically abstract. The actual implementations are provided
- * by private sub-classes.
- *
- * @see net.jxta.document.AdvertisementFactory
- * @see net.jxta.document.ExtendableAdvertisement
- * @see net.jxta.id.ID
- * @see net.jxta.document.Document
- * @see net.jxta.document.MimeMediaType
- */
-public abstract class Advertisement {
-
- /**
- * {@inheritDoc}
- */
- @Override
- public Advertisement clone() throws CloneNotSupportedException {
- return (Advertisement) super.clone();
- }
-
- /**
- * Return a string representation of this advertisement. The string will
- * contain the advertisement pretty-print formatted as a UTF-8 encoded XML
- * Document.
- *
- * @return A String containing the advertisement.
- */
- @Override
- public String toString() {
- XMLDocument doc = (XMLDocument) getDocument(MimeMediaType.XMLUTF8);
-
- // Force pretty printing
- doc.addAttribute("xml:space", "default");
-
- return doc.toString();
- }
-
- /**
- * Returns the identifying type of this Advertisement.
- *
- *
- *
- *
- * Not all authentication methods use the identity nformation.
- *
- * @see net.jxta.credential.Credential
- * @see net.jxta.membership.MembershipService
- * @see net.jxta.membership.Authenticator
- */
-public final class AuthenticationCredential implements Credential {
-
- /**
- * Logger
- */
- private final static transient Logger LOG = Logger.getLogger(AuthenticationCredential.class.getName());
-
- /**
- * the authentication method which will be requested when this credential is
- * provided during "apply" to a peergroup membership service.
- */
- private String authenticationMethod = null;
-
- /**
- * Any optional information which is required by the requested authentication method.
- */
- private Element identityInfo = null;
-
- /**
- * The peergroup of this AuthenticationCredential
- */
- private final PeerGroup peergroup;
-
- /**
- * Creates new AuthenticationCredential
- *
- * @param peergroup The peergroup context in which this
- * AuthenticationCredential is created.
- * @param method The authentication method which will be requested when the
- * AuthentiationCredential is provided to the peergroup Membership Service.
- * Authentication methods are specific to Membership services. Consult the
- * Documentation for the Membership service you will be authenticating
- * against in order to determine the valid method values. Every
- * Membership service should support a default authentication method which
- * can be specified as null.
- * @param indentityInfo Optional additional information which is used by the
- * authentication method or null. This information is passed to the
- * authentication method during the apply operation of the Membership
- * Service. Consult the documentation for the specific Membership Service
- * you are using for details on how this information is used (if at all).
- */
- public AuthenticationCredential(PeerGroup peergroup, String method, Element indentityInfo) {
- this.peergroup = peergroup;
-
- authenticationMethod = method;
-
- if (null != indentityInfo) {
- this.identityInfo = StructuredDocumentUtils.copyAsDocument(indentityInfo);
- }
- }
-
- /**
- * Creates new AuthenticationCredential
- *
- * @param peergroup The peergroup context in which this
- * AuthenticationCredential is created.
- * @param root the document containing the serialized representation of the
- * AuthenticationCredential.
- */
- public AuthenticationCredential(PeerGroup peergroup, Element root) {
-
- this.peergroup = peergroup;
-
- initialize(root);
- }
-
- /**
- * {@inheritDoc}
- *
- * AuthenticationCredentials are created in the context of a PeerGroup
- * though they are generally independant of peergroups. The intent is that
- * the AuthenticationCredential will be passed to the MembershipService
- * service of the same peergroup as the AuthenticationCredenitals.
- *
- * @return PeerGroupID associated with this AuthenticationCredential.
- */
- public ID getPeerGroupID() {
- return peergroup.getPeerGroupID();
- }
-
- /**
- * {@inheritDoc}
- */
- public ID getPeerID() {
- return peergroup.getPeerID();
- }
-
- /**
- * {@inheritDoc}
- */
- public Service getSourceService() {
- return null;
- }
-
- /**
- * {@inheritDoc}
- *
- * AuthenticationCredential are never expired. The Authenticator will
- * determine the true validity from the included identity info.
- */
- public boolean isExpired() {
- return false;
- }
-
- /**
- * {@inheritDoc}
- *
- * AuthenticationCredential are always valid, the Authenticator will
- * determine the true validity from the included identity info.
- */
- public boolean isValid() {
- return true;
- }
-
- /**
- * {@inheritDoc}
- *
- * There is no straightforward mechansim for identifying the subject
- * unfortunately.
- */
- public Object getSubject() {
- return null;
- }
-
- /**
- * Write credential into a document. as is a mime media-type
- * specification and provides the form of the document which is being
- * requested. Two standard document forms are defined. "text/text" encodes
- * the document in a form nice for printing out and "text/xml" which
- * provides an XML format.
- *
- * @param as The mime media type of the encoding format being requested.
- * @return the StructuredDocument which represents this credential.
- * @throws Exception When errors occur.
- */
- public StructuredDocument getDocument(MimeMediaType as) throws Exception {
-
- StructuredDocument doc = StructuredDocumentFactory.newStructuredDocument(as, "jxta:Cred");
-
- if (doc instanceof Attributable) {
- ((Attributable) doc).addAttribute("xmlns:jxta", "http://jxta.org");
- ((Attributable) doc).addAttribute("xml:space", "preserve");
- ((Attributable) doc).addAttribute("type", "AuthenticationCredential");
- }
-
- Element e = doc.createElement("Method", getMethod());
-
- doc.appendChild(e);
-
- e = doc.createElement("PeerGroupID", getPeerGroupID().toString());
- doc.appendChild(e);
-
- e = doc.createElement("PeerID", getPeerID().toString());
- doc.appendChild(e);
-
- if (null != identityInfo) {
- e = doc.createElement("IdentityInfo");
- doc.appendChild(e);
-
- StructuredDocumentUtils.copyElements(doc, e, identityInfo);
- }
-
- return doc;
- }
-
- /**
- * Returns the authentication method which this AuthenticationCredential
- * will be requesting when it is provided to a Membership Service during the
- * "Apply" operation.
- *
- * @return String containing the authentication method being requested.
- */
- public String getMethod() {
- return authenticationMethod;
- }
-
- protected void setMethod(String authenticationMethod) {
- this.authenticationMethod = authenticationMethod;
- }
-
- /**
- * Returns the StructuredDocument Element containing the identity information which was
- * originally provided when this AuthenticationCredential was created.
- *
- * @return StructuredDocument Element containing the identity information which was
- * originally provided when this AuthenticationCredential was created.
- */
- public Element getIdentityInfo() {
- return (null == identityInfo) ? null : StructuredDocumentUtils.copyAsDocument(identityInfo);
- }
-
- /**
- * Process an individual element from the document.
- *
- * @param elem the element to be processed.
- * @return true if the element was recognized, otherwise false.
- */
- protected boolean handleElement(TextElement elem) {
- if (elem.getName().equals("PeerGroupID")) {
- try {
- URI gID = new URI(elem.getTextValue());
- ID pgid = IDFactory.fromURI(gID);
-
- if (!pgid.equals(getPeerGroupID())) {
- throw new IllegalArgumentException("Operation is from a different group. " + pgid + " != " + getPeerGroupID());
- }
- } catch (URISyntaxException badID) {
- throw new IllegalArgumentException("Unusable ID in advertisement: " + elem.getTextValue());
- }
- return true;
- }
-
- if (elem.getName().equals("PeerID")) {
- try {
- URI pID = new URI(elem.getTextValue());
- ID pid = IDFactory.fromURI(pID);
-
- if (!pid.equals(getPeerID())) {
- throw new IllegalArgumentException("Operation is from a different group. " + pid + " != " + getPeerID());
- }
- } catch (URISyntaxException badID) {
- throw new IllegalArgumentException("Bad Peer ID in advertisement: " + elem.getTextValue());
- } catch (ClassCastException badID) {
- throw new IllegalArgumentException("Id is not a peer id: " + elem.getTextValue());
- }
- return true;
- }
-
- if (elem.getName().equals("Method")) {
- setMethod(elem.getTextValue());
- return true;
- }
-
- if (elem.getName().equals("IdentityInfo")) {
- Enumeration firstChild = elem.getChildren();
-
- if (!firstChild.hasMoreElements()) {
- throw new IllegalArgumentException("Missing identity info");
- }
-
- identityInfo = StructuredDocumentUtils.copyAsDocument((Element) firstChild.nextElement());
-
- return true;
- }
-
- // element was not handled
- return false;
- }
-
- /**
- * Intialize from a portion of a structured document.
- *
- * @param root the element
- */
- protected void initialize(Element root) {
-
- if (!TextElement.class.isInstance(root)) {
- throw new IllegalArgumentException(getClass().getName() + " only supports TextElement");
- }
-
- TextElement doc = (TextElement) root;
-
- String typedoctype = "";
-
- if (root instanceof Attributable) {
- Attribute itsType = ((Attributable) root).getAttribute("type");
-
- if (null != itsType) {
- typedoctype = itsType.getValue();
- }
- }
-
- String doctype = doc.getName();
-
- if (!"jxta:AuthenticationCredential".equals(doctype) && !"jxta:AuthenticationCredential".equals(typedoctype)) {
- throw new IllegalArgumentException(
- "Could not construct : " + getClass().getName() + "from doc containing a " + doctype);
- }
-
- Enumeration elements = doc.getChildren();
-
- while (elements.hasMoreElements()) {
- TextElement elem = (TextElement) elements.nextElement();
-
- if (!handleElement(elem)) {
- if (Logging.SHOW_WARNING && LOG.isLoggable(Level.WARNING)) {
- LOG.warning("Unhandleded element \'" + elem.getName() + "\' in " + doc.getName());
- }
- }
- }
-
- // sanity check time!
-
- // FIXME bondolo@jxta.org 20030409 check things
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/credential/Credential.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/credential/Credential.java
deleted file mode 100644
index 9a42252b..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/credential/Credential.java
+++ /dev/null
@@ -1,166 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- *
- *
- *
- * The XML representation of a Credential uses the following very simple
- * schema. Credential implementations extend this schema as needed.
- *
- *
- * <xs:complexType name="Cred">
- * <xs:all>
- * </xs:all>
- * </xs:complexType>
- *
- */
-public interface Credential {
-
- /**
- * Returns the peerGroupID associated with this credential.
- *
- * @return The peerGroupID associated with this credential.
- */
- public ID getPeerGroupID();
-
- /**
- * Returns the peerID associated with this credential.
- *
- * @return The peerID associated with this credential.
- */
- public ID getPeerID();
-
- /**
- * Returns the service which generated this credential.
- *
- * @return The service which generated this credential.
- */
- public Service getSourceService();
-
- /**
- * Returns {@code true} if this credential is expired. Some credential
- * implementations may never expire.
- *
- * @return {@code true} if this credential is expired, otherwise
- * {@code false}.
- */
- public boolean isExpired();
-
- /**
- * Returns {@code true} if this credential is currently valid.
- *
- * @return {@code true} if the credential is currently valid, otherwise
- * {@code false}.
- */
- public boolean isValid();
-
- /**
- * Returns the subject of this credential. The Objects returned must
- * support {@link Object#equals(Object)} and {@link Object#hashCode()}.
- *
- * @return The subject of the credential as an abstract object.
- */
- public Object getSubject();
-
- /**
- * Write credential into a document. asMimeType is a mime
- * media-type specification and provides the form of the document which is
- * being requested. Two standard document forms are defined.
- * "{@code text/plain}" encodes the document in a "pretty-print" format
- * for human viewing and "{@code text/xml}" which provides an XML format.
- *
- * Depending on the credential format this document may be
- * cryptographically signed to prevent alteration.
- *
- * @param asMimeType MimeMediaType format representation requested
- * @return The credential serialized to a Document.
- * @throws Exception if an error occurs
- */
- public StructuredDocument getDocument(MimeMediaType asMimeType) throws Exception;
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/credential/CredentialPCLSupport.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/credential/CredentialPCLSupport.java
deleted file mode 100644
index 16bc378d..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/credential/CredentialPCLSupport.java
+++ /dev/null
@@ -1,112 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- *
- *
- *
- * @param propertyName the property to watch
- * @param listener the listener
- */
- public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener);
-
- /**
- * Remove a listener
- *
- * @param listener the listener
- */
- public void removePropertyChangeListener(PropertyChangeListener listener);
-
- /**
- * Remove a listener
- *
- * @param propertyName the property which was watched
- * @param listener the listener
- */
- public void removePropertyChangeListener(String propertyName, PropertyChangeListener listener);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/credential/CredentialValidator.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/credential/CredentialValidator.java
deleted file mode 100644
index 8e57de9a..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/credential/CredentialValidator.java
+++ /dev/null
@@ -1,71 +0,0 @@
-/*
-Copyright (c) 2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * expiredvalidnull.
- * @return true if verified
- */
- public boolean checkCred(Credential cred);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/credential/PrivilegedOperation.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/credential/PrivilegedOperation.java
deleted file mode 100644
index e8c83c96..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/credential/PrivilegedOperation.java
+++ /dev/null
@@ -1,81 +0,0 @@
-/*
-
- *
- * ====================================================================
- *
- * Copyright (c) 2001 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * DiscoverListener:
- *
- * Example 1:
- *
- * DiscoveryListener myListener = new DiscoveryListener() {
- * public void discoveryEvent(DiscoveryEvent e) {
- * DiscoveryResponseMsg msg = e.getResponse();
- * if (myQueryID == e.getQueryID()) {
- * int advCount = msg.getResponseCount();
- * }
- * }
- * discovery.addDiscoveryListener(myListener);
- * int myQueryID = discovery.getRemoteAdvertisements(address,
- * discovery.GROUP, attr, val,threshold);
- *
- *
- * Example 2:
- *
- * public class JxtaAppDemo implements Runnable, DiscoveryListener {
- * ..
- * ..
- * public void discoveryEvent(DiscoveryEvent ev) {
- *
- * DiscoveryResponseMsg res = ev.getResponse();
- * ..
- * ..
- * // see tutorial example 2 for full source
- * // JXTA Tutorials
- * }
- * }
- *
- *
- * @see net.jxta.discovery.DiscoveryService
- * @see net.jxta.discovery.DiscoveryEvent
- **/
-public interface DiscoveryListener extends EventListener {
-
- /**
- * Called to handle an event from the Discovery Service.
- *
- * @param event the discovery event
- */
- void discoveryEvent(DiscoveryEvent event);
-}
-
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/discovery/DiscoveryService.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/discovery/DiscoveryService.java
deleted file mode 100644
index 62ce541f..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/discovery/DiscoveryService.java
+++ /dev/null
@@ -1,506 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- *
- * discovery.getRemoteAdvertisements(null, discovery.ADV,
- * "Name", "Score tracker*", 10, null);
- *
- *
- *
- * In the above example, peers that are part of the soccer group would
- * respond. After a getRemoteAdvertisements call is made and the peers respond,
- * a call to getLocalAdvertisements can be made to retrieve results that have
- * been found and added to the local group cache. Alternately, a call to
- * addDiscoveryListener() will provide asynchronous notification of discovered
- * advertisements.
- *
- * When an Advertisement is published, it is stored, and indexed in the
- * peer's local cache. The Advertisement indexes are also shared with
- * Rendezvous peers. Advertisement indexes may not be shared with other
- * peers immediately, but may be updated as part of a periodic process. The
- * Discovery Service currently updates remote indexes every 30 seconds.
- *
- * It is important to note that what is shared with the rendezvous peer is
- * the index and expiration of the advertisement, not the advertisement. The
- * indexes are republished whenever the peer establishes a new connection with
- * a different rendezvous peer.
- *
- * Distributed index garbage collection. A rendezvous peer will GC indexes for
- * a specific peer when it receive a disconnect message, or it has determined
- * that a peer is no longer reachable, the latter action is a lazy GC and is
- * triggered by messenger creation failures which results in a mark and sweep at
- * a future point in time.
- *
- * DiscoveryService also provides a mechanism for publishing advertisements,
- * so that they may be discovered. The rules to follow when publishing are:
- *
- *
- *
- *
- * The threshold can be utilized in peer discovery in situations where a peer
- * is only interested in other peers, and not about additional peers they may
- * know about. To achieve this effect for peer discovery set the Threshold to
- * discovery.publish(adv);
- *
- * parent=soccerGroup.getParent();
- * discovery= parent.getDiscoveryService()
- * discovery.publish(adv);
- *
0 (zero).
- *
- * Advertisements are often stored in a persistent local cache. This cache
- * can improve performance and responsiveness by retaining advertisements
- * between restarts.
- *
- *@see net.jxta.service.Service
- *@see net.jxta.resolver.ResolverService
- *@see net.jxta.protocol.DiscoveryQueryMsg
- *@see net.jxta.protocol.DiscoveryResponseMsg
- *@see net.jxta.protocol.ResolverQueryMsg
- *@see net.jxta.protocol.ResolverResponseMsg
- */
-public interface DiscoveryService extends Service {
-
- /**
- * Discovery type Peer
- */
- public final static int PEER = 0;
-
- /**
- * Discovery type Group
- */
- public final static int GROUP = 1;
-
- /**
- * Discovery type Advertisement
- */
- public final static int ADV = 2;
-
- /**
- * Default lifetime time for advertisements. This is the maximum
- * amount of time which the advertisement will remain valid. If the
- * advertisement remains valid after this time, then the creator will
- * need to republish the advertisement.
- */
- public final static long DEFAULT_LIFETIME = 1000L * 60L * 60L * 24L * 365L;
-
- /**
- * Default expiration time for advertisements. This is the amount of
- * time which advertisements will live in caches. After this time, the
- * advertisement should be refreshed from the source.
- */
- public final static long DEFAULT_EXPIRATION = 1000L * 60L * 60L * 2L;
-
- /**
- * Infinite lifetime for advertisements. The advertisement is valid
- * forever. (well maybe it will expire when the sun burns out, but not
- * before then).
- */
- public final static long INFINITE_LIFETIME = Long.MAX_VALUE;
-
- /**
- * Specifies that the advertisement will have no expiration and will be
- * kept indefinitely.
- */
- public final static long NO_EXPIRATION = Long.MAX_VALUE;
-
- /**
- * Discover advertisements from remote peers. This does not normally
- * provide an exhaustive search. Instead it provides a "best efforts"
- * search which will provide a selection of advertisements of matching the
- * search criteria. The selection of advertisements returned may be random
- * or predictable depending upon the network configuration and no
- * particular behaviour should be assumed. In general the narrower the
- * query specified the more exhaustive the responses will be.
- *
- * Discovery can be performed in two ways :
- *
- *
- * The scope of advertisements returned can be narrowed by specifying
- * an {@code attribute} and {@code value} pair. The {@code attribute} is
- * a case-sensitive string matching the name of an Advertisement XML tag
- * who's values will be matched by the {@code value}. Only a limited number
- * of Advertisement XML fields are indexed. {@link
- * net.jxta.document.Advertisement#getIndexFields()} will return the
- * fields on which you may query for a particular Advertisement type.
- *
- * The {@code value} is a case-insensitive string who's value is
- * matched against the values of {@code attribute} fields of Advertisements.
- * The {@code} value may be of several forms :
- *
- *
- *
- * @param peerid If provided the query will be forwarded to the specified
- * peer. If {@code null} then the query will be propagated through the
- * network to peers with matching Advertisements.
- * @param type Discovery type; PEER, GROUP or ADV.
- * @param attribute indexed element name (see advertisement(s) for a
- * list of indexed fields. A null attribute indicates any advertisement
- * of specified type
- * @param value value of attribute to narrow discovery to. Valid values for
- * this parameter are null (don't care), Exact value, or use of wild
- * card(s) (e.g. if a Advertisement defines
- *
- *
- *
- * The scope of advertisements returned can be narrowed by specifying
- * an {@code attribute} and {@code value} pair. The {@code attribute} is
- * a case-sensitive string matching the name of an Advertisement XML tag
- * who's values will be matched by the {@code value}. Only a limited number
- * of Advertisement XML fields are indexed. {@link
- * net.jxta.document.Advertisement#getIndexFields()} will return the
- * fields on which you may query for a particular Advertisement type.
- *
- * The {@code value} is a case-insensitive string who's value is
- * matched against the values of {@code attribute} fields of Advertisements.
- * The {@code} value may be of several forms :
- *
- *
- *
- * @param peerid If provided the query will be forwarded to the specified
- * peer. If {@code null} then the query will be propagated through the
- * network to peers with matching Advertisements.
- * @param type Discovery type; PEER, GROUP or ADV.
- * @param attribute indexed element name (see Advertisement(s) for a
- * list of indexed fields. A null attribute indicates any advertisement
- * of specified type
- * @param value value of attribute to narrow discovery to. Valid values
- * for this parameter or {@code null} (don't care), Exact value, or use
- * of wild card(s) (e.g. if a Advertisement defines
- *
DEFAULT_LIFETIME and will expire on
- * other peers after DEFAULT_EXPIRATION.
- *
- * When an Advertisement is published, it is stored, and indexed in the
- * peer's local cache. The Advertisement indexes are also shared with
- * Rendezvous peers. Advertisement indexes may not be shared with other
- * peers immediately, but may be updated as part of a periodic process. The
- * Discovery Service currently publishes index updates every 30 seconds.
- *
- * @param adv The Advertisement to publish.
- * @throws IOException When an error occurs during Advertisement publication.
- */
- public void publish(Advertisement adv) throws IOException;
-
- /**
- * Publish an Advertisement. The Advertisement will expire automatically
- * after the specified time. A peer that discovers this advertisement will
- * hold it for about expiration or lifetime milliseconds,
- * whichever is smaller.
- *
- * When an Advertisement is published, it is stored, and indexed in the
- * peer's local cache. The Advertisement indexes are also shared with
- * Rendezvous peers. Advertisement indexes may not be shared with other
- * peers immediately, but may be updated as part of a periodic process. The
- * Discovery Service currently publishes index updates every 30 seconds.
- *
- * @param adv The Advertisement to publish.
- * @param lifetime Duration in relative milliseconds that this advertisement will exist.
- * @param expiration Duration in relative milliseconds that this advertisement will be cached by other peers.
- * @throws IOException When an error occurs during Advertisement publication.
- */
- public void publish(Advertisement adv, long lifetime, long expiration) throws IOException;
-
- /**
- * Publish an Advertisement via propagation to other peers on the network.
- * This does not result in the advertisement being stored locally. The
- * Advertisement will be published with an expiration time of
- * DEFAULT_EXPIRATION.
- *
- * @param adv Advertisement to publish.
- */
- public void remotePublish(Advertisement adv);
-
- /**
- * Publish an Advertisement via propagation to other peers on the network.
- * This does not result in the advertisement being stored locally.
- *
- * @param adv The Advertisement to publish.
- * @param expiration Duration in relative milliseconds that this
- * Advertisement will be cached by other peers.
- */
- public void remotePublish(Advertisement adv, long expiration);
-
- /**
- * Publish an Advertisement to another peer on the network.
- * This does not result in the advertisement being stored locally. The
- * Advertisement will be published with an expiration time of
- * DEFAULT_EXPIRATION.
- *
- *@param peerid The ID of a peer, specifying null results in
- * propagation within the group.
- *@param adv The Advertisement to publish.
- */
- public void remotePublish(String peerid, Advertisement adv);
-
- /**
- * Publish an Advertisement to another peer on the network. This does not
- * result in the advertisement being stored locally.
- *
- * @param peerid id of a peer, specifying null results in a propagate
- * within the group
- * @param adv The Advertisement to publish.
- * @param expiration Duration in relative milliseconds that this
- * Advertisement will be cached by other peers.
- */
- public void remotePublish(String peerid, Advertisement adv, long expiration);
-
- /**
- * Removes the specified Advertisement from the cache of locally stored
- * Advertisements.
- *
- * @param adv Advertisement to remove.
- * @throws IOException If there is a problem removing the advertisement.
- */
- public void flushAdvertisement(Advertisement adv) throws IOException;
-
- /**
- * Removes the specified Advertisement from the cache of locally stored
- * Advertisements.
- *
- * @param id The {@link Advertisement#getID()} value of the
- * Advertisement to be removed.
- * @param type Discovery type PEER, GROUP, ADV.
- * @throws IOException If there is a problem removing the advertisement.
- */
- public void flushAdvertisements(String id, int type) throws IOException;
-
- /**
- * Returns the maximum duration in milliseconds for which this document
- * will be cached by peers other than the publisher. This value is either
- * the stored lifetime or the remaining lifetime of the document, whichever
- * is less.
- *
- * @param id Document ID, Peer ID, or PeerGroup ID
- * @param type Discovery type PEER, GROUP, ADV
- * @return The number of milliseconds that other peers will be told to
- * retain this Advertisement in their local caches. -1 is returned if
- * the Advertisement is not known or already expired.
- */
- public long getAdvExpirationTime(ID id, int type);
-
- /**
- * Returns the maximum duration in milliseconds for which this document
- * should be kept in local cache.
- *
- * @param id Document ID, Peer ID, or PeerGroup ID
- * @param type Discovery type PEER, GROUP, ADV
- * @return The number of milliseconds this Advertisement will remain in the
- * local cache unless refreshed before that time. -1 is returned if the
- * Advertisement is not known or already expired.
- */
- public long getAdvLifeTime(ID id, int type);
-
- /**
- * Returns the maximum duration in milliseconds for which this document
- * will be cached by peers other than the publisher. This value is either
- * the stored lifetime or the remaining lifetime of the document, whichever
- * is less.
- *
- * @param adv Advertisement
- * @return The number of milliseconds that other peers will be told to
- * retain this Advertisement in their local caches. -1 is returned if
- * the Advertisement is not known or already expired.
- */
- public long getAdvExpirationTime(Advertisement adv);
-
- /**
- * Returns the maximum duration in milliseconds for which this document
- * should be kept in local cache.
- *
- * @param adv Advertisement
- * @return The number of milliseconds this Advertisement will remain in the
- * local cache unless refreshed before that time. -1 is returned if the
- * Advertisement is not known or already expired.
- */
- public long getAdvLifeTime(Advertisement adv);
-
- /**
- * Register a Discovery listener. The Discovery listener will be called
- * whenever Advertisement responses are received from remote peers by the
- * Discovery Service.
- *
- * @param listener the DiscoveryListener
- */
- public void addDiscoveryListener(DiscoveryListener listener);
-
- /**
- * Remove a Discovery listener which was previously registered with
- * {@link #getRemoteAdvertisements(String,int,String,String,int,DiscoveryListener) getRemoteAdvertisements()}
- * or {@link #addDiscoveryListener(DiscoveryListener) addDiscoveryListener()}.
- *
- * @param listener The listener to be removed.
- * @return true if the listener was successfully removed, false otherwise
- */
- public boolean removeDiscoveryListener(DiscoveryListener listener);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/discovery/package.html b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/discovery/package.html
deleted file mode 100644
index c304dd16..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/discovery/package.html
+++ /dev/null
@@ -1,15 +0,0 @@
-
-
-
-
-
-
- The JXTA Discovery Service provides an asynchronous mechanism for
- discovering Peer Advertisements, Group Advertisements, and other general
- JXTA Advertisements (pipes, services, etc.).
-
- @see net.jxta.resolver
- @see net.jxta.document.Advertisement
- @see JXTA Protocols Specification : Peer Discovery Protocol
-
-
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/Advertisement.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/Advertisement.java
deleted file mode 100644
index 88b88c8e..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/Advertisement.java
+++ /dev/null
@@ -1,231 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- *
- * Advertisement adv = module.getSomeAdv();
- * String advType = adv.getAdvertisementType();
- *
"text/plain" encodes
- * the document in a "pretty-print" format for human viewing and
- * "text/xml" which provides an XML format.
- *
- * @param asMimeType MimeMediaType format representation requested.
- * @return The {@code Advertisement} represented as a {@code Document} of
- * the requested MIME Media Type.
- */
- public abstract Document getDocument(MimeMediaType asMimeType);
-
- /**
- * Returns an ID which identifies this {@code Advertisement} as uniquely as
- * possible. This ID is typically used as the primary key for indexing of
- * the Advertisement within databases.
- *
- * Each advertisement sub-class must choose an appropriate implementation
- * which returns canonical and relatively unique ID values for it's
- * instances. Since this ID is commonly used for indexing, the IDs returned
- * must be as unique as possible to avoid collisions. The value for the ID
- * returned can either be:
- *
- *
- * - An ID which is already part of the advertisement definition
- * and is relatively unique between advertisements instances. For
- * example, the Peer Advertisement returns the Peer ID.
- *
- * - A static CodatID which is generated via some canonical process
- * which will produce the same value each time and different values for
- * different advertisements of the same type.
- *
- * - ID.nullID for advertisement types which are not readily indexed.
- *
- *
- *
- * For Advertisement types which normally return non-ID.nullID values
- * no ID should be returned when asked to generate an ID while the
- * Advertisement is an inconsistent state (example: uninitialized index
- * fields). Instead {@link java.lang.IllegalStateException} should be
- * thrown.
- *
- * @return An ID that relatively uniquely identifies this advertisement
- * or {@code ID.nullID} if this advertisement is of a type that is not
- * normally indexed.
- */
- public abstract ID getID();
-
- /**
- * Returns the element names on which this advertisement should be indexed.
- *
- * @return The element names on which this advertisement should be indexed.
- */
- public abstract String[] getIndexFields();
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/AdvertisementFactory.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/AdvertisementFactory.java
deleted file mode 100644
index aa870cdf..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/AdvertisementFactory.java
+++ /dev/null
@@ -1,401 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.io.InputStream;
-import java.io.Reader;
-import java.util.HashMap;
-import java.util.Map;
-
-import java.io.IOException;
-import java.util.NoSuchElementException;
-import java.util.MissingResourceException;
-
-import java.util.logging.Logger;
-import java.util.logging.Level;
-import net.jxta.logging.Logging;
-
-import net.jxta.util.ClassFactory;
-
-
-/**
- * A Factory class for constructing Advertisements. This class abstracts the
- * the implementations used to represent and create advertisements.
- *
- * Advertisements are core objects that are used to advertise a Peer, a
- * PeerGroup, a Service, a Pipe, etc. The Advertisement class provides a
- * platform independent representation of core objects that can be exchanged
- * between different implementations (Java, C).
- *
- * The AdvertisementFactory extends the ClassFactory to register the various
- * types of advertisements into an internal table. The factory is called with
- * the Advertisement type requested to create the corresponding advertisement
- * type.
- *
- * The set of Advertisements types supported is loaded from the JXTA
- * classpath via the service provider interface.
- *
- * @see net.jxta.document.Advertisement
- * @see net.jxta.document.Document
- * @see net.jxta.document.MimeMediaType
- * @see net.jxta.peergroup.PeerGroup
- * @see net.jxta.protocol.PeerAdvertisement
- * @see net.jxta.protocol.PeerGroupAdvertisement
- * @see net.jxta.protocol.PipeAdvertisement
- */
-public class AdvertisementFactory extends ClassFactory {
-
- /**
- * Logger
- */
- private static final Logger LOG = Logger.getLogger(AdvertisementFactory.class.getName());
-
- /**
- * Interface for instantiators of Advertisements
- */
- public interface Instantiator {
-
- /**
- * Returns the identifying type of this Advertisement.
- *
- * @return String the type of advertisement
- */
- String getAdvertisementType();
-
- /**
- * Constructs an instance of {@link Advertisement} matching the type
- * specified by the advertisementType parameter.
- *
- *
- * @return The instance of {@link Advertisement}.
- */
- Advertisement newInstance();
-
- /**
- * Constructs an instance of {@link Advertisement} matching the type
- * specified by the advertisementType parameter.
- *
- * @param root Specifies a portion of a @link StructuredDocument} which
- * will be converted into an Advertisement.
- * @return The instance of {@link Advertisement}.
- */
- Advertisement newInstance(net.jxta.document.Element root);
- }
-
- /**
- * This class is a singleton. This is the instance that backs the
- * static methods.
- */
- private final static AdvertisementFactory factory = new AdvertisementFactory();
-
- /**
- * This is the map of mime-types and constructors used by
- * {@code newAdvertisement}.
- */
- private final Map encodings = new HashMap();
-
- /**
- * If true then the pre-defined set of StructuredDocument sub-classes has
- * been registered from the property containing them.
- */
- private boolean loadedProperty = false;
-
- /**
- * Private constructor. This class is not meant to be instantiated except
- * by itself.
- *
- */
- private AdvertisementFactory() {}
-
- /**
- * Registers the pre-defined set of Advertisement sub-classes so that
- * this factory can construct them.
- *
- * @return true if at least one of the Advertisement sub-classes could
- * be registered otherwise false.
- */
- private synchronized boolean loadProviders() {
- if (!factory.loadedProperty) {
- factory.loadedProperty = registerProviders(Advertisement.class.getName());
- }
-
- return factory.loadedProperty;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected Map getAssocTable() {
- return encodings;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public Class getClassOfInstantiators() {
- // our key is the doctype names.
- return Instantiator.class;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public Class getClassForKey() {
- // our key is the doctype names.
- return java.lang.String.class;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected boolean registerAssoc(String className) {
- boolean registeredSomething = false;
-
- try {
- Class advClass = Class.forName(className + "$Instantiator");
-
- Instantiator instantiator = (Instantiator) advClass.newInstance();
-
- String advType = instantiator.getAdvertisementType();
-
- registeredSomething = registerAdvertisementInstance(advType, instantiator);
- } catch (Exception all) {
- if (Logging.SHOW_FINE && LOG.isLoggable(Level.FINE)) {
- LOG.log(Level.FINE, "Failed to register \'" + className + "\'", all);
- }
- }
-
- return registeredSomething;
- }
-
- /**
- * Register an instantiator for and advertisement type to allow instances
- * of that type to be created.
- *
- * @param rootType the identifying value for this advertisement instance
- * type.
- * @param instantiator the instantiator to use in constructing objects
- * of this rootType.
- * @return boolean true if the rootType type is registered. If there is
- * already a constructor for this type then false will be returned.
- */
- public static boolean registerAdvertisementInstance(String rootType, Instantiator instantiator) {
- boolean result = factory.registerAssoc(rootType, instantiator);
-
- return result;
- }
-
- /**
- * Constructs a new instance of {@link Advertisement} matching the type
- * specified by the {@code advertisementType} parameter.
- *
- * @param advertisementType Specifies the type of advertisement to create.
- * @return The instance of {@link Advertisement}.
- * @throws NoSuchElementException if there is no matching advertisement type.
- */
- public static Advertisement newAdvertisement(String advertisementType) {
- factory.loadProviders();
-
- Instantiator instantiator = factory.getInstantiator(advertisementType);
-
- Advertisement a = instantiator.newInstance();
-
- return a;
- }
-
- /**
- * Constructs an instance of {@link Advertisement} from the provided
- * InputStream. The content type of the stream is declared via
- * the mimetype parameter.
- *
- * @deprecated Please convert your code to construct an {@code XMLDocument}
- * using {@code StructuredDocumentFactory} and then call
- * {@link AdvertisementFactory#newAdvertisement(XMLElement)}. For example :
- *
- * XMLDocument xml = (XMLDocument) StructuredDocumentFactory.newStructuredDocument( MimeMediaType.XMLUTF8, is );
- *
- * or frequently:
- *
- * XMLDocument xml = (XMLDocument) StructuredDocumentFactory.newStructuredDocument( msgElement );
- *
- * followed by:
- *
- * Advertisement adv = AdvertisementFactory.newAdvertisement(xml);
- *
- *
- * @param mimetype Specifies the mime media type of the stream being read.
- * @param stream input stream used to read data to construct the advertisement
- * @return The instance of {@link Advertisement}
- * @throws IOException error reading message from input stream
- * @throws NoSuchElementException if there is no matching advertisement type
- * for the type of document read in.
- */
- @Deprecated
- public static Advertisement newAdvertisement(MimeMediaType mimetype, InputStream stream) throws IOException {
- StructuredDocument doc = StructuredDocumentFactory.newStructuredDocument(mimetype, stream);
-
- if (!(doc instanceof XMLDocument)) {
- throw new IllegalArgumentException("Advertisements must be XML");
- }
-
- return newAdvertisement((XMLDocument) doc);
- }
-
- /**
- * Reconstructs an instance of {@link Advertisement} from the provided
- * Reader. The content type of the reader is declared via the
- * mimetype parameter.
- *
- * @deprecated Please convert your code to construct an {@code XMLDocument}
- * using {@code StructuredDocumentFactory} and then call
- * {@link AdvertisementFactory#newAdvertisement(XMLElement)}. For example :
- *
- * XMLDocument xml = (XMLDocument) StructuredDocumentFactory.newStructuredDocument( MimeMediaType.XMLUTF8, reader );
- *
- * or frequently:
- *
- * XMLDocument xml = (XMLDocument) StructuredDocumentFactory.newStructuredDocument( msgElement );
- *
- * followed by:
- *
- * Advertisement adv = AdvertisementFactory.newAdvertisement(xml);
- *
- *
- * @param mimetype Specifies the mime media type of the stream being read.
- * @param source used to read data to construct the advertisement.
- * @return The instance of {@link Advertisement}
- * @throws IOException error reading message from input stream
- * @throws NoSuchElementException if there is no matching advertisement type
- * for the type of document read in.
- * @throws UnsupportedOperationException if the specified mime type is not
- * associated with a text oriented document type.
- */
- @Deprecated
- public static Advertisement newAdvertisement(MimeMediaType mimetype, Reader source) throws IOException {
- StructuredTextDocument doc = (StructuredTextDocument) StructuredDocumentFactory.newStructuredDocument(mimetype, source);
-
- return newAdvertisement(doc);
- }
-
- /**
- * Reconstructs an instance of {@link Advertisement} matching the type
- * specified by the {@code root} parameter.
- *
- * @deprecated Advertisements must be encoded in XML. This is a legacy
- * static constructor. You should convert your code to use the
- * {@link AdvertisementFactory#newAdvertisement(XMLElement) XMLElement}
- * version.
- *
- * @param root Specifies a portion of a StructuredDocument which will be
- * converted into an Advertisement.
- * @return The instance of {@link Advertisement}.
- * @throws NoSuchElementException if there is no advertisement type
- * matching the type of the root node.
- */
- @Deprecated
- public static Advertisement newAdvertisement(TextElement root) {
- if (!(root instanceof XMLElement)) {
- throw new IllegalArgumentException("Advertisements must be XML");
- }
-
- return newAdvertisement((XMLElement) root);
- }
-
- /**
- * Reconstructs an instance of {@link Advertisement} matching the type
- * specified by the {@code root} parameter.
- *
- * @param root Specifies a portion of an XMLElement which will be
- * converted into an Advertisement.
- * @return The instance of {@link Advertisement}.
- * @throws NoSuchElementException if there is no advertisement type
- * matching the type of the root node.
- */
- public static Advertisement newAdvertisement(XMLElement root) {
- factory.loadProviders();
-
- Instantiator instantiator = null;
-
- // The base type of the advertisement may be overridden by a type
- // declaration. If this is the case, then we try to use that as the
- // key rather than the root name.
- Attribute type = root.getAttribute("type");
-
- if (null != type) {
- try {
- instantiator = factory.getInstantiator(type.getValue());
- } catch (NoSuchElementException notThere) {
- // do nothing, its not fatal
- ;
- }
- }
-
- // Don't have an instantiator for the type attribute, try the root name
- if (null == instantiator) {
- instantiator = factory.getInstantiator(root.getName());
- }
-
- Advertisement a = instantiator.newInstance(root);
-
- return a;
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/Attributable.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/Attributable.java
deleted file mode 100644
index eee48900..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/Attributable.java
+++ /dev/null
@@ -1,118 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.util.Enumeration;
-
-
-/**
- * Interface for name value pairs to be associated with some base object.
- *
- * @see net.jxta.document.Attribute
- * @see net.jxta.document.StructuredDocument
- * @see net.jxta.document.Element
- */
-public interface Attributable {
-
- /**
- * Adds an attribute with the given name and value. Some implementations
- * may support only a single value for each distinct name. Others may
- * support multiple values for each name. If the value being provided
- * replaces some other value then that value is returned otherwise null
- * is returned.
- *
- * @param name name of the attribute.
- * @param value value for the attribute.
- * @return String containing previous value for this name if the value
- * is being replaced otherwise null.
- */
- String addAttribute(String name, String value);
-
- /**
- * Adds an attribute with the given name and value. Some implementations
- * may support only a single value for each distinct name. Others may
- * support multiple values for each name. If the value being provided
- * replaces some other value then that value is returned otherwise null
- * is returned.
- *
- * @param newAttrib new attribute.
- * @return String containing previous value for this name if the value
- * is being replaced otherwise null.
- */
- String addAttribute(Attribute newAttrib);
-
- /**
- * Returns an enumerations of the attributes associated with this object.
- * Each element is of type Attribute.
- *
- * @return Enumeration the attributes associated with this object.
- */
- Enumeration getAttributes();
-
- /**
- * Returns a single attribute which matches the name provided. If no such
- * named attribute exists then null is returned. For implementations of
- * this interface which support multiple values for each name only the
- * first value will be returned. To access all values for a name you must
- * use getAttributes.
- *
- * @param name the attribute name
- * @return Attribute the attributes matching the given name.
- */
- Attribute getAttribute(String name);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/Attribute.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/Attribute.java
deleted file mode 100644
index 1d746627..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/Attribute.java
+++ /dev/null
@@ -1,189 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-/**
- * A name value pair which is associated with some base object.
- *
- * @see net.jxta.document.Attributable
- * @see net.jxta.document.StructuredDocument
- * @see net.jxta.document.Element
- *
- **/
-public class Attribute {
-
- /**
- * The object which this attribute extends.
- **/
- private Attributable owner;
-
- /**
- * Our name
- **/
- private String name;
-
- /**
- * Our value
- **/
- private String value;
-
- /**
- * Constructor for a new attribute which can be added to an
- * {@link Attributable}.
- *
- * @param name Name for this attribute.
- * @param value Value for this attribute.
- **/
- public Attribute(String name, String value) {
- this(null, name, value);
- }
-
- /**
- * Constructor for a new attribute which is associated with an
- * @link Attributable} object.
- *
- * @param owner The Atrributable owner of this attribute or null.
- * @param name Name for this attribute.
- * @param value Value for this attribute.
- **/
- public Attribute(Attributable owner, String name, String value) {
- this.owner = owner;
- this.name = name;
- this.value = value;
- }
-
- /**
- * {@inheritDoc}
- **/
- @Override
- protected Object clone() {
- return this; // immutable so we can return self.
- }
-
- /**
- * {@inheritDoc}
-
- * The two attributes are the same if they have
- * the same owner, name and value.
- *
- * @param target Attribute to be checked with
- * @return boolean if the attributes are equal otherwise false.
- **/
- @Override
- public boolean equals(Object target) {
- if (this == target) {
- return true;
- }
-
- if (target instanceof Attribute) {
- Attribute targAttrib = (Attribute) target;
-
- boolean result = ((owner.equals(targAttrib.owner)) && name.equals(targAttrib.name) && value.equals(targAttrib.name));
-
- return result;
- } else {
- return false;
- }
- }
-
- /**
- * {@inheritDoc}
- **/
- @Override
- public int hashCode() {
- int result = name.hashCode() ^ value.hashCode();
-
- result ^= (null != owner) ? owner.hashCode() : 0;
- return result;
- }
-
- /**
- * {@inheritDoc}
- **/
- @Override
- public String toString() {
- return "<" + name + " = \"" + value + "\">";
- }
-
- /**
- * Return name of this attribute
- *
- * @return String containing the attribute's name.
- **/
- public String getName() {
- return name;
- }
-
- /**
- * Return the {@link Attributable} which is the owner of this attribute.
- *
- * @return Attributable object which owns this attribute.
- **/
- public Attributable getOwner() {
- return owner;
- }
-
- /**
- * Return value of this attribute
- *
- * @return String containing the attribute's value.
- **/
- public String getValue() {
- return value;
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/BinaryDocument.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/BinaryDocument.java
deleted file mode 100644
index 04b6c919..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/BinaryDocument.java
+++ /dev/null
@@ -1,153 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.io.ByteArrayInputStream;
-import java.io.InputStream;
-import java.io.OutputStream;
-import java.io.IOException;
-
-
-/**
- * This class is an implementation of the Document interface. It is perhaps the
- * simplest implementation of the Document interface possible.
- */
-public class BinaryDocument implements Document {
-
- /**
- * Our Mime Media Types
- */
- private static final MimeMediaType[] myTypes = {
- MimeMediaType.AOS
- };
-
- /**
- * Storage for our bytes.
- */
- private final byte[] ourBytes;
-
- /**
- * The MIME type of this document.
- */
- private final MimeMediaType ourType;
-
- /**
- * Returns the MIME Media types supported by this this Document per
- * {@link IETF RFC 2046 MIME : Media Types}.
- *
- * Jxta does not currently support the 'Multipart' or 'Message' media types.
- *
- * @return An array of MimeMediaType objects containing the MIME Media Type
- * for this Document.
- */
- public static MimeMediaType[] getSupportedMimeTypes() {
- return (myTypes.clone());
- }
-
- /**
- * Creates new BinaryDocument from a byte array. The data in the array is
- * not copied. If you intend to modify the array after creating a document
- * then you should pass a copy of the data instead.
- *
- * @param someBytes Contains a byte array which will serve as our data.
- */
- public BinaryDocument(byte[] someBytes) {
- this(someBytes, myTypes[0]);
- }
-
- /**
- * Creates new BinaryDocument from a byte array. The data in the array is
- * not copied. If you intend to modify the array after creating a document
- * then you should pass a copy of the data instead.
- *
- * @param someBytes Contains a byte array which will serve as our data.
- * @param type The MIME media type for this document.
- */
- public BinaryDocument(byte[] someBytes, MimeMediaType type) {
- ourBytes = someBytes;
- ourType = type;
- }
-
- /**
- * {@inheritDoc}
- */
- public MimeMediaType getMimeType() {
- return ourType;
- }
-
- /**
- * {@inheritDoc}
- */
- public String getFileExtension() {
- return StructuredDocumentFactory.getFileExtensionForMimeType(ourType);
- }
-
- /**
- * {@inheritDoc}
- */
- public InputStream getStream() throws IOException {
- return (new ByteArrayInputStream(ourBytes));
- }
-
- /**
- * {@inheritDoc}
- */
- public void sendToStream(OutputStream stream) throws IOException {
- stream.write(ourBytes);
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/Document.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/Document.java
deleted file mode 100644
index 016d8f1b..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/Document.java
+++ /dev/null
@@ -1,96 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.io.InputStream;
-import java.io.OutputStream;
-
-import java.io.IOException;
-
-
-/**
- * A simple typed container for data. A {@code Document} is presented as a
- * byte stream with an associated type. The data type is specified using a
- * MIME Media Type (as defined by
- * {@link IETF RFC 2046 MIME : Media Types}).
- *
- * @see net.jxta.document.MimeMediaType
- * @see net.jxta.document.StructuredDocument
- * @see net.jxta.document.StructuredDocumentFactory
- */
-public interface Document extends DocumentStreamIO {
-
- /**
- * Returns the MIME Media type of this {@code Document} per
- * {@link IETF RFC 2046 MIME : Media Types}.
- *
- * JXTA does not currently support the 'Multipart' or
- * 'Message' media types.
- *
- * @return The MIME Media Type for this {@code Document}.
- */
- MimeMediaType getMimeType();
-
- /**
- * Returns the file extension type used by this {@code Document}. This
- * value is usually chosen based upon the MIME Media Type.
- *
- * @return An appropriate file extension for this {@code Document}.
- */
- String getFileExtension();
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/DocumentByteArrayIO.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/DocumentByteArrayIO.java
deleted file mode 100644
index dba00eee..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/DocumentByteArrayIO.java
+++ /dev/null
@@ -1,75 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.nio.ByteBuffer;
-
-
-/**
- * Provides {@code byte} array based interfaces for manipulating
- * {@code Document} contents.
- *
- * @see net.jxta.document.Document
- */
-public interface DocumentByteArrayIO {
-
- /**
- * Returns the {@code Document} as a sequence of bytes.
- */
- byte[] getBytes();
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/DocumentByteBufferIO.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/DocumentByteBufferIO.java
deleted file mode 100644
index 2131e16d..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/DocumentByteBufferIO.java
+++ /dev/null
@@ -1,76 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.nio.ByteBuffer;
-
-
-/**
- * Provides {@code ByteBuffer} based interfaces for manipulating
- * {@code Document} contents.
- *
- * @see java.nio.ByteBuffer
- * @see net.jxta.document.Document
- */
-public interface DocumentByteBufferIO {
-
- /**
- * Returns the {@code Document} as a sequence of ByteBuffers
- */
- ByteBuffer[] getByteBuffers();
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/DocumentStreamIO.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/DocumentStreamIO.java
deleted file mode 100644
index c3e9734f..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/DocumentStreamIO.java
+++ /dev/null
@@ -1,91 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.io.InputStream;
-import java.io.OutputStream;
-
-import java.io.IOException;
-
-
-/**
- * Provides stream based interfaces for manipulating {@code Document} contents.
- *
- * @see net.jxta.document.Document
- */
-public interface DocumentStreamIO {
-
- /**
- * Returns the stream of bytes which represents the content of this
- * {@code Document}.
- *
- * @return An {@link java.io.InputStream} containing the bytes
- * of this {@code Document}.
- * @throws IOException For errors while writing the {@code Document}.
- */
- InputStream getStream() throws IOException;
-
- /**
- * Send the contents of this {@code Document} to the specified stream.
- *
- * @param stream The OutputStream to which the {@code Document} will
- * be written.
- * @throws IOException For errors while writing the {@code Document}.
- */
- void sendToStream(OutputStream stream) throws IOException;
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/Element.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/Element.java
deleted file mode 100644
index b73bd8d7..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/Element.java
+++ /dev/null
@@ -1,142 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.document;
-
-
-import java.util.Enumeration;
-
-
-/**
- * An element represents a portion of a {@link StructuredDocument}. An element
- * is identifiable by a key and may also optionally have a
- * value. Each Element also maintains a collection of references
- * to other elements, its children . Elements can be
- * composed into arbitrary hierarchical structures forming complex data
- * structures.
- *
- * Element instances are always associated with a
- * {@link StructuredDocument}. A {@link StructuredDocument} is a specialized
- * form of Element with additional features that make it appropriate for
- * acting as the root of a hierarchy of elements.
- *
- * @see net.jxta.document.Document
- * @see net.jxta.document.StructuredDocument
- * @see net.jxta.document.StructuredDocumentFactory
- * @see net.jxta.document.StructuredTextDocument
- * @see net.jxta.document.TextElement
- */
-public interface Element> {
-
- /**
- * Get the key associated with this Element.
- *
- * @return The key of this Element.
- */
- Object getKey();
-
- /**
- * Get the value (if any) associated with this Element.
- *
- * @return The value of this element, if any, otherwise null.
- */
- Object getValue();
-
- /**
- * Get the root document element of the hierarchy this element belongs to.
- *
- * @return The root document element of this element's hierarchy.
- */
- StructuredDocument getRoot();
-
- /**
- * Get the parent element of this element. If this Element has not been
- * inserted into the Document then null is returned. If this
- * element is the root element of the Document then it returns itself. ie.,
- * this == this.getParent().
- *
- * @return The parent of this element. If the element has no parent
- * then null will be returned. If the element is the root Element of the
- * hierarchy then it will return itself.
- */
- E getParent();
-
- /**
- * Add a child element to this element. The child element must be from the
- * document as the element it is to be added to. Elements are created using
- * either {@link StructuredDocument#createElement(Object)} or
- * {@link StructuredDocument#createElement(Object, Object)}.
- *
- * @param element The element to be added as a child.
- */
- void appendChild(E element);
-
- /**
- * Returns an enumeration of the immediate children of this element.
- *
- * @return Enumeration containing all of the children of this element.
- */
- Enumeration getChildren();
-
- /**
- * Returns an enumeration of the immediate children of this element who
- * match the specified key.
- *
- * @param key The key which will be matched against.
- * @return Enumeration containing all of the matching children of this
- * element.
- */
- Enumeration getChildren(Object key);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/ExtendableAdvertisement.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/ExtendableAdvertisement.java
deleted file mode 100644
index 70e71ab7..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/ExtendableAdvertisement.java
+++ /dev/null
@@ -1,197 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-/**
- * Extendable advertisements provide features for allowing inheritance of
- * advertisement types. The core and standard JXTA advertisements all allow
- * extension by extending this class.
- *
- * @see net.jxta.document.Advertisement
- * @see net.jxta.document.AdvertisementFactory
- * @see net.jxta.document.Document
- * @see net.jxta.document.MimeMediaType
- */
-public abstract class ExtendableAdvertisement extends Advertisement {
-
- /**
- * If {@code true} then the advertisement will be pretty print formatted
- * when it is output as XML. Currently this must be specified at
- * construction time as it is normally a preference per advertisement type.
- */
- private transient boolean formatted;
-
- /**
- * Default constructor. The advertisement will *not* be pretty-printed when
- * it is output as XML.
- */
- protected ExtendableAdvertisement() {
- this(false);
- }
-
- /**
- * @param formatted If {@code true} then the advertisement will be pretty
- * print formatted when it is output as XML.
- */
- protected ExtendableAdvertisement(boolean formatted) {
- this.formatted = formatted;
- }
-
- /**
- * Returns the base type of this advertisement hierarchy. Typically, only
- * the most basic advertisement of a type will implement this method and
- * declare it as final.
- *
- * @return String the base type of advertisements in this hierarchy.
- */
- public abstract String getBaseAdvType();
-
- /**
- * Process an individual element from the document during parse. Normally,
- * implementations will allow the base advertisements a chance to handle
- * the element before attempting to handle the element themselves. ie.
- *
- *
- * protected boolean handleElement(Element elem) {
- *
- * if (super.handleElement()) {
- * // it's been handled.
- * return true;
- * }
- * ... handle elements here ...
- *
- * // we don't know how to handle the element
- * return false;
- * }
- *
- *
- * @param elem The element to be processed.
- * @return {@code true} if the element was recognized, otherwise false.
- */
- protected boolean handleElement(Element elem) {
- // we don't handle any elements.
- return false;
- }
-
- /**
- * Process an individual attribute from the document root node. Normally,
- * implementations will allow the base advertisements a chance to handle
- * the attribute before attempting to handle the element themselves. ie.
- *
- *
- * protected boolean handleAttribute( Attribute elem ) {
- *
- * if (super.handleAttribute()) {
- * // it's been handled.
- * return true;
- * }
- *
- * ... handle attributes here ...
- *
- * // we don't know how to handle the attribute
- * return false;
- * }
- *
- *
- * @param attrib The attribute to be processed.
- * @return {@code true} if the attribute was recognized, otherwise false.
- */
- protected boolean handleAttribute(Attribute attrib) {
-
- // "handle" the attributes that we choose to ignore.
- if ("xmlns:jxta".equals(attrib.getName())) {
- return true;
- } else if ("xml:space".equals(attrib.getName())) {
- return true;
- } else if ("type".equals(attrib.getName())) {
- return true;
- }
-
- return false;
- }
-
- /**
- * {@inheritDoc}
- *
- * We don't have any content to add, just build the document instance and
- * return it to implementations that actually do something with it.
- */
- @Override
- public Document getDocument(MimeMediaType encodeAs) {
- Document adv = StructuredDocumentFactory.newStructuredDocument(encodeAs, getBaseAdvType());
-
- if (!(adv instanceof Attributable)) {
- throw new IllegalArgumentException("Advertisements require document type with attribute support.");
- }
-
- if (adv instanceof XMLDocument) {
- XMLDocument xmlAdv = (XMLDocument) adv;
-
- xmlAdv.addAttribute("xmlns:jxta", "http://jxta.org");
- if (!formatted) {
- xmlAdv.addAttribute("xml:space", "preserve");
- }
- }
-
- if (!getBaseAdvType().equals(getAdvType())) {
- ((Attributable) adv).addAttribute("type", getAdvType());
- }
-
- return adv;
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/FileDocument.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/FileDocument.java
deleted file mode 100644
index bcee2c9f..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/FileDocument.java
+++ /dev/null
@@ -1,166 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.io.File;
-import java.io.FileInputStream;
-import java.io.InputStream;
-import java.io.OutputStream;
-
-import java.io.IOException;
-
-
-/**
- * This class presents a Document interface for a specific file on disk.
- */
-public class FileDocument implements Document {
-
- private final static int BUFFER_SIZE = 4096;
-
- /**
- * File which backs this document.
- */
- private final File file;
-
- /**
- * MIME media type of this document.
- **/
- private final MimeMediaType type;
-
- /**
- * Create a new File Document.
- **/
- public FileDocument(File file) {
- this(file, StructuredDocumentFactory.getMimeTypeForFileExtension(getFileExtension(file)));
- }
-
- /**
- * Create a new File Document.
- */
- public FileDocument(File file, MimeMediaType type) {
- if (file.isDirectory()) {
- throw(new IllegalArgumentException("File cannot be a directory"));
- }
-
- if (!file.exists()) {
- throw(new IllegalArgumentException("File must exist"));
- }
-
- this.file = file;
- this.type = type.intern();
- }
-
- /**
- * {@inheritDoc}
- *
- * Returns everything after the last '.' in the filename, or the
- * empty string if the file name does not contain a '.'.
- **/
- public String getFileExtension() {
- return getFileExtension(file);
- }
-
- /**
- * Returns everything after the last '.' in the filename, or the
- * empty string if the file name does not contain a '.'.
- **/
- private static String getFileExtension(File file) {
-
- String fileName = file.getName();
- int idx = fileName.lastIndexOf('.');
-
- if (idx < 0 || idx == fileName.length()) {
- return "";
- } else {
- return fileName.substring(idx + 1);
- }
- }
-
- /**
- * {@inheritDoc}
- **/
- public MimeMediaType getMimeType() {
- return type;
- }
-
- /**
- * {@inheritDoc}
- **/
- public InputStream getStream() throws IOException {
- return new FileInputStream(file);
- }
-
- /**
- * {@inheritDoc}
- **/
- public void sendToStream(OutputStream sink) throws IOException {
- InputStream source = getStream();
- int c;
- byte[] buf = new byte[BUFFER_SIZE];
-
- do {
- c = source.read(buf);
-
- if (-1 == c) {
- break;
- }
-
- sink.write(buf, 0, c);
- } while (true);
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/MimeMediaType.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/MimeMediaType.java
deleted file mode 100644
index c044aacb..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/MimeMediaType.java
+++ /dev/null
@@ -1,835 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.io.*;
-import java.lang.ref.Reference;
-import java.lang.ref.WeakReference;
-import java.util.*;
-
-
-/**
- * MIME Media Types are used to describe the format of data streams. MIME
- * Media Types are defined by
- * {@link IETF RFC 2046 MIME : Media Types}.
- * This class manages parsing of Mime Media Types from strings and piecemeal
- * construction of Mime Media Type descriptors.
- *
- * Note : This implementation does not include support for the character
- * encoding techniques described by :
- * {@link IETF RFC 2046 MIME : Media Types}.
- *
- * @see net.jxta.document.Document
- * @see net.jxta.document.StructuredDocument
- * @see net.jxta.document.StructuredDocumentFactory
- * @see net.jxta.document.StructuredTextDocument
- */
-public class MimeMediaType implements Serializable {
-
- /**
- * Magic value for this format of serialization version.
- */
- private final static long serialVersionUID = 7546247036878523161L;
-
- private final static String CTL = "\u0000\u0001\u0002\u0003\u0004\u0005\u0006\u0007"
- + "\u0008\u0009\n\u000b\u000c\r\u000e\u000f" + "\u0010\u0011\u0012\u0013\u0014\u0015\u0016\u0017"
- + "\u0018\u0019\u001a\u001b\u001c\u001d\u001e\u001f" + "\u007f";
-
- private final static String space = "\u0020";
- private final static String LWSP_char = space + "\u0009";
- private final static String param_sep = LWSP_char + ";";
- private final static String tspecials = "()<>@,;:\\\"/[]?=";
- private final static String terminator = CTL + space + tspecials;
-
- /**
- * A canonical map of Mime Media Types.
- */
- private static final Map> interned = new WeakHashMap>();
-
- /**
- * Common Mime Media Type for arbitrary unparsed binary data.
- */
- public static final MimeMediaType AOS = new MimeMediaType("application", "octet-stream").intern();
-
- /**
- * Common Mime Media Type for text encoded using the default character
- * encoding for this JVM. The default character encoding is specified by
- * the JDK System property "file.encoding".
- *
- * The default encoding varies with host platform and locale. This
- * media type must not be used for any documents which
- * will be exchanged with other peers (as they may be using different
- * default character encodings).
- */
- public static final MimeMediaType TEXT_DEFAULTENCODING = new MimeMediaType("text", "plain").intern();
-
- /**
- * Common Mime Media Type for plain text encoded as UTF-8 characters. This
- * type is used by JXTA for all strings.
- */
- public static final MimeMediaType TEXTUTF8 = new MimeMediaType("text", "plain", "charset=\"UTF-8\"").intern();
-
- /**
- * Common Mime Media Type for XML encoded using the default character
- * encoding for this JVM. The default character encoding is specified by
- * the JDK System property "file.encoding".
- *
- * The default encoding varies with host platform and locale. This
- * media type must not be used for any documents which
- * will be exchanged with other peers (as they may be using different
- * default character encodings).
- */
- public static final MimeMediaType XML_DEFAULTENCODING = new MimeMediaType("text", "xml").intern();
-
- /**
- * Common Mime Media Type for XML encoded using the default character
- * encoding for this JVM. The default character encoding is specified by
- * the JDK System property "file.encoding".
- *
- * The default encoding varies with host platform and locale. This
- * media type must not be used for any documents which
- * will be exchanged with other peers (as they may be using different
- * default character encodings).
- */
- public static final MimeMediaType APPLICATION_XML_DEFAULTENCODING = new MimeMediaType("application", "xml").intern();
-
- /**
- * Common Mime Media Type for XML encoded as UTF-8 characters. This type is
- * used by JXTA for all protocol messages and metadata.
- */
- public static final MimeMediaType XMLUTF8 = new MimeMediaType("text", "xml", "charset=\"UTF-8\"").intern();
-
- /**
- * The primary media type
- */
- private transient String type = null;
-
- /**
- * The specific media sub-type
- */
- private transient String subtype = null;
-
- /**
- * The parameters for this media type
- */
- private transient List parameters = new ArrayList();
-
- /**
- * The hashcode value for this mime media type.
- */
- private transient int cachedHashCode = 0;
-
- /**
- * manages a media type parameter.
- */
- private static class parameter implements Comparable {
-
- /**
- * Attribute name.
- */
- final String attribute;
-
- /**
- * Value for the attribute. Includes quoting characters if they are
- * needed for outputting this value.
- */
- final String value;
-
- parameter(String attr, String val) {
- attribute = attr;
- value = val;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public boolean equals(Object obj) {
- if (this == obj) {
- return true;
- }
-
- if (!(obj instanceof parameter)) {
- return false;
- }
-
- parameter asParameter = (parameter) obj;
-
- return attribute.equalsIgnoreCase(asParameter.attribute) && asParameter.value.equals(value);
-
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public int hashCode() {
- return attribute.toLowerCase().hashCode() * 6037 + value.hashCode();
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public String toString() {
- return attribute + "=" + outputForm(value);
- }
-
- /**
- * {@inheritDoc}
- */
- public int compareTo(parameter asParameter) {
- if (this == asParameter) {
- return 0;
- }
-
- int result = attribute.compareToIgnoreCase(asParameter.attribute);
-
- if (0 != result) {
- return result;
- }
-
- return value.compareTo(asParameter.value);
- }
-
- private static String outputForm(String val) {
- StringBuilder result = new StringBuilder();
-
- if (-1 == findNextSeperator(val)) {
- result.append(val);
- } else {
- // needs quoting
- result.append('\"');
- for (int eachChar = 0; eachChar < val.length(); eachChar++) {
- char aChar = val.charAt(eachChar);
-
- if (('\\' == aChar) || ('\"' == aChar) || ('\r' == aChar)) {
- // needs escaping.
- result.append('\\');
- }
- result.append(aChar);
- }
- result.append('\"');
- }
- return result.toString();
- }
- }
-
- /**
- * Creates a new MimeMediaType
- *
- * @param mimetype string representing a mime-type
- */
- public MimeMediaType(String mimetype) {
-
- String cleaned = mimetype.trim();
-
- if (0 == cleaned.length()) {
- throw new IllegalArgumentException("input cannot be empty");
- }
-
- // determine the type
- int typeSepAt = findNextSeperator(cleaned);
-
- if ((-1 == typeSepAt) || (0 == typeSepAt) || ('/' != cleaned.charAt(typeSepAt))) {
- throw new IllegalArgumentException("expected seperator or seperator in unexpected location");
- }
-
- setType(cleaned.substring(0, typeSepAt));
-
- // determine the sub-type
- int subtypeSepAt = findNextSeperator(cleaned, typeSepAt + 1);
-
- String itsParams = "";
-
- if (-1 == subtypeSepAt) {
- setSubtype(cleaned.substring(typeSepAt + 1));
- } else {
- setSubtype(cleaned.substring(typeSepAt + 1, subtypeSepAt));
- itsParams = cleaned.substring(subtypeSepAt);
- // include the seperator, its significant
- }
-
- parseParams(itsParams, false);
- }
-
- /**
- * Creates a new type/subtype MimeMediaType
- *
- * @param type string representing a mime type
- * @param subtype string representing a mime subtype
- */
- public MimeMediaType(String type, String subtype) {
- this(type, subtype, null);
- }
-
- /**
- * Creates a new type/subtype MimeMediaType
- *
- * @param type string representing a mime type
- * @param subtype string representing a mime subtype
- * @param parameters parameters to the mime-type constructor
- */
- public MimeMediaType(String type, String subtype, String parameters) {
- setType(type);
- setSubtype(subtype);
- if (null != parameters) {
- parseParams(parameters, false);
- }
- }
-
- /**
- * Creates a new type/subtype MimeMediaType with the specified parameters.
- * The parameters are copied from the source mime type and additional params
- * are added. If replace is true, then the provided params will overwrite
- * the params from the source mime type.
- *
- * @param type the source mime type
- * @param params parameters to the mime-type constructor
- * @param replace parameters if true then provided params should replace
- * existing params else they are accumulated.
- */
- public MimeMediaType(MimeMediaType type, String params, boolean replace) {
- setType(type.getType());
- setSubtype(type.getSubtype());
- parameters.addAll(type.parameters);
-
- parseParams(params, replace);
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public boolean equals(Object obj) {
- if (this == obj) {
- return true;
- }
-
- if (!(obj instanceof MimeMediaType)) {
- return false;
- }
-
- MimeMediaType asMMT = (MimeMediaType) obj;
-
- if (!type.equalsIgnoreCase(asMMT.type)) {
- return false;
- }
-
- if (!subtype.equalsIgnoreCase(asMMT.subtype)) {
- return false;
- }
-
- List myParams = new ArrayList(parameters);
- List itsParams = new ArrayList(asMMT.parameters);
-
- Collections.sort(myParams);
- Collections.sort(itsParams);
-
- return myParams.equals(itsParams);
- }
-
- /**
- * Similar to {@link #equals(Object)}, but ignores any parameters. Compares
- * only the type and sub-type.
- *
- * @param obj the object to compare
- * @return true if equal
- */
- public boolean equalsIngoringParams(Object obj) {
- if (this == obj) {
- return true;
- }
-
- if (!(obj instanceof MimeMediaType)) {
- return false;
- }
-
- MimeMediaType likeMe = (MimeMediaType) obj;
-
- boolean retValue = getType().equalsIgnoreCase(likeMe.getType()) && getSubtype().equalsIgnoreCase(likeMe.getSubtype());
-
- return retValue;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public int hashCode() {
- if (0 == cachedHashCode) {
- List myParams = new ArrayList(parameters);
-
- Collections.sort(myParams);
-
- int calcedHash = type.hashCode() * 2467 + subtype.hashCode() * 3943 + myParams.hashCode();
-
- cachedHashCode = (0 != calcedHash) ? calcedHash : 1;
- }
-
- return cachedHashCode;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public String toString() {
- StringBuilder retValue = new StringBuilder(getMimeMediaType());
-
- for (parameter parameter : parameters) {
- retValue.append(';');
- parameter aParam = parameter;
-
- retValue.append(aParam.toString());
- }
- return retValue.toString();
- }
-
- /**
- * Returns the "base" MIME media type of this type. ie. with no parameters.
- *
- * @return The "base" MIME media type of this MimeMediaType.
- */
- public MimeMediaType getBaseMimeMediaType() {
- return new MimeMediaType(type, subtype).intern();
- }
-
- /**
- * Returns the "base" MIME media type of this type. ie. with no parameters.
- *
- * @return The "base" MIME media type of this type. ie. with no parameters.
- */
- public String getMimeMediaType() {
- StringBuilder retValue = new StringBuilder(type.length() + 1 + subtype.length());
-
- retValue.append(type);
- retValue.append('/');
- retValue.append(subtype);
-
- return retValue.toString();
- }
-
- /**
- * Get type of the mime-type
- *
- * @return type of the mime-type
- */
- public String getType() {
- return type;
- }
-
- /**
- * Check if the mime-type is for provisional. See Section 2.1 of
- * {@link IETF RFC 2048 MIME : Registration Procedures}
- *
- * @return boolean true if it is a provisional type
- */
- public boolean isExperimentalType() {
- if ((null == type) || (type.length() < 2)) {
- return false;
- }
-
- if (type.startsWith("x-") || type.startsWith("x.")) {
- return true;
- }
-
- return null != subtype && subtype.length() >= 2 && (subtype.startsWith("x-") || subtype.startsWith("x."));
-
- }
-
- /**
- * Set the type of MimeMediaType
- *
- * @param type type value
- */
- private void setType(String type) {
- if (null == type) {
- throw new IllegalArgumentException("type cannot be null");
- }
-
- String cleaned = type.trim().toLowerCase(Locale.US);
-
- if (0 == cleaned.length()) {
- throw new IllegalArgumentException("type cannot be null");
- }
-
- if (-1 != findNextSeperator(cleaned)) {
- throw new IllegalArgumentException("type cannot contain a seperator");
- }
-
- this.type = cleaned;
- }
-
- /**
- * Get the Subtype of the mime-type
- *
- * @return subtype of the mime-type
- */
- public String getSubtype() {
- return subtype;
- }
-
- /**
- * Check if the mime-type is for debugging. This method will be
- * removed
- *
- * @return boolean true if it is a debugging type
- */
- public boolean isExperimentalSubtype() {
- if ((null == subtype) || (subtype.length() < 2)) {
- return false;
- }
-
- return (('x' == subtype.charAt(0)) && ('-' == subtype.charAt(1)));
- }
-
- /**
- * Set the subtype of MimeMediaType
- *
- * @param subtype subtype value
- */
- private void setSubtype(String subtype) {
- if (null == subtype) {
- throw new IllegalArgumentException("subtype cannot be null");
- }
-
- String cleaned = subtype.trim().toLowerCase(Locale.US);
-
- if (0 == cleaned.length()) {
- throw new IllegalArgumentException("subtype cannot be null");
- }
-
- if (-1 != findNextSeperator(cleaned)) {
- throw new IllegalArgumentException("subtype cannot contain a seperator");
- }
-
- this.subtype = cleaned;
- }
-
- /**
- * Get the value of the first occurance of the specified parameter from the
- * parameter list.
- *
- * @param param the parameter to retrieve.
- * @return the value of the specifid parameter or null if the parameter was
- * not found.
- */
- public String getParameter(String param) {
- for (parameter parameter : parameters) {
- parameter aParam = parameter;
-
- if (aParam.attribute.equalsIgnoreCase(param)) {
- return aParam.value;
- }
- }
- return null;
- }
-
- /**
- * Parses the parametes portion of a MIME Media Type specification.
- *
- * @param itsParams parse a string for mime parameters.
- * @param replace parameters if true then provided params should replace
- * existing params else they are accumulated.
- */
- private void parseParams(String itsParams, boolean replace) {
- int currentCharIdx = 0;
- String currentAttribute = null;
- boolean inSeperator = true;
- boolean inComment = false;
- boolean inAttribute = false;
- StringBuffer currentValue = null;
- boolean inValue = false;
- boolean inQuoted = false;
- boolean nextEscaped = false;
-
- while (currentCharIdx < itsParams.length()) {
- char currentChar = itsParams.charAt(currentCharIdx);
-
- if (inSeperator) {
- if ('(' == currentChar) {
- inSeperator = false;
- inComment = true;
- } else if (-1 == param_sep.indexOf(currentChar)) {
- inSeperator = false;
- inAttribute = true;
- currentCharIdx--; // unget
- }
- } else if (inComment) {
- if (nextEscaped) {
- nextEscaped = false;
- } else {
- if ('\\' == currentChar) {
- nextEscaped = true;
- } else if (')' == currentChar) {
- inComment = false;
- inSeperator = true;
- } else if ('\r' == currentChar) {
- throw new IllegalArgumentException("malformed mime parameter at idx = " + currentCharIdx);
- }
- }
- } else if (inAttribute) {
- int endAttr = findNextSeperator(itsParams, currentCharIdx);
-
- if ((-1 == endAttr) || ('=' != itsParams.charAt(endAttr)) || (0 == (endAttr - currentCharIdx))) {
- throw new IllegalArgumentException("malformed mime parameter at idx = " + currentCharIdx);
- }
-
- currentAttribute = itsParams.substring(currentCharIdx, endAttr).toLowerCase(Locale.US);
-
- currentCharIdx = endAttr; // skip the equals.
- inAttribute = false;
- inValue = true;
- inQuoted = false;
- nextEscaped = false;
- currentValue = new StringBuffer();
- } else if (inValue) {
- if (inQuoted) {
- if (nextEscaped) {
- currentValue.append(currentChar);
- nextEscaped = false;
- } else {
- if ('\\' == currentChar) {
- nextEscaped = true;
- } else if ('"' == currentChar) {
- inQuoted = false;
- } else if ('\r' == currentChar) {
- throw new IllegalArgumentException("malformed mime parameter at idx = " + currentCharIdx);
- } else {
- currentValue.append(currentChar);
- }
- }
- } else if (-1 == terminator.indexOf(currentChar)) {
- currentValue.append(currentChar);
- } else {
- if ('"' == currentChar) {
- inQuoted = true;
- } else {
- parameter newparam = new parameter(currentAttribute, currentValue.toString());
-
- if (replace) {
- while (parameters.remove(newparam)) {}
- }
-
- parameters.add(newparam);
-
- inValue = false;
- inSeperator = true;
- currentCharIdx--; // unget
- }
- }
- } else {
- throw new IllegalArgumentException("malformed mime parameter at idx = " + currentCharIdx);
- }
-
- currentCharIdx++;
- }
-
- // finish off the last value.
- if (inValue) {
- if (nextEscaped || inQuoted) {
- throw new IllegalArgumentException("malformed mime parameter at idx = " + currentCharIdx);
- }
-
- parameter newparam = new parameter(currentAttribute, currentValue.toString());
-
- if (replace) {
- while (parameters.remove(newparam)) {}
- }
-
- parameters.add(newparam);
-
- inValue = false;
- inSeperator = true;
- }
-
- if (!inSeperator) {
- throw new IllegalArgumentException("malformed mime parameter at idx = " + currentCharIdx);
- }
- }
-
- /**
- * Find next separator position in mime-type
- *
- * @param source source location
- * @return int separator location
- */
- private static int findNextSeperator(String source) {
- return findNextSeperator(source, 0);
- }
-
- /**
- * Find next separator position in mime-type
- *
- * @param source source location
- * @param from from location
- * @return int separator location
- */
- private static int findNextSeperator(String source, int from) {
-
- int seperator = -1;
-
- // find a seperator
- for (int eachChar = from; eachChar < source.length(); eachChar++) {
- if (-1 != terminator.indexOf(source.charAt(eachChar))) {
- seperator = eachChar;
- break;
- }
- }
-
- return seperator;
- }
-
- /**
- * Returns a MimeMediaType with a value represented by the specified String.
- *
- * This method may produce better results than using the constructor
- * the same parameter set in that:
- *
- *
- * new MimeMediaType( string ) != new MimeMediaType( string )
- *
- *
- * while for common types:
- *
- *
- * MimeMediaType.valueOf( string ) == MimeMediaType.valueOf( string )
- *
- */
- public static MimeMediaType valueOf(String mimetype) {
- return new MimeMediaType(mimetype).intern();
- }
-
- /**
- * Read this Object in for Java Serialization
- *
- * @param s The stream from which the Object will be read.
- * @throws IOException for errors reading from the input stream.
- * @throws ClassNotFoundException if the serialized representation contains
- * references to classes which cannot be found.
- */
- private void readObject(ObjectInputStream s) throws IOException, ClassNotFoundException {
- s.defaultReadObject();
-
- MimeMediaType readType = MimeMediaType.valueOf(s.readUTF());
-
- type = readType.type;
- subtype = readType.subtype;
- parameters = readType.parameters;
- }
-
- /**
- * Return the interned form of the ID.
- */
- private Object readResolve() throws ObjectStreamException {
- return intern();
- }
-
- /**
- * Write this Object out for Java Serialization
- *
- * @param s The stream to which the Object will be written.
- * @throws IOException for errors writing to the output stream.
- */
- private void writeObject(ObjectOutputStream s) throws IOException {
- s.defaultWriteObject();
-
- s.writeUTF(toString());
- }
-
- /**
- * Returns a canonical representation for the MimeMediaType object.
- *
- * A pool of MimeMediaType, is maintained privately by the class.
- *
- * When the intern method is invoked, if the pool already contains a
- * MimeMediaType equal to this MimeMediaType object as determined by the
- * equals(Object) method, then the MimeMediaType from the pool is returned.
- * Otherwise, this MimeMediaType object is added to the pool and a reference
- * to this MimeMediaType object is returned.
- *
- * It follows that for any two MimeMediaType s and t,
- * s.intern() == t.intern() is true if and only if s.equals(t)
- * is true.
- *
- * @return a MimeMediaType that has the same value as this type, but is
- * guaranteed to be from a pool of unique types.
- */
- public MimeMediaType intern() {
- synchronized (MimeMediaType.class) {
- Reference common = interned.get(this);
-
- MimeMediaType result;
-
- if (null == common) {
- common = new WeakReference(this);
- interned.put(this, common);
- result = this;
- } else {
- result = common.get();
- if (null == result) {
- interned.put(this, new WeakReference(this));
- result = this;
- }
- }
-
- return result;
- }
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/StructuredDocument.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/StructuredDocument.java
deleted file mode 100644
index 73e19ddd..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/StructuredDocument.java
+++ /dev/null
@@ -1,93 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-/**
- * An extension of {@link Document} which allows the content of a document to be
- * specified by a hierarchy of elements. This allows the content of many
- * document types to be manipulated in an abstract way without regard to the
- * physical representation of the documents.
- *
- * StructuredDocuments are one of the elementary components that is
- * manipulated by the JXTA core. StructuredDocuments are used to represent most
- * core objects such as peer, peergroup or pipe advertisements.
- *
- * @see net.jxta.document.Document
- * @see net.jxta.document.StructuredTextDocument
- * @see net.jxta.document.StructuredDocumentFactory
- **/
-public interface StructuredDocument> extends Document, Element {
-
- /**
- * Create a new element without value.
- *
- * @param key The key of the element to be created.
- * @return The new element.
- **/
- E createElement(Object key);
-
- /**
- * Create a new element with value.
- *
- * @param key The name of the element to be created.
- * @param value The value of the element to be created or
- * null if no value is desired.
- * @return The new element.
- **/
- E createElement(Object key, Object value);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/StructuredDocumentFactory.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/StructuredDocumentFactory.java
deleted file mode 100644
index 74154edd..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/StructuredDocumentFactory.java
+++ /dev/null
@@ -1,582 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.io.InputStream;
-import java.io.Reader;
-import java.util.HashMap;
-import java.util.Hashtable;
-import java.util.Map;
-
-import java.io.IOException;
-import java.util.MissingResourceException;
-
-import java.util.logging.Logger;
-import java.util.logging.Level;
-import net.jxta.logging.Logging;
-
-import net.jxta.util.ClassFactory;
-import net.jxta.endpoint.MessageElement;
-import net.jxta.endpoint.TextMessageElement;
-
-
-/**
- * A factory for constructing instances of {@link StructuredDocument}.
- * Behind the scenes, it also provides for the registration of the mime-types
- * and constructors needed to accomplish the construction. All supported
- * mime-types will need to register their implementation in this factory.
- *
- * @see net.jxta.document.Document
- * @see net.jxta.document.StructuredTextDocument
- * @see net.jxta.document.StructuredDocument
- * @see net.jxta.document.MimeMediaType
- */
-public final class StructuredDocumentFactory extends ClassFactory {
-
- /**
- * Log4J Logger
- */
- private static final Logger LOG = Logger.getLogger(StructuredDocumentFactory.class.getName());
-
- /**
- * Interface for instantiators of StructuredDocuments
- */
- public interface Instantiator {
-
- /**
- * For mapping between extensions and MIME types.
- */
- class ExtensionMapping extends Object {
-
- /**
- * The extension
- */
- private final String extension;
-
- /**
- * MIME type it maps to
- */
- private final MimeMediaType mimetype;
-
- /**
- * default constructor
- */
- public ExtensionMapping(String extension, MimeMediaType mimetype) {
- this.extension = extension;
- this.mimetype = (null != mimetype) ? mimetype.intern() : null;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public boolean equals(Object target) {
- if (this == target) {
- return true;
- }
-
- if (target instanceof ExtensionMapping) {
- ExtensionMapping likeMe = (ExtensionMapping) target;
-
- if (!extension.equals(likeMe.extension)) {
- return false;
- }
-
- if ((null == mimetype) && (null == likeMe.mimetype)) {
- return true;
- }
-
- if ((null == mimetype) || (null == likeMe.mimetype)) {
- return false;
- }
-
- return mimetype.equals(likeMe.mimetype);
- } else {
- return false;
- }
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public int hashCode() {
- int hash = extension.hashCode();
-
- if (null != mimetype) {
- hash ^= mimetype.hashCode();
- }
-
- return hash;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public String toString() {
- return extension + " -> " + ((null != mimetype) ? mimetype.toString() : "");
- }
-
- /**
- * Returns the extension which is part of this mapping.
- *
- * @return the extension which is part of this mapping.
- */
- public String getExtension() {
- return extension;
- }
-
- /**
- * Returns the MIME Media Type which is part of this mapping.
- *
- * @return the MIME Media Type which is part of this mapping.
- */
- public MimeMediaType getMimeMediaType() {
- return mimetype;
- }
- }
-
- /**
- * Returns the MIME Media types supported by this this Document per
- * {@link IETF RFC 2046 MIME : Media Types}.
- *
- * JXTA does not currently support the 'Multipart' or 'Message'
- * media types.
- *
- * @return An array of MimeMediaType objects containing the MIME Media Type
- * for this Document.
- */
- MimeMediaType[] getSupportedMimeTypes();
-
- /**
- * Returns the mapping of file extension and mime-types for this type
- * of document. The default extension is mapped to the 'null' mime-type
- * and should only be used if no other mapping matches.
- *
- * @return An array of objects containing file extensions
- */
- ExtensionMapping[] getSupportedFileExtensions();
-
- /**
- * Create a new structured document of the type specified by doctype.
- *
- * @param mimeType The MIME type to be associated with this instance.
- * the base type must be one of the types returned by
- * getSupportedMimeTypes. Some implementations may accept
- * parameters in the params section of the MIME type.
- * @param doctype Type for the base node of the document.
- * @return StructuredDocument instance.
- */
- StructuredDocument newInstance(MimeMediaType mimeType, String doctype);
-
- /**
- * Create a new structured document of the type specified by doctype.
- *
- * @param mimeType The MIME type to be associated with this instance.
- * The base type must be one of the types returned by
- * getSupportedMimeTypes. Some implementations may accept
- * parameters in the params section of the MIME type.
- * @param doctype Type for the base node of the document.
- * @param value Value for the base node of the document.
- * @return {@link StructuredDocument} instance.
- */
- StructuredDocument newInstance(MimeMediaType mimeType, String doctype, String value);
-
- /**
- * Create a structured document from a stream containing an appropriately serialized
- * instance of the same document.
- *
- * @param mimeType The MIME type to be associated with this instance.
- * The base type must be one of the types returned by
- * getSupportedMimeTypes. Some implementations may accept
- * parameters in the params section of the MIME type.
- * @param source The {@code Inputstream} from which to read the
- * document.
- * @return {@link StructuredDocument} instance.
- * @throws IOException Thrown for problems reading from the source.
- */
- StructuredDocument newInstance(MimeMediaType mimeType, InputStream source) throws IOException;
- }
-
-
- /**
- * Interface for instantiators of StructuredTextDocuments
- */
- public interface TextInstantiator extends Instantiator {
-
- /**
- * Create a structured document from a Reader containing an appropriately serialized
- * instance of the same document.
- *
- * @param mimeType The MIME type to be associated with this instance.
- * The base type must be one of the types returned by
- * getSupportedMimeTypes. Some implementations may accept
- * parameters in the params section of the MIME type.
- * @param source {@code Reader} from which to read the instance.
- * @return {@link StructuredDocument} instance.
- * @throws IOException Thrown for problems reading from the source.
- */
- StructuredDocument newInstance(MimeMediaType mimeType, Reader source) throws IOException;
- }
-
- /**
- * This class is a singleton. This is the instance that backs the
- * static methods.
- */
- private static final StructuredDocumentFactory factory = new StructuredDocumentFactory();
-
- /**
- * This is the map of mime-types and instantiators used by
- * newStructuredDocument.
- */
- private final Map encodings = new HashMap();
-
- /**
- * This is the map of extensions to mime-types used by
- * {@link #getMimeTypeForFileExtension(String) }
- */
- private final Map extToMime = new HashMap();
-
- /**
- * This is the map of mime-types to extensions used by
- * {@link #getFileExtensionForMimeType(MimeMediaType mimetype) }
- */
- private final Map mimeToExt = new HashMap();
-
- /**
- * If true then the pre-defined set of StructuredDocument sub-classes has
- * been registered from the property containing them.
- */
- private boolean loadedProperty = false;
-
- /**
- * Private constructor. This class is not meant to be instantiated except
- * by itself.
- *
- */
- private StructuredDocumentFactory() {}
-
- /**
- * Registers the pre-defined set of StructuredDocument sub-classes so that
- * this factory can construct them.
- *
- * @return true if at least one of the StructuredDocument sub-classes could
- * be registered otherwise false.
- */
- private synchronized boolean loadProviders() {
- if (factory.loadedProperty) {
- return true;
- }
-
- factory.loadedProperty = registerProviders(StructuredDocument.class.getName());
-
- return factory.loadedProperty;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected Map getAssocTable() {
- return encodings;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected Class getClassForKey() {
- return MimeMediaType.class;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected Class getClassOfInstantiators() {
- // our key is the doctype names.
- return Instantiator.class;
- }
-
- /**
- * {@inheritDoc}
- *
- * We override the standard implementation to get the MIME type from
- * the class and use that as the key to register the class with the factory.
- *
- * @param className The class name which will be registered.
- * @return boolean true if the class was registered otherwise false.
- */
- @Override
- protected boolean registerAssoc(String className) {
- boolean registeredSomething = false;
-
- LOG.finer("Registering : " + className);
-
- try {
- Class docClass = Class.forName(className);
-
- Instantiator instantiator = (Instantiator) docClass.getField("INSTANTIATOR").get(null);
-
- MimeMediaType[] mimeTypes = instantiator.getSupportedMimeTypes();
-
- for (int eachType = 0; eachType < mimeTypes.length; eachType++) {
- LOG.finer(" Registering Type : " + mimeTypes[eachType].getMimeMediaType());
- registeredSomething |= registerInstantiator(mimeTypes[eachType], instantiator);
- }
- } catch (Exception all) {
- if (Logging.SHOW_WARNING && LOG.isLoggable(Level.WARNING)) {
- LOG.log(Level.WARNING, "Failed to register \'" + className + "\'", all);
- }
- }
-
- return registeredSomething;
- }
-
- /**
- * Returns the preferred extension for a given mime-type. If there is no
- * mapping or no preferred extension for this MIME type then null is
- * returned.
- *
- * @param mimetype the MimeMediaType we wish to know the file extension for.
- * @return String containing the extension or null for mime-types with no
- * known association.
- */
- public static String getFileExtensionForMimeType(MimeMediaType mimetype) {
- factory.loadProviders();
-
- return factory.mimeToExt.get(mimetype.getBaseMimeMediaType());
- }
-
- /**
- * Returns the preferred mime-type for a given file extension. If there is
- * no mapping then null is returned.
- *
- * @param extension The extension we wish to know the mime-type for.
- * @return MimeMediaType associated with this file extension.
- */
- public static MimeMediaType getMimeTypeForFileExtension(String extension) {
- factory.loadProviders();
-
- MimeMediaType result = factory.extToMime.get(extension);
-
- return result;
- }
-
- /**
- * Register an instantiator object a mime-type of documents to be
- * constructed.
- *
- * @param mimetype the mime-type associated.
- * @param instantiator the instantiator that wants to be registered..
- * @return boolean true if the instantiator for this mime-type is now
- * registered. If there was already an instantiator this mime-type then
- * false will be returned.
- * @throws SecurityException there were permission problems registering
- * the instantiator.
- */
- public static boolean registerInstantiator(MimeMediaType mimetype, Instantiator instantiator) {
- boolean registered = factory.registerAssoc(mimetype.getBaseMimeMediaType(), instantiator);
-
- if (registered) {
- Instantiator.ExtensionMapping[] extensions = instantiator.getSupportedFileExtensions();
-
- for (int eachExt = 0; eachExt < extensions.length; eachExt++) {
- if (null != extensions[eachExt].getMimeMediaType()) {
- factory.extToMime.put(extensions[eachExt].getExtension(), extensions[eachExt].getMimeMediaType().intern());
-
- factory.mimeToExt.put(extensions[eachExt].getMimeMediaType(), extensions[eachExt].getExtension());
-
- // And the base version.
- factory.mimeToExt.put(extensions[eachExt].getMimeMediaType().getBaseMimeMediaType(), extensions[eachExt].getExtension());
- }
- }
- }
-
- return registered;
- }
-
- /**
- * Constructs an instance of {@link StructuredDocument} matching
- * the mime-type specified by the mimetype parameter. The
- * doctype parameter identifies the base type of the
- * {@link StructuredDocument}.
- *
- * @param mimetype Specifies the mime media type to be associated with
- * the {@link StructuredDocument} to be created.
- * @param doctype Specifies the root type of the {@link StructuredDocument}
- * to be created.
- * @return StructuredDocument The instance of {@link StructuredDocument}
- * or null if it could not be created.
- * @throws NoSuchElementException invalid mime-media-type
- */
- public static StructuredDocument newStructuredDocument(MimeMediaType mimetype, String doctype) {
- factory.loadProviders();
-
- Instantiator instantiator = factory.getInstantiator(mimetype.getBaseMimeMediaType());
-
- return instantiator.newInstance(mimetype, doctype);
- }
-
- /**
- * Constructs an instance of {@link StructuredDocument} matching
- * the mime-type specified by the mimetype parameter. The
- * doctype parameter identifies the base type of the
- * {@link StructuredDocument}. Value supplies a value for the root
- * element.
- *
- * @param mimetype Specifies the mime media type to be associated with
- * the {@link StructuredDocument} to be created.
- * @param doctype Specifies the root type of the {@link StructuredDocument}
- * to be created.
- * @param value Specifies a value for the root element.
- * @return StructuredDocument The instance of {@link StructuredDocument}
- * or null if it could not be created.
- * @throws NoSuchElementException if the mime-type has not been registered.
- */
- public static StructuredDocument newStructuredDocument(MimeMediaType mimetype, String doctype, String value) {
- factory.loadProviders();
-
- Instantiator instantiator = factory.getInstantiator(mimetype.getBaseMimeMediaType());
-
- return instantiator.newInstance(mimetype, doctype, value);
- }
-
- /**
- * Constructs an instance of {@link StructuredDocument} matching
- * the mime-type specified by the mimetype parameter. The
- * doctype parameter identifies the base type of the
- * {@link StructuredDocument}.
- *
- * @param mimetype Specifies the mime media type to be associated with the
- * {@link StructuredDocument} to be created.
- * @param stream Contains an InputStream from which the document will be
- * constructed.
- * @return StructuredDocument The instance of {@link StructuredDocument}
- * or null if it could not be created.
- * @throws IOException If there is a problem reading from the stream.
- * @throws NoSuchElementException if the mime-type has not been registered.
- */
- public static StructuredDocument newStructuredDocument(MimeMediaType mimetype, InputStream stream) throws IOException {
- factory.loadProviders();
-
- Instantiator instantiator = factory.getInstantiator(mimetype.getBaseMimeMediaType());
-
- return instantiator.newInstance(mimetype, stream);
- }
-
- /**
- * Constructs an instance of {@link StructuredDocument} matching
- * the mime-type specified by the mimetype parameter. The
- * doctype parameter identifies the base type of the
- * {@link StructuredDocument}.
- *
- * @param mimetype Specifies the mime media type to be associated with the
- * {@link StructuredDocument} to be created.
- * @param reader A Reader from which the document will be constructed.
- * @return StructuredDocument The instance of {@link StructuredDocument}
- * or {@code null} if it could not be created.
- * @throws IOException If there is a problem reading from the stream.
- * @throws NoSuchElementException if the mime-type has not been registered.
- * @throws UnsupportedOperationException if the mime-type provided is not
- * a text oriented MIME type.
- */
- public static StructuredDocument newStructuredDocument(MimeMediaType mimetype, Reader reader) throws IOException {
- factory.loadProviders();
-
- Instantiator instantiator = factory.getInstantiator(mimetype.getBaseMimeMediaType());
-
- if (!(instantiator instanceof TextInstantiator)) {
- // XXX 20020502 bondolo@jxta.org we could probably do something
- // really inefficient that would allow it to work, but better not to.
- // if ReaderInputStream existed, it would be easy to do.
- if (Logging.SHOW_WARNING && LOG.isLoggable(Level.WARNING)) {
- LOG.warning( "Document Class \'" + instantiator.getClass().getName() + "\' associated with \'" + mimetype
- + "\' is not a text oriented document");
- }
-
- throw new UnsupportedOperationException( "Document Class '" + instantiator.getClass().getName()
- + "' associated with '" + mimetype + "' is not a text oriented document");
- }
-
- return ((TextInstantiator) instantiator).newInstance(mimetype, reader);
- }
-
- /**
- * Constructs an instance of {@link StructuredDocument} based upon the
- * content of the provided message element.
- *
- * @param element The message element from which to create the document.
- * @return StructuredDocument The instance of {@link StructuredDocument}
- * or null if it could not be created.
- * @throws IOException If there is a problem reading from the stream.
- * @throws NoSuchElementException if the mime-type has not been registered.
- */
- public static StructuredDocument newStructuredDocument(MessageElement element) throws IOException {
- factory.loadProviders();
-
- Instantiator instantiator = factory.getInstantiator(element.getMimeType().getBaseMimeMediaType());
-
- if ((instantiator instanceof TextInstantiator) && (element instanceof TextMessageElement)) {
- return ((TextInstantiator) instantiator).newInstance(element.getMimeType(), ((TextMessageElement) element).getReader());
- } else {
- return instantiator.newInstance(element.getMimeType(), element.getStream());
- }
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/StructuredDocumentUtils.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/StructuredDocumentUtils.java
deleted file mode 100644
index 0a3b07da..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/StructuredDocumentUtils.java
+++ /dev/null
@@ -1,228 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.util.Enumeration;
-
-
-/**
- * Provides a number of static utility members which are helpful in
- * manipluating StructuredDocuments.
- *
- **/
-public final class StructuredDocumentUtils {
-
- /**
- * A singleton class, not meant to be constructed
- **/
- private StructuredDocumentUtils() {
- ;
- }
-
- /**
- * Recursively copy children elements of from into the
- * the element intoElement of document intoDoc.
- *
- * BEWARE that this does NOT copy the TEXTVALUE (if any) of the
- * fromParent element, ONLY CHILDREN. All other elements
- * are fully copied, including their textValue.
- *
- * It is not possible to copy a textValue in an existing element.
- *
- * @param intoDoc the document into which the elements will be
- * copied.
- * @param intoElement the element which will serve as the parent for
- * the elements being copied.
- * @param from the parent element of the elements which will be copied.
- **/
- public static void copyChildren(StructuredDocument intoDoc, Element intoElement, Element from) {
-
- for (Enumeration eachChild = from.getChildren(); eachChild.hasMoreElements();) {
-
- Element aChild = (Element) eachChild.nextElement();
- Element newElement = intoDoc.createElement(aChild.getKey(), aChild.getValue());
-
- intoElement.appendChild(newElement);
-
- // copy attributes if any
- if ((aChild instanceof Attributable) && (newElement instanceof Attributable)) {
- Enumeration eachAttrib = ((Attributable) aChild).getAttributes();
-
- while (eachAttrib.hasMoreElements()) {
- Attribute anAttrib = (Attribute) eachAttrib.nextElement();
-
- ((Attributable) newElement).addAttribute(anAttrib.getName(), anAttrib.getValue());
- }
- }
-
- // recurse to add the children.
- copyChildren(intoDoc, newElement, aChild);
- }
- }
-
- /**
- * Recursively copy elements beginnging with from into the
- * document identified by intoDoc.
- *
- * @param intoDoc the document into which the elements which will be
- * copied.
- * @param intoElement the element which will serve as the parent for
- * the elements being copied.
- * @param from the root element of the hierarchy which will be copied.
- * @param newName the root element being copied is renamed
- * newName.
- * @return The added element.
- *
- **/
- public static Element copyElements(StructuredDocument intoDoc, Element intoElement, Element from, Object newName) {
-
- Element newElement = intoDoc.createElement(newName, from.getValue());
-
- intoElement.appendChild(newElement);
-
- boolean hasType = false;
-
- // copy attributes if any
- if (newElement instanceof Attributable) {
-
- if (from instanceof Attributable) {
- Enumeration eachAttrib = ((Attributable) from).getAttributes();
-
- while (eachAttrib.hasMoreElements()) {
- Attribute anAttrib = (Attribute) eachAttrib.nextElement();
- String attribName = anAttrib.getName();
-
- if (attribName.equals("type")) {
- hasType = true;
- }
- ((Attributable) newElement).addAttribute(attribName, anAttrib.getValue());
- }
- }
-
- // If "from" happens to be a document, and if it happens to be renamed, and if it does not have an explicit type
- // attribute, then preserve the document type, which we assume is the original name, converted to string, as a type
- // attribute. It is an XMLism. It may be wrong or at least ineffective for other kinds of structured documents. If
- // it one day becomes an issue, it will have to be resolved by having a method specific to each kind of structured
- // document and dedicated to correcting type loss.
-
- Object origName = from.getKey().toString();
-
- if ((!hasType) && (!newName.equals(origName)) && (from instanceof Document)) {
- ((Attributable) newElement).addAttribute("type", origName.toString());
- }
- }
-
- StructuredDocumentUtils.copyChildren(intoDoc, newElement, from);
-
- return newElement;
- }
-
- /**
- * Recursively copy elements beginnging with from into the
- * document identified by intoDoc.
- *
- * @param intoDoc the document into which the elements which will be
- * copied.
- * @param intoElement the element which will serve as the parent for
- * the elements being copied.
- * @param from the root element of the hierarchy which will be copied.
- * @return The added element.
- **/
- public static Element copyElements(StructuredDocument intoDoc, Element intoElement, Element from) {
-
- return copyElements(intoDoc, intoElement, from, from.getKey());
- }
-
- /**
- * Copies the specified element or document into a standalone document of
- * same type. The from for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-/**
- * Extends {@link StructuredDocument} to provide accessors appropriate for text
- * based documents.
- *
- * @see net.jxta.document.Document
- * @see net.jxta.document.StructuredDocument
- * @see net.jxta.document.TextDocument
- * @see net.jxta.document.Element
- * @see net.jxta.document.TextElement
- * @see net.jxta.document.StructuredDocumentFactory
- */
-public interface StructuredTextDocument> extends TextDocument, StructuredDocument, TextElement {
-
- /**
- * Create a new element without value.
- *
- * @param name The name of the element to be created.
- * @return The new element.
- */
- T createElement(String name);
-
- /**
- * Create a new element with value.
- *
- * @param name The name of the element to be created.
- * @param value The value of the element to be created.
- * @return The new element.
- */
- T createElement(String name, String value);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextDocument.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextDocument.java
deleted file mode 100644
index 701a5b18..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextDocument.java
+++ /dev/null
@@ -1,71 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.io.Writer;
-import java.io.Reader;
-
-import java.io.IOException;
-
-
-/**
- * Extends {@link net.jxta.document.Document} for text documents.
- *
- * @see net.jxta.document.Document
- */
-public interface TextDocument extends Document, TextDocumentReaderIO {}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextDocumentCharArrayIO.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextDocumentCharArrayIO.java
deleted file mode 100644
index 9ad6c2c6..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextDocumentCharArrayIO.java
+++ /dev/null
@@ -1,80 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.io.Writer;
-import java.io.Reader;
-
-import java.io.IOException;
-
-
-/**
- * Provides {@code char} array based interfaces for manipulating
- * {@code TextDocument}s.
- */
-public interface TextDocumentCharArrayIO {
-
- /**
- * Returns the sequence of characters which represents the content of the
- * {@code TextDocument}.
- *
- * @return A character array containing the characters of the
- * {@code TextDocument}.
- */
- char[] getChars();
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextDocumentCharBufferIO.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextDocumentCharBufferIO.java
deleted file mode 100644
index 304602cc..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextDocumentCharBufferIO.java
+++ /dev/null
@@ -1,80 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.io.Writer;
-import java.io.Reader;
-
-import java.io.IOException;
-
-
-/**
- * Provides {@code Reader}/{@code Writer} based interfaces for manipulating
- * {@code TextDocument}s.
- */
-public interface TextDocumentCharBufferIO {
-
- /**
- * Returns the sequence of characters which represents the content of the
- * {@code TextDocument}.
- *
- * @return A character array containing the characters of the
- * {@code TextDocument}.
- */
- CharSequence getCharSequence();
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextDocumentCharSequenceIO.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextDocumentCharSequenceIO.java
deleted file mode 100644
index fda5b275..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextDocumentCharSequenceIO.java
+++ /dev/null
@@ -1,77 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.nio.CharBuffer;
-
-
-/**
- * Provides {@code Reader}/{@code Writer} based interfaces for manipulating
- * {@code TextDocument}s.
- */
-public interface TextDocumentCharSequenceIO {
-
- /**
- * Returns the sequence of characters which represents the content of the
- * {@code TextDocument}.
- *
- * @return A sequence of {@code CharBuffer}s containing the characters of
- * the {@code TextDocument}.
- */
- CharBuffer getCharBuffers();
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextDocumentReaderIO.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextDocumentReaderIO.java
deleted file mode 100644
index a1742ab6..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextDocumentReaderIO.java
+++ /dev/null
@@ -1,91 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.io.Writer;
-import java.io.Reader;
-
-import java.io.IOException;
-
-
-/**
- * Provides {@code Reader}/{@code Writer} based interfaces for manipulating
- * {@code TextDocument}s.
- */
-public interface TextDocumentReaderIO {
-
- /**
- * Returns the sequence of characters which represents the content of the
- * {@code TextDocument}.
- *
- * @return An {@link java.io.Reader} containing the characters of the
- * {@code TextDocument}.
- * @throws IOException If an I/O error occurs.
- */
- Reader getReader() throws IOException;
-
- /**
- * Send the contents of this {@code TextDocument} to the specified
- * Writer.
- *
- * @param writer The {@link java.io.Writer} to which the characters of the
- * {@code TextDocument} will be written.
- * @throws IOException If an I/O error occurs.
- */
- void sendToWriter(Writer writer) throws IOException;
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextElement.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextElement.java
deleted file mode 100644
index c816cee9..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/TextElement.java
+++ /dev/null
@@ -1,111 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.util.Enumeration;
-
-
-/**
- * Extends {@link Element} to provide {@link java.lang.String} oriented
- * accessors for instances of {@link StructuredTextDocument}
- *
- * @see net.jxta.document.Document
- * @see net.jxta.document.Element
- * @see net.jxta.document.StructuredDocument
- * @see net.jxta.document.StructuredTextDocument
- */
-public interface TextElement> extends Element {
-
- /**
- * {@inheritDoc}
- */
- String getKey();
-
- /**
- * {@inheritDoc}
- */
- String getValue();
-
- /**
- * {@inheritDoc}
- */
- StructuredTextDocument getRoot();
-
- /**
- * Get the name associated with an element.
- *
- * @return A string containing the name of this element.
- */
- String getName();
-
- /**
- * Get the value (if any) associated with an element.
- *
- * @return A string containing the value of this element, if any, otherwise null.
- */
- String getTextValue();
-
- /**
- * Returns an enumeration of the immediate children of this element whose
- * name match the specified string.
- *
- * @param name The name which will be matched against.
- * @return An enumeration containing all of the children of this element.
- */
- Enumeration getChildren(String name);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/XMLDocument.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/XMLDocument.java
deleted file mode 100644
index 1424da1e..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/XMLDocument.java
+++ /dev/null
@@ -1,76 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-/**
- * Common interfaces for all {@link net.jxta.document.StructuredTextDocument}
- * which are implemented by XML Documents. Appropriate for advertisements and
- * messages.
- */
-public interface XMLDocument> extends XMLElement, StructuredTextDocument {
-
- /**
- * {@inheritDoc}
- */
- X createElement(String name);
-
- /**
- * {@inheritDoc}
- */
- X createElement(String name, String value);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/XMLElement.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/XMLElement.java
deleted file mode 100644
index 091ffc8e..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/XMLElement.java
+++ /dev/null
@@ -1,73 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.document;
-
-
-import java.util.Enumeration;
-
-
-/**
- * Common definition of XML Elements. Appropriate for advertisements and
- * messages.
- */
-public interface XMLElement> extends TextElement, Attributable {
-
- /**
- * {@inheritDoc}
- */
- XMLDocument getRoot();
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/package.html b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/package.html
deleted file mode 100644
index e579d09e..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/document/package.html
+++ /dev/null
@@ -1,13 +0,0 @@
-
-
-
-
-
-
- JXTA Documents are containers for both structured and unstructured data.
- Advertisements are used to describe JXTA resources such as peers, groups,
- services, and codats.
-
- @see JXTA Protocols Specification : Advertisementss
-
-
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/AbstractMessenger.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/AbstractMessenger.java
deleted file mode 100644
index d81cba5e..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/AbstractMessenger.java
+++ /dev/null
@@ -1,324 +0,0 @@
-/*
- * Copyright (c) 2004-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.endpoint;
-
-
-import net.jxta.util.AbstractSimpleSelectable;
-import net.jxta.util.SimpleSelectable;
-
-import java.io.IOException;
-import java.io.InterruptedIOException;
-
-
-/**
- * An AbstractMessenger is used to implement messengers (for example, by transport modules).
- * It supplies the convenience, bw compatible, obvious, or otherwise rarely changed methods.
- * Many method cannot be overloaded in order to ensure standard behaviour.
- * The rest is left to implementations.
- *
- * @see net.jxta.endpoint.EndpointService
- * @see net.jxta.endpoint.EndpointAddress
- * @see net.jxta.endpoint.Message
- */
-public abstract class AbstractMessenger extends AbstractSimpleSelectable implements Messenger {
-
- /**
- * The default Maximum Transmission Unit.
- */
- protected static final long DEFAULT_MTU = Long.parseLong(System.getProperty("net.jxta.MTU", "65536"));
-
- /**
- * The destination address of messages sent on this messenger.
- */
- protected final EndpointAddress dstAddress;
-
- /**
- * The stateLock that we share with the implementation.
- * This permits to implement waitState in a totally generic way: waitState depends only on the lock
- * (provided at construction), and on getState(), supplied by the implementation.
- */
- private Object stateLock;
-
- /**
- * Create a new abstract messenger.
- *
- * Warning: This class needs to know the object on which to waitState must synchronize. It is generally impossible
- * to pass it at construction because it is not yet constructed. Instead implementations MUST call {@link #setStateLock}
- * from their constructor.
- *
- * @param dest who messages should be addressed to
- */
- public AbstractMessenger(EndpointAddress dest) {
- dstAddress = dest;
- }
-
- /**
- * {@inheritDoc}
- *
- * A simple implementation for debugging. Do not depend upon the format.
- */
- @Override
- public String toString() {
- return super.toString() + " {" + dstAddress + "}";
- }
-
- /**
- * Specifies the object on which waitState must synchronize.
- *
- * @param stateLock The object on which waitState must synchronize. This has to be the object that gets notified when the
- * implementation changes its state. Changing state is defined as "any operation that causes the result of the
- * getState method to change". Implementations that use the MessengerState state machine should typically use the
- * MessengerState object as their state lock, but it is not assumed.
- */
- protected void setStateLock(Object stateLock) {
- this.stateLock = stateLock;
- }
-
- /*
- * Messenger methods implementations.
- */
-
- /**
- * {@inheritDoc}
- *
- * This is here for backward compatibility reasons. The notion of long term unemployment still exists, but is no-longer part
- * of the API. Self closing for unemployment is now a built-in feature of messengers.
- */
- @Deprecated
- public final boolean isIdle() {
- return false;
- }
-
- /**
- * {@inheritDoc}
- */
- @Deprecated
- public final boolean isSynchronous() {
- return false;
- }
-
- /**
- * {@inheritDoc}
- */
- public final EndpointAddress getDestinationAddress() {
- return dstAddress;
- }
-
- /**
- * {@inheritDoc}
- */
- @Deprecated
- public final EndpointAddress getDestinationAddressObject() {
- return dstAddress;
- }
-
- /**
- * {@inheritDoc}
- * It is not always enforced. At least this much can always be sent.
- */
- public long getMTU() {
- return DEFAULT_MTU;
- }
-
- /**
- * {@inheritDoc}
- *
- * This is a minimal implementation. It may not detect closure
- * initiated by the other side unless the messenger was actually used
- * since. A more accurate (but not mandatory implementation) would
- * actually go and check the underlying connection, if relevant...unless
- * breakage initiated by the other side is actually reported asynchronously
- * when it happens. Breakage detection from the other side need not
- * be reported atomically with its occurrence. This not very important
- * since we canonicalize transport messengers and so do not need to
- * aggressively collect closed ones. When not used, messengers die by themselves.
- */
- public boolean isClosed() {
- return (getState() & USABLE) == 0;
- }
-
- /**
- * {@inheritDoc}
- */
- public final void flush() throws IOException {
- int currentState = 0;
-
- try {
- currentState = waitState(IDLE, 0);
- } catch (InterruptedException ie) {
- InterruptedIOException iio = new InterruptedIOException("flush() interrupted");
-
- iio.initCause(ie);
- throw iio;
- }
-
- if ((currentState & (CLOSED | USABLE)) != 0) {
- return;
- }
-
- throw new IOException("Messenger was unexpectedly closed.");
- }
-
- /**
- * {@inheritDoc}
- */
- public final boolean sendMessage(Message msg) throws IOException {
- return sendMessage(msg, null, null);
- }
-
- /**
- * {@inheritDoc}
- *
- */
- public void sendMessage(Message msg, String service, String serviceParam, OutgoingMessageEventListener listener) {
- throw new UnsupportedOperationException("This legacy method is not supported by this messenger.");
- }
-
- /**
- * {@inheritDoc}
- */
- public final boolean sendMessage(Message msg, String rService, String rServiceParam) throws IOException {
-
- // We have to retrieve the failure from the message and throw it if its an IOException, this is what the API
- // says that this method does.
-
- if (sendMessageN(msg, rService, rServiceParam)) {
- return true;
- }
-
- Object failed = msg.getMessageProperty(Messenger.class);
-
- if ((failed == null) || !(failed instanceof OutgoingMessageEvent)) {
- // huh ?
- return false;
- }
-
- Throwable t = ((OutgoingMessageEvent) failed).getFailure();
-
- if (t == null) {
- // Must be saturation, then. (No throw for that).
- return false;
- }
-
- // Now see how we can manage to throw it.
- if (t instanceof IOException) {
- throw (IOException) t;
- } else if (t instanceof RuntimeException) {
- throw (RuntimeException) t;
- } else if (t instanceof Error) {
- throw (Error) t;
- }
-
- IOException failure = new IOException("Failure sending message");
-
- failure.initCause(t);
-
- throw failure;
- }
-
- /**
- * {@inheritDoc}
- *
- * This method synchronizes on the lock object supplied at construction.
- */
- public final int waitState(int wantedStates, long timeout) throws InterruptedException {
- synchronized (stateLock) {
- if (timeout == 0) {
- while ((wantedStates & getState()) == 0) {
- stateLock.wait();
- }
- return getState();
- }
-
- if (timeout < 0) {
- stateLock.wait(timeout); // let it throw the appropriate error.
- }
-
- long start = System.currentTimeMillis();
- long end = start + timeout;
-
- if (end < start) {
- end = Long.MAX_VALUE;
- }
- long left = end - start;
-
- while ((left > 0) && (wantedStates & getState()) == 0) {
-
- stateLock.wait(left);
-
- left = end - System.currentTimeMillis();
- }
-
- return getState();
- }
- }
-
- /*
- * SimpleSelectable implementation.
- */
-
- /**
- * Implements a default for all AbstractMessengers: mirror the event to our selectors. This is what is needed by all the
- * known AbstractMessengers that register themselves somewhere. (That is ChannelMessengers).
- * FIXME - jice@jxta.org 20040413: Not sure that this is the best default.
- *
- * @param changedObject Ignored.
- */
- public void itemChanged(SimpleSelectable changedObject) {
- notifyChange();
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/AsyncChannelMessenger.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/AsyncChannelMessenger.java
deleted file mode 100644
index ff8607eb..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/AsyncChannelMessenger.java
+++ /dev/null
@@ -1,665 +0,0 @@
-/*
- * Copyright (c) 2004-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.endpoint;
-
-import net.jxta.peergroup.PeerGroupID;
-
-import java.io.IOException;
-import java.io.InterruptedIOException;
-import java.util.concurrent.ArrayBlockingQueue;
-import java.util.concurrent.BlockingQueue;
-
-/**
- * Extends Channel Messenger behaviour to provide asynchronous message sending
- * via queuing.
- */
-public abstract class AsyncChannelMessenger extends ChannelMessenger {
-
- /*
- * Logger
- * private final static transient Logger LOG = Logger.getLogger(AsyncChannelMessenger.class.getName());
- */
-
- /**
- * {@code true} if we have deliberately closed our one message input queue.
- */
- private boolean inputClosed = false;
-
- /**
- * {@code true} if we have deliberately stopped sending.
- */
- private boolean outputClosed = false;
-
- /**
- * Actions that we defer to after returning from event methods. In other
- * words, they cannot be done with the lock held, or they require calling
- * more event methods.
- */
- private enum DeferredAction {
-
- /**
- * No action deferred.
- */
- ACTION_NONE,
- /**
- * Must send the current message.
- */
- ACTION_SEND,
- /**
- * Must report failure to connect.
- */
- ACTION_CONNECT
- }
-
- /**
- * The current deferred action.
- */
- private DeferredAction deferredAction = DeferredAction.ACTION_NONE;
-
- /**
- * The messages queue.
- */
- private final BlockingQueue queue;
-
- /**
- * State lock and engine.
- */
- private final AsyncChannelMessengerState stateMachine;
-
- /**
- * Our statemachine implementation; just connects the standard MessengerState action methods to
- * this object.
- */
- private class AsyncChannelMessengerState extends MessengerState {
-
- protected AsyncChannelMessengerState(boolean connected) {
- super(connected);
- }
-
- /*
- * The required action methods.
- */
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected void connectAction() {
- deferredAction = DeferredAction.ACTION_CONNECT;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected void startAction() {
- deferredAction = DeferredAction.ACTION_SEND;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected void closeInputAction() {
- // We're synchronized here. (invoked from stateMachine)
- inputClosed = true;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected void closeOutputAction() {
- // We're synchronized here. (invoked from stateMachine)
- outputClosed = true;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected void failAllAction() {
-
- // The queue is now closed, so we can rest assured that the last
- // message is really the last one. This is a synchronous action. The
- // state machine assumes that it is done when we return. There is no
- // need to signal completion with an idleEvent.
- PendingMessage theMsg;
-
- while (true) {
- theMsg = null;
-
- synchronized (stateMachine) {
- theMsg = queue.poll();
- }
-
- if (theMsg == null) {
- return;
- }
-
- Message currentMsg = theMsg.msg;
- Throwable currentFailure = theMsg.failure;
-
- if (currentFailure == null) {
- currentFailure = new IOException("Messenger unexpectedly closed");
- }
-
- OutgoingMessageEvent event = new OutgoingMessageEvent(currentMsg, currentFailure);
-
- currentMsg.setMessageProperty(Messenger.class, event);
- }
- }
- }
-
-
- /**
- * The representation of a queued message. It is shared between this
- * abstract class and any implementation.
- */
- protected static class PendingMessage {
- final Message msg;
- final String service;
- final String param;
- Throwable failure;
-
- PendingMessage(Message msg, String service, String param) {
- this.msg = msg;
- this.service = service;
- this.param = param;
- this.failure = null;
- }
- }
-
- /**
- * Create a new AsyncChannelMessenger.
- *
- * @param baseAddress The network address messages go to; regardless of
- * service, param, or group.
- * @param redirection Group to which the messages must be redirected. This
- * is used to implement the automatic group segregation which has become a
- * de-facto standard. If not null, the unique portion of the specified
- * groupID is prepended with {@link #InsertedServicePrefix} and inserted in
- * every message's destination address in place of the the original service
- * name, which gets shifted into the beginning of the service parameter. The
- * opposite is done on arrival to restore the original destination address
- * before the message is delivered to the listener in the the specified
- * group. Messages that already bear a group redirection are not affected.
- * @param origService The default destination service for messages sent
- * without specifying a different service.
- * @param origServiceParam The default destination service parameter for
- * messages sent without specifying a different service parameter.
- * @param queueSize the queue size that channels should have.
- * @param connected true if the channel is created in the connected state.
- */
- public AsyncChannelMessenger(EndpointAddress baseAddress, PeerGroupID redirection, String origService, String origServiceParam, int queueSize, boolean connected) {
-
- super(baseAddress, redirection, origService, origServiceParam);
-
- stateMachine = new AsyncChannelMessengerState(connected);
-
- queue = new ArrayBlockingQueue(queueSize);
-
- // We synchronize our state with the sharedMessenger's stateMachine.
- // Logic would dictate that we pass it to super(), but it is not itself
- // constructed until super() returns. No way around it.
-
- setStateLock(stateMachine);
- }
-
- /**
- * {@inheritDoc}
- */
- public final void close() {
- DeferredAction action;
-
- synchronized (stateMachine) {
- stateMachine.closeEvent();
- action = eventCalled(true);
- }
-
- // We called an event. State may have changed.
- notifyChange();
-
- performDeferredAction(action);
- }
-
- /**
- * This internal method does the common part of sending the message on
- * behalf of both sendMessageN and sendMessageB.
- * It is not quite possible to implement sendMessageB as a wrapper
- * around sendMessageN without some internal cooperation. At least not in
- * an efficient manner. sendMessageB must not set the message property:
- * either it fails and throws, or it returns successfully and the property
- * is set later. This is required so that messages can be retried when
- * failing synchronously (through a blocking messenger typically, but the
- * semantic has to be uniform).
- * Each of sendMessageB and sendMessageN takes care of status reporting
- * on its own terms.
- *
- * @param msg the message to send
- * @param rService destination service
- * @param rServiceParam destination param
- * @return The outcome from that one attempt. {@code true} means done.
- * {@code false} means saturated. When {@code true} is returned, it means
- * that the fate of the message will be decided asynchronously, so we do
- * not have any details, yet.
- * @throws IOException is thrown if this messenger is closed.
- * @throws InterruptedException if interrupted
- */
- private boolean sendMessageCommon(Message msg, String rService, String rServiceParam) throws IOException, InterruptedException {
-
- String service = effectiveService(rService);
- String serviceParam = effectiveParam(rService, rServiceParam);
- boolean queued = true;
- boolean change = false;
- DeferredAction action = DeferredAction.ACTION_NONE;
-
- synchronized (stateMachine) {
- if (inputClosed) {
- throw new IOException("This messenger is closed. It cannot be used to send messages.");
- }
-
- boolean wasEmpty = queue.isEmpty();
-
- if (queue.remainingCapacity() > 1) {
- queue.put(new PendingMessage(msg, service, serviceParam));
-
- // Still not saturated. If we weren't idle either, then nothing worth mentionning.
- if (wasEmpty) {
- change = true;
- stateMachine.msgsEvent();
- action = eventCalled(false);
- }
- } else if (1 == queue.remainingCapacity()) {
- queue.put(new PendingMessage(msg, service, serviceParam));
-
- // Now saturated.
- stateMachine.saturatedEvent();
- action = eventCalled(false);
- change = true;
- } else {
- // Was already saturated.
- queued = false;
- }
- }
-
- if (queued && change) {
- // If not queued, there was no change of condition as far as
- // outsiders are concerned. (redundant saturatedEvent, only
- // defensive; to guarantee statemachine in sync). else, if the
- // saturation state did not change, we have no state change to
- // notify.
- notifyChange();
- }
-
- performDeferredAction(action);
-
- // Before we return, make sure that this channel remains referenced if
- // it has messages. It could become unreferenced if it is not yet
- // resolved and the application lets go of it after sending messages.
- // This means that we may need to do something only in the resolpending
- // and resolsaturated cases. The way we do this test, there can be false
- // positives. They're dealt with as part of the action that is carried
- // out.
- if ((stateMachine.getState() & (Messenger.RESOLPENDING | Messenger.RESOLSATURATED)) != 0) {
- resolPendingImpl();
- }
-
- return queued;
- }
-
- /**
- * {@inheritDoc}
- */
- public final boolean sendMessageN(Message msg, String rService, String rServiceParam) {
-
- try {
- if (sendMessageCommon(msg, rService, rServiceParam)) {
- // If it worked the message is queued; the outcome will be notified later.
- return true;
- }
- // Non-blocking and queue full: report overflow.
- msg.setMessageProperty(Messenger.class, OutgoingMessageEvent.OVERFLOW);
- } catch (IOException oie) {
- msg.setMessageProperty(Messenger.class, new OutgoingMessageEvent(msg, oie));
- } catch (InterruptedException interrupted) {
- msg.setMessageProperty(Messenger.class, new OutgoingMessageEvent(msg, interrupted));
- }
- return false;
- }
-
- /**
- * {@inheritDoc}
- */
- public final void sendMessageB(Message msg, String rService, String rServiceParam) throws IOException {
-
- try {
- while (true) {
- // if sendMessageCommon says "true" it worked.
- if (sendMessageCommon(msg, rService, rServiceParam)) {
- return;
- }
- // Do a shallow check on the queue. If it seems empty (without getting into a critical section to
- // verify it), then yielding is good bet. It is a lot cheaper and smoother than waiting.
- // Note the message should be enqueued now. yielding makes sense now if the queue is empty
- if (queue.isEmpty()) {
- Thread.yield();
- }
-
- // If we reached this far, it is neither closed, nor ok. So it was saturated.
- synchronized (stateMachine) {
- // Cheaper than waitState. sendMessageCommon already does the relevant state checks.
- stateMachine.wait();
- }
- }
- } catch (InterruptedException ie) {
- InterruptedIOException iie = new InterruptedIOException("Message send interrupted");
-
- iie.initCause(ie);
- throw iie;
- }
- }
-
- /**
- * {@inheritDoc}
- */
- public final void resolve() {
- DeferredAction action;
-
- synchronized (stateMachine) {
- stateMachine.resolveEvent();
- action = eventCalled(true);
- }
- notifyChange();
- performDeferredAction(action); // we expect connect but let the state machine decide.
- }
-
- /**
- * {@inheritDoc}
- */
- public final int getState() {
- return stateMachine.getState();
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public final Messenger getChannelMessenger(PeerGroupID redirection, String service, String serviceParam) {
- // Channels don't make channels.
- return null;
- }
-
- /**
- * Three exposed methods may need to inject new events in the system:
- * sendMessageN, close, and shutdown.
- * Since they can all cause actions, and since connectAction and
- * startAction are deferred, it seems possible that one of the actions
- * caused by send, close, or shutdown be called while connectAction or
- * startAction are in progress.
- * However, the state machine gives us a few guarantees: connectAction
- * and startAction can never nest. We will not be asked to perform one while
- * still performing the other. Only the synchronous actions closeInput,
- * closeOutput, or failAll can possibly be requested in the interval. We
- * could make more assumptions and simplify the code, but rather keep at
- * least some flexibility.
- *
- * DEAD LOCK WARNING: the implementor's method invoke some of our call backs
- * while synchronized. Then our call backs synchronize on the state machine
- * in here. This nesting order must always be respected. As a result, we can
- * never invoke implementors methods while synchronized. Hence the
- * deferredAction processing.
- *
- * @param action the action
- */
- private void performDeferredAction(DeferredAction action) {
- switch (action) {
- case ACTION_SEND:
- startImpl();
- break;
-
- case ACTION_CONNECT:
- connectImpl();
- break;
- }
- }
-
- /**
- * A shortHand for a frequently used sequence. MUST be called while
- * synchronized on stateMachine.
- *
- * @param notifyAll If {@code true} then this is a life-cycle event and all
- * waiters on the stateMachine should be notified. If {@code false} then
- * only a single waiter will be notified for simple activity events.
- * @return the deferred action.
- */
- private DeferredAction eventCalled(boolean notifyAll) {
- DeferredAction action = deferredAction;
-
- deferredAction = DeferredAction.ACTION_NONE;
- if (notifyAll) {
- stateMachine.notifyAll();
- } else {
- stateMachine.notify();
- }
- return action;
- }
-
- /*
- * Implement the methods that our shared messenger will use to report progress.
- */
-
- /**
- * The implementation will invoke this method when it becomes resolved,
- * after connectImpl was invoked.
- */
- protected void up() {
- DeferredAction action;
-
- synchronized (stateMachine) {
- stateMachine.upEvent();
- action = eventCalled(true);
- }
- notifyChange();
- performDeferredAction(action); // we expect start but let the state machine decide.
- }
-
- /**
- * The implementation invokes this method when it becomes broken.
- */
- protected void down() {
- DeferredAction action;
-
- synchronized (stateMachine) {
- stateMachine.downEvent();
- action = eventCalled(true);
- }
- notifyChange();
- performDeferredAction(action); // we expect connect but let the state machine decide.
- }
-
- /**
- * Here, we behave like a queue to the shared messenger. When we report
- * being empty, though, we're automatically removed from the active queues
- * list. We'll go back there the next time we have something to send by
- * calling startImpl.
- *
- * @return pending message
- */
- protected PendingMessage peek() {
-
- PendingMessage theMsg;
- DeferredAction action = DeferredAction.ACTION_NONE;
-
- synchronized (stateMachine) {
- // We like the msg to keep occupying space in the queue until it's
- // out the door. That way, idleness (that is, not currently working
- // on a message), is always consistent with queue emptyness.
-
- theMsg = queue.peek();
- if (theMsg == null) {
- stateMachine.idleEvent();
- action = eventCalled(false);
-
- // We do not notifyChange, here, because, if the queue is empty,
- // it was already notified when the last message was popped. The
- // call to idleEvent is only defensive programming to make extra
- // sure the state machine is in sync.
-
- return null;
- }
-
- if (outputClosed) {
- // We've been asked to stop sending. Which, if we were sending,
- // must be notified by either an idle event or a down
- // event. Nothing needs to happen to the shared messenger. We're
- // just a channel.
- stateMachine.downEvent();
- action = eventCalled(true);
- theMsg = null;
- }
- }
-
- notifyChange();
- performDeferredAction(action); // we expect none but let the state machine decide.
- return theMsg;
- }
-
- /**
- * Returns the number of elements in this collection. If this collection
- * contains more than Integer.MAX_VALUE elements, returns
- * Integer.MAX_VALUE.
- *
- * @return the number of elements in this collection
- */
- protected int size() {
- return queue.size();
- }
-
- /**
- * One message done. Update the saturated/etc state accordingly.
- *
- * @return true if there are more messages after the one we removed.
- */
- protected boolean poll() {
-
- boolean result;
- DeferredAction action;
-
- synchronized (stateMachine) {
- queue.poll();
-
- if (queue.peek() == null) {
- stateMachine.idleEvent();
- action = eventCalled(false);
- result = false;
- } else {
- stateMachine.msgsEvent();
- action = eventCalled(false);
- result = true;
- }
- }
-
- notifyChange();
- performDeferredAction(action); // we expect none but let the state machine decide.
-
- return result;
- }
-
- /**
- * We invoke this method to be placed on the list of channels that have
- * message to send.
- *
- * NOTE that it is the shared messenger responsibility to synchronize so
- * that we cannot be added to the active list just before we get removed
- * due to reporting an empty queue in parallel. So, if we report an empty
- * queue and have a new message to send before the shared messenger removes
- * us form the active list, startImpl will block until the removal is done.
- * Then we'll be added back.
- *
- * If it cannot be done, it means that the shared messenger is no longer
- * usable. It may call down() in sequence. Out of defensiveness, it should
- * do so without holding its lock.
- */
- protected abstract void startImpl();
-
- /**
- * We invoke this method to be placed on the list of channels that are
- * waiting for resolution.
- *
- * If it cannot be done, it means that the shared messenger is no longer
- * usable. It may call down() in sequence. Out of defensiveness, it should
- * do so without holding its lock. If the messenger is already resolved it
- * may call up() in sequence. Same wisdom applies. It is a good idea to
- * create channels in the resolved state if the shared messenger is already
- * resolved. That avoids this extra contortion.
- */
- protected abstract void connectImpl();
-
- /**
- * This is invoked to inform the implementation that this channel is now in
- * the resolPending or resolSaturated state. This is specific to this type
- * of channels. The shared messenger must make sure that this channel
- * remains strongly referenced, even though it is not resolved, because
- * there are messages in it. It is valid for an application to let go of a
- * channel after sending a message, even if the channel is not yet
- * resolved. The message will go if/when the channel resolves. This method
- * may be invoked redundantly and even once the channel is no longer among
- * the one awaiting resolution. The implementation must be careful to
- * ignore such calls.
- */
- protected abstract void resolPendingImpl();
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/ByteArrayMessageElement.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/ByteArrayMessageElement.java
deleted file mode 100644
index f2892b7e..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/ByteArrayMessageElement.java
+++ /dev/null
@@ -1,383 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.endpoint;
-
-
-import net.jxta.document.MimeMediaType;
-import java.util.logging.Level;
-import net.jxta.logging.Logging;
-import java.util.logging.Logger;
-
-import java.io.*;
-import java.lang.ref.SoftReference;
-import java.util.zip.CRC32;
-import java.util.zip.Checksum;
-
-
-/**
- * A Message Element using byte arrays for the element data.
- *
- * This implementation does not copy the byte array provided and assumes
- * that the contents of the byte array will not change through out the lifetime
- * of the MessageElement.
- *
- * some synchronization is due to optimization in {@link #getBytes(boolean)}
- * which replaces value of internal member {@link #b}.
- */
-public class ByteArrayMessageElement extends MessageElement {
-
- /**
- * Logger
- */
- private static transient final Logger LOG = Logger.getLogger(ByteArrayMessageElement.class.getName());
-
- /**
- * The bytes of this element.
- */
- protected byte[] b;
-
- /**
- * This is the offset of our data within the array
- */
- protected int offset;
-
- /**
- * length of the element data. sometimes the same as b.length, but may be
- * lesser.
- */
- protected int len;
-
- /**
- * Create a new Message Element. The contents of the provided byte array
- * are not copied during construction.
- *
- * @param name Name of the MessageElement. May be the empty string ("") if
- * the MessageElement is not named.
- * @param type Type of the MessageElement. null is the same as specifying
- * the type "Application/Octet-stream".
- * @param b A byte array containing the contents of this element.
- * @param sig optional message digest/digital signature element or null if
- * no signature is desired.
- */
- public ByteArrayMessageElement(String name, MimeMediaType type, byte[] b, MessageElement sig) {
- this(name, type, b, 0, b.length, sig);
- }
-
- /**
- * Create a new MessageElement, The contents of the provided byte array are
- * not copied during construction.
- *
- * @param name Name of the MessageElement. May be the empty string ("") if
- * the MessageElement is not named.
- * @param type Type of the MessageElement. null is the same as specifying
- * the type "Application/Octet-stream".
- * @param b A byte array containing the contents of this element.
- * @param offset all bytes before this location in b
- * will be ignored.
- * @param sig optional message digest/digital signature elemnent or null if
- * no signature is desired.
- */
- public ByteArrayMessageElement(String name, MimeMediaType type, byte[] b, int offset, MessageElement sig) {
- this(name, type, b, offset, b.length - offset, sig);
- }
-
- /**
- * Create a new Element, but dont add it to the message. The contents of
- * the byte array are not copied during construction.
- *
- * @param name Name of the MessageElement. May be the empty string ("") if
- * the MessageElement is not named.
- * @param type Type of the MessageElement. null is the same as specifying
- * the type "Application/Octet-stream".
- * @param b A byte array containing the contents of this Element.
- * @param offset all bytes before this location will be ignored.
- * @param len number of bytes to include
- * @param sig optional message digest/digital signature element or null if
- * no signature is desired.
- */
- public ByteArrayMessageElement(String name, MimeMediaType type, byte[] b, int offset, int len, MessageElement sig) {
- super(name, type, sig);
-
- if (null == b) {
- throw new IllegalArgumentException("byte array must not be null");
- }
-
- if (len < 0) {
- throw new IllegalArgumentException("len must be >= 0 : " + len);
- }
-
- if (offset < 0) {
- throw new IllegalArgumentException("offset must within byte array : " + offset);
- }
-
- if ((0 != len) && (offset >= b.length)) {
- throw new IllegalArgumentException("offset must be positioned within byte array : " + offset + "," + len);
- }
-
- if (((offset + len) > b.length) || ((offset + len) < 0)) {
- throw new IllegalArgumentException("offset + len must be positioned within byte array");
- }
-
- // if we get an empty request and a non-empty buffer, we don't use the provided buffer.
- if ((0 == len) && (0 != b.length)) {
- b = new byte[len];
- offset = 0;
- }
-
- this.b = b;
- this.offset = offset;
- this.len = len;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public boolean equals(Object target) {
- if (this == target) {
- return true;
- }
-
- if (target instanceof MessageElement) {
- if (!super.equals(target)) {
- return false;
- }
-
- if (target instanceof ByteArrayMessageElement) {
- ByteArrayMessageElement likeMe = (ByteArrayMessageElement) target;
-
- synchronized (this) {
- synchronized (likeMe) {
- if (likeMe.len != len) {
- return false;
- }
-
- for (int eachByte = len - 1; eachByte >= 0; eachByte--) {
- if (likeMe.b[likeMe.offset + eachByte] != b[offset + eachByte]) {
- return false;
- }
- }
- }
- }
-
- return true;
- } else {
- // have to do a slow stream comparison.
- // XXX 20020615 bondolo@jxta.org the performance of this could be much improved.
- try {
- MessageElement likeMe = (MessageElement) target;
-
- InputStream myStream = getStream();
- InputStream itsStream = likeMe.getStream();
-
- int mine;
- int its;
-
- do {
- mine = myStream.read();
- its = itsStream.read();
-
- if (mine != its) {
- return false;
- } // content didn't match
-
- } while ((-1 != mine) && (-1 != its));
-
- return ((-1 == mine) && (-1 == its)); // end at the same time?
- } catch (IOException fatal) {
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE, "MessageElements could not be compared.", fatal);
- }
-
- throw new IllegalStateException("MessageElements could not be compared." + fatal);
- }
- }
- }
-
- return false; // not a message element
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public synchronized int hashCode() {
- Checksum crc = new CRC32();
-
- crc.update(b, offset, len);
- int dataHash = (int) crc.getValue();
-
- int result = super.hashCode() * 6037 + // a prime
- dataHash;
-
- return (0 != result) ? result : 1;
- }
-
- /**
- * {@inheritDoc}
- *
- * Returns the string representation of this element. The 'charset'
- * parameter of the mimetype, if any, is used to determine encoding. If
- * the charset specified is unsupported then the default encoding will be
- * used.
- *
- * @return String string representation of this message element.
- */
- @Override
- public synchronized String toString() {
- String result;
-
- if (null != cachedToString) {
- result = cachedToString.get();
-
- if (null != result) {
- return result;
- }
- }
-
- if (LOG.isLoggable(Level.FINER)) {
- LOG.finer("creating toString of " + getClass().getName() + '@' + Integer.toHexString(hashCode()));
- }
-
- String charset = type.getParameter("charset");
-
- try {
- if (null == charset) {
- result = new String(b, offset, len);
- } else {
- result = new String(b, offset, len, charset);
- }
- } catch (UnsupportedEncodingException caught) {
- result = new String(b, offset, len);
- }
-
- cachedToString = new SoftReference(result);
-
- return result;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public long getByteLength() {
- return len;
- }
-
- /**
- * {@inheritDoc}
- *
- * synchronized so that we can replace our internal buffer with
- * the buffer we are returning if we were using a shared buffer.
- */
- @Override
- public synchronized byte[] getBytes(boolean copy) {
- if ((!copy) && (0 == offset) && (b.length == len)) {
- return b;
- }
-
- byte[] result = new byte[len];
-
- System.arraycopy(b, offset, result, 0, len);
-
- // if we were using a sub-array we can switch to using this copy.
- if (!copy) {
- b = result;
- offset = 0;
- }
-
- return result;
- }
-
- /**
- * {@inheritDoc}
- */
- public synchronized InputStream getStream() {
- return new ByteArrayInputStream(b, offset, len);
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public void sendToStream(OutputStream sendTo) throws IOException {
- byte[] sending;
- int sendingOffset;
-
- // locals enable us to reduce the time which the object is synchronized.
- synchronized (this) {
- sending = b;
- sendingOffset = offset;
- }
-
- sendTo.write(sending, sendingOffset, len);
- }
-
- /**
- * Returns the contents of this element as a byte array. If this elements
- * was originally constructed from a intact byte array, the array returned
- * is a "shared" copy of the byte array used by this element. If this
- * element was constructed with an offset of other than zero and a length
- * different than the length of the source array then this function WILL
- * RETURN A COPY OF THE BYTE ARRAY.
- *
- * @return a byte array containing the contents of this element.
- */
- public byte[] getBytes() {
- return getBytes(false);
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/ChannelMessenger.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/ChannelMessenger.java
deleted file mode 100644
index 38beb662..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/ChannelMessenger.java
+++ /dev/null
@@ -1,214 +0,0 @@
-/*
- * Copyright (c) 2004-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.endpoint;
-
-
-import net.jxta.peergroup.PeerGroupID;
-
-
-/**
- * A Channel Messenger provides an exclusive interface to the shared messenger.
- *
- * What is typically exclusive is the message queue, addressing parameters
- * that are not usefully shared (serviceName, serviceParam), and if needed
- * cross-group address rewriting parameters.
- *
- * This class is provided as a base for implementing such channel messengers,
- * which are typically what Messenger.getChannelMessenger() needs to return.
- *
- * @see net.jxta.endpoint.EndpointService
- * @see net.jxta.endpoint.EndpointAddress
- * @see net.jxta.endpoint.Message
- */
-public abstract class ChannelMessenger extends AbstractMessenger implements Messenger {
-
- /**
- * insertedServicePrefix This is how all valid inserted services start. This
- * lets us recognize if a message already has an inserted service. Then we
- * must not add another one. Only the top-most one counts. Since insertion
- * is only done here, the constant is defined here. Even if historically it
- * was done within the endpoint implementation, it has become a protocol now.
- */
- public static final String InsertedServicePrefix = "EndpointService:";
-
- private String insertedService;
-
- /**
- * The worker that implements sendMessage-with-listener for this channel. If
- * there's none, sendMessage-with-listener will throw an exception. Channels
- * returned by getMessenger methods all have one already. It is up to the
- * invoker of getChannelMessenger to supply one or not.
- */
- private ListenerAdaptor messageWatcher;
-
- protected String origService;
-
- protected String origServiceParam;
-
- /**
- * Figure out what the service string will be after mangling (if required)
- * and applying relevant defaults.
- *
- * @param service The service name in the unmangled address.
- * @return String The service name in the mangled address.
- */
- protected String effectiveService(String service) {
-
- // No redirection required. Just apply the default service.
- if (insertedService == null) {
- return (service == null) ? origService : service;
- }
-
- // Check if redirection is applicable.
- return ((service != null) && service.startsWith(InsertedServicePrefix)) ? service : insertedService;
- }
-
- /**
- * Figure out what the param string will be after mangling (if required) and
- * applying relevant defaults.
- *
- * @param service The service name in the unmangled address.
- * @param serviceParam The service parameter in the unmangled address.
- * @return String The service parameter in the mangled address.
- */
- protected String effectiveParam(String service, String serviceParam) {
-
- // No redirection required. Or not applicable. Just apply the default param.
- if ((insertedService == null) || ((service != null) && service.startsWith(InsertedServicePrefix))) {
- return (serviceParam == null) ? origServiceParam : serviceParam;
- }
-
- // Apply redirection. We need the effective service, now.
- if (service == null) {
- service = origService;
- }
-
- if (serviceParam == null) {
- serviceParam = origServiceParam;
- }
-
- return ((null != service) && (null != serviceParam)) ? (service + "/" + serviceParam) : service;
- }
-
- /**
- * Give this channel the watcher that it must use whenever sendMessage(...,listener) is used. If not set,
- * sendMessage(..., listener) will throw.
- *
- * @param messageWatcher the listener
- */
- public void setMessageWatcher(ListenerAdaptor messageWatcher) {
- this.messageWatcher = messageWatcher;
- }
-
- /**
- * Create a new ChannelMessenger
- *
- * @param baseAddress The network address messages go to; regardless of service, param, or group.
- * @param groupRedirection Group to which the messages must be redirected. This is used to implement the automatic group
- * segregation which has become a de-facto standard. If not null, the unique portion of the specified groupID is
- * prepended with {@link #InsertedServicePrefix} and inserted in every message's destination address in place of the
- * the original service name, which gets shifted into the beginning of the service parameter. The opposite is done
- * on arrival to restore the original destination address before the message is delivered to the listener in the
- * the specified group. Messages that already bear a group redirection are not affected.
- * @param origService The default destination service for messages sent without specifying a different service.
- * @param origServiceParam The default destination service parameter for messages sent without specifying a different service
- * parameter.
- */
- public ChannelMessenger(EndpointAddress baseAddress, PeerGroupID groupRedirection, String origService, String origServiceParam) {
-
- // FIXME: The inserted service business is really messy. Group seggregation does not have to be the endpoint service's
- // business. It should be specified by the app as part of the destination address. What we're doing here
- // is simply enforcing what could just be a convention.
-
- super(baseAddress);
- if (groupRedirection == null) {
- insertedService = null;
- } else {
- insertedService = InsertedServicePrefix + groupRedirection.getUniqueValue().toString();
- }
- this.origService = origService;
- this.origServiceParam = origServiceParam;
- }
-
- /**
- * {@inheritDoc}
- *
- * By default a channel refuses to make a channel.
- */
- public Messenger getChannelMessenger(PeerGroupID redirection, String service, String serviceParam) {
- return null;
- }
-
- /**
- * {@inheritDoc}
- *
- */
- @Override
- public void sendMessage(Message msg, String service, String serviceParam, OutgoingMessageEventListener listener) {
- if (messageWatcher == null) {
- throw new UnsupportedOperationException("This channel was not configured to emulate this legacy method.");
- }
-
- // Cleanup the message from any existing result prop since we're going to use select.
- msg.setMessageProperty(Messenger.class, null);
-
- // Tell the watcher to select that message.
- messageWatcher.watchMessage(listener, msg);
-
- sendMessageN(msg, service, serviceParam);
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/EndpointAddress.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/EndpointAddress.java
deleted file mode 100644
index e804f579..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/EndpointAddress.java
+++ /dev/null
@@ -1,637 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.endpoint;
-
-import net.jxta.id.ID;
-import net.jxta.logging.Logging;
-
-import java.lang.ref.SoftReference;
-import java.net.URI;
-import java.util.logging.Level;
-import java.util.logging.Logger;
-
-/**
- * Describes a destination to which JXTA messages may be sent. This may be:
- *
- *
- *
- * - A Pipe
- * - A Peergroup (propagate)
- * - A Peer
- * - A Message Transport for a Peer
- *
- *
- * An Endpoint Address is a specialized interpretation of a URI.
- * Wherever it makes sense you should use a URI in preference to an Endpoint
- * Address. An Endpoint Address is composed of four components: a protocol
- * (also called a scheme), a protocol address (also called an authority), an
- * optional service name and optional service parameter.
- *
- * The Protocol
- * - Describes the method of addressing used by the remainder of the
- * endpoint address.
- * - Indicates how the address will be resolved, ie. who will resolve it.
- * - Corresponds to the "scheme" portion of a URI in W3C parlance.
- *
- May not contain the ":" character.
- *
- *
- * The Protocol Address
- * - Describes the destination entity of this address.
- * - Form is dependant upon the protocol being used.
- * - Corresponds to the "Authority" portion of a URI in W3C parlance.
- *
- May not contain the "/" character.
- *
- *
- * The Service Name (optional)
- * - Describes the service that is the destination. A service cannot be
- * a protocol address because a service must have a location; a group or a
- * specific peer.
- * - Form is dependant upon service intent. This is matched as a UTF8
- * string.
- * - May not contain the "/" character.
- *
- *
- * The Service Parameter (optional)
- * - Describes parameters for the service.
- * - Form is dependant upon service intent. This is matched as a UTF-8
- * string (if it is used for matching).
- *
- *
- * @see net.jxta.endpoint.EndpointService
- * @see net.jxta.endpoint.MessageTransport
- * @see net.jxta.endpoint.Messenger
- * @see net.jxta.pipe.PipeService
- */
-public class EndpointAddress {
-
- /**
- * Logger
- */
- private static final Logger LOG = Logger.getLogger(EndpointAddress.class.getName());
-
- /**
- * If {@code true} then endpoint addresses based upon IDs are represented
- * using the "jxta://" form. If false then they are presented using the
- * "urn:jxta:" form. The two forms are meant to be logically equivalent.
- */
- private final static boolean IDS_USE_JXTA_URL_FORM = true;
-
- /**
- * The default protocol value for Endpoint Addresses based upon JXTA IDs.
- */
- private final static String JXTA_ID_PROTOCOL = ID.URIEncodingName + ":" + ID.URNNamespace;
-
- /**
- * if true then the address is a url, otherwise its a uri (likely a urn).
- */
- private boolean hierarchical = true;
-
- /**
- * Describes the method of addressing used by the remainder of the
- * endpoint address.
- */
- private String protocol = null;
-
- /**
- * Describes the destination entity of this address.
- */
- private String protocolAddress = null;
-
- /**
- * Describes the service that is the destination.
- */
- private String service = null;
-
- /**
- * Describes parameters for the service.
- */
- private String serviceParam = null;
-
- /**
- * cached calculated hash code.
- */
- private transient int cachedHashCode = 0;
-
- /**
- * cached copy of string representation.
- */
- private transient SoftReference cachedToString = null;
-
- /**
- * Returns an unmodifiable clone of the provided EndpointAddress.
- *
- * @param address the address to be cloned.
- * @return the unmodifiable address clone.
- * @deprecated All EndpointAddresses are now unmodifiable so this method is
- * no longer needed.
- */
- @Deprecated
- public static EndpointAddress unmodifiableEndpointAddress(EndpointAddress address) {
- return address;
- }
-
- /**
- * Builds an Address from a string
- *
- * @param address the string representation of the address.
- */
- public EndpointAddress(String address) {
- parseURI(address);
- }
-
- /**
- * Create an EndpointAddress whose value is initialized from the provided
- * URI.
- *
- * @param address the URI representation of the address.
- */
- public EndpointAddress(URI address) {
- this(address.toString());
- }
-
- /**
- * Constructor which builds an endpoint address from a base address and
- * replacement service and params
- *
- * @param base The EndpointAddress on which the new EndpointAddress will be based
- * @param service The service name for the endpoint address or
- * {@code null} if there is no service name.
- * @param serviceParam The service parameter for the endpoint address or
- * {@code null} if there is no parameter.
- */
- public EndpointAddress(EndpointAddress base, String service, String serviceParam) {
- setProtocolName(base.getProtocolName());
- setProtocolAddress(base.getProtocolAddress());
- setServiceName(service);
- setServiceParameter(serviceParam);
- }
-
- /**
- * Constructor which builds an address the four standard constituent parts.
- *
- * @param protocol The addressing scheme to be used for the endpoint address.
- * @param address The destination for the endpoint address.
- * @param service The service name for the endpoint address or
- * {@code null} if there is no service name.
- * @param serviceParam The service parameter for the endpoint address or
- * {@code null} if there is no parameter.
- */
- public EndpointAddress(String protocol, String address, String service, String serviceParam) {
- setProtocolName(protocol);
- setProtocolAddress(address);
- setServiceName(service);
- setServiceParameter(serviceParam);
- }
-
- /**
- * Constructor which builds an address from a standard jxta id and a
- * service and param.
- *
- * @param id the ID which will be the destination of the endpoint address.
- * @param service The service name for the endpoint address or
- * {@code null} if there is no service name.
- * @param serviceParam The service parameter for the endpoint address or
- * {@code null} if there is no parameter.
- */
- public EndpointAddress(ID id, String service, String serviceParam) {
- setProtocolName(JXTA_ID_PROTOCOL);
- setProtocolAddress(id.getUniqueValue().toString());
- setServiceName(service);
- setServiceParameter(serviceParam);
- }
-
- /**
- * {@inheritDoc}
- *
- * @deprecated EndpointAddress objects are immutable and never need to be
- * cloned.
- */
- @Override
- @Deprecated
- public EndpointAddress clone() {
- return this;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public boolean equals(Object target) {
- if (this == target) {
- return true;
- }
-
- if (target instanceof EndpointAddress) {
- EndpointAddress likeMe = (EndpointAddress) target;
-
- boolean result = (hierarchical == likeMe.hierarchical) && protocol.equalsIgnoreCase(likeMe.protocol)
- && protocolAddress.equalsIgnoreCase(likeMe.protocolAddress)
- && ((service != null)
- ? ((likeMe.service != null) && service.equals(likeMe.service))
- : (likeMe.service == null))
- && ((serviceParam != null)
- ? ((likeMe.serviceParam != null) && serviceParam.equals(likeMe.serviceParam))
- : (likeMe.serviceParam == null));
-
- return result;
- }
-
- return false;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public int hashCode() {
- if (0 == cachedHashCode) {
- int calcedHashCode = protocol.toLowerCase().hashCode();
-
- calcedHashCode += protocolAddress.hashCode() * 5741; // a prime
- calcedHashCode += ((service != null) ? service.hashCode() : 1) * 7177; // a prime
- calcedHashCode += ((serviceParam != null) ? serviceParam.hashCode() : 1) * 6733; // a prime
-
- cachedHashCode = (0 == calcedHashCode) ? 1 : calcedHashCode;
- }
-
- return cachedHashCode;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public synchronized String toString() {
- String result;
-
- if (null != cachedToString) {
- result = cachedToString.get();
-
- if (null != result) {
- return result;
- }
- }
-
- StringBuilder newResult = new StringBuilder(protocol.length() + protocolAddress.length() + 64);
-
- newResult.append(protocol);
-
- if (hierarchical) {
- newResult.append("://");
- } else {
- newResult.append(':');
- }
-
- newResult.append(protocolAddress);
-
- if (null != service) {
- if (hierarchical) {
- newResult.append('/');
- } else {
- newResult.append('#');
- }
- newResult.append(service);
-
- if (null != serviceParam) {
- newResult.append('/');
- newResult.append(serviceParam);
- }
- }
-
- result = newResult.toString();
-
- cachedToString = new SoftReference(result);
-
- return result;
- }
-
- /**
- * Return a URI which represents the endpoint address.
- *
- * @return a URI which represents the endpoint address.
- */
- public URI toURI() {
- return URI.create(toString());
- }
-
- /**
- * Return a String that contains the name of the protocol
- * contained in the EndpointAddress
- *
- * @return a String containing the protocol name
- */
- public String getProtocolName() {
- return protocol;
- }
-
- /**
- * Return a String that contains the protocol address contained
- * in the EndpointAddress
- *
- * @return a String containing the protocol address
- */
- public String getProtocolAddress() {
- return protocolAddress;
- }
-
- /**
- * Return a String that contains the service name contained in
- * the EndpointAddress
- *
- * @return a String containing the service name
- */
- public String getServiceName() {
- return service;
- }
-
- /**
- * Return a String that contains the service parameter contained
- * in the EndpointAddress
- *
- * @return a String containing the protocol name
- */
- public String getServiceParameter() {
- return serviceParam;
- }
-
- /**
- * Set the protocol name.
- *
- * @param name String containing the name of the protocol
- */
- private void setProtocolName(String name) {
- if ((null == name) || (0 == name.length())) {
- throw new IllegalArgumentException("name must be non-null and contain at least one character");
- }
-
- if (-1 != name.indexOf("/")) {
- throw new IllegalArgumentException("name may not contain '/' character");
- }
-
- // XXX 20070207 bondolo We explicitly force all use of either "jxta" or "urn:jxta" to our prefered form.
- if (IDS_USE_JXTA_URL_FORM) {
- if (JXTA_ID_PROTOCOL.equals(name)) {
- name = "jxta";
- }
- } else {
- if ("jxta".equals(name)) {
- name = JXTA_ID_PROTOCOL;
- }
- }
-
- int colonAt = name.indexOf(':');
-
- if (-1 == colonAt) {
- hierarchical = true;
- } else {
- if (!"urn".equalsIgnoreCase(name.substring(0, colonAt))) {
- throw new IllegalArgumentException("Only urn may contain colon");
- }
-
- if (colonAt == (name.length() - 1)) {
- throw new IllegalArgumentException("empty urn namespace!");
- }
-
- hierarchical = false;
- }
-
- protocol = name;
- cachedToString = null;
- }
-
- /**
- * Set the protocol address.
- *
- * @param address String containing the peer address.
- */
- private void setProtocolAddress(String address) {
- if ((null == address) || (0 == address.length())) {
- throw new IllegalArgumentException("address must be non-null and contain at least one character");
- }
-
- if (-1 != address.indexOf("/")) {
- throw new IllegalArgumentException("address may not contain '/' character");
- }
-
- protocolAddress = address;
- cachedToString = null;
- }
-
- /**
- * Set the service name.
- *
- * @param name String containing the name of the destination service
- */
- private void setServiceName(String name) {
- if (null != name) {
- if (-1 != name.indexOf("/")) {
- throw new IllegalArgumentException("service name may not contain '/' character");
- }
- }
-
- service = name;
- cachedToString = null;
- }
-
- /**
- * Set the service parameter
- *
- * @param param String containing the service parameter
- */
- private void setServiceParameter(String param) {
- serviceParam = param;
- cachedToString = null;
- }
-
- /**
- * Parse any EndpointAddress from a URI
- *
- * @param addr endpoint address to parse
- */
- private void parseURI(String addr) {
- int index = addr.indexOf("://");
-
- if (index == -1) {
- parseURN(addr);
- } else {
- parseURL(addr);
- }
- }
-
- /**
- * Parse an EndpointAddress from a URN
- *
- * @param addr endpoint address to parse
- */
- private void parseURN(String addr) {
- int protocolEnd = addr.indexOf(':');
-
- if (-1 == protocolEnd) {
- if (Logging.SHOW_FINE && LOG.isLoggable(Level.FINE)) {
- LOG.fine("Address is not a valid URI: " + addr);
- }
- throw new IllegalArgumentException("Address is not a valid URI: " + addr);
- }
-
- if (!"urn".equalsIgnoreCase(addr.substring(0, protocolEnd))) {
- if (Logging.SHOW_FINE && LOG.isLoggable(Level.FINE)) {
- LOG.fine("Address is unrecognized URI form: " + addr);
- }
- throw new IllegalArgumentException("Address is unrecognized URI form: " + addr);
- }
-
- if ((addr.length() - 1) == protocolEnd) {
- if (Logging.SHOW_FINE && LOG.isLoggable(Level.FINE)) {
- LOG.fine("Address URN does not have a namespace: " + addr);
- }
- throw new IllegalArgumentException("Address URN does not have a namespace: " + addr);
- }
-
- // gather the namespace as well.
- int namespaceEnd = addr.indexOf(':', protocolEnd + 1);
-
- if (-1 == namespaceEnd) {
- if (Logging.SHOW_FINE && LOG.isLoggable(Level.FINE)) {
- LOG.fine("Address URN does not have a namespace: " + addr);
- }
- throw new IllegalArgumentException("Address URN does not have a namespace: " + addr);
- }
-
- setProtocolName(addr.substring(0, namespaceEnd));
-
- if ((addr.length() - 1) == namespaceEnd) {
- if (Logging.SHOW_FINE && LOG.isLoggable(Level.FINE)) {
- LOG.fine("Address URN does not have a NSS portion: " + addr);
- }
- throw new IllegalArgumentException("Address URN does not have a NSS portion: " + addr);
- }
-
- // check for service and param
- int nssEnd = addr.indexOf('#', namespaceEnd + 1);
-
- if (-1 == nssEnd) {
- setProtocolAddress(addr.substring(namespaceEnd + 1));
- } else {
- setProtocolAddress(addr.substring(namespaceEnd + 1, nssEnd));
-
- int serviceEnd = addr.indexOf('/', nssEnd + 1);
-
- if (-1 == serviceEnd) {
- setServiceName(addr.substring(nssEnd + 1));
- } else {
- setServiceName(addr.substring(nssEnd + 1, serviceEnd));
-
- setServiceParameter(addr.substring(serviceEnd + 1));
- }
- }
- }
-
- /**
- * Parse and EndpointAddress from a URL
- *
- * @param addr endpoint address to parse
- */
- private void parseURL(String addr) {
- String remainder;
-
- int index = addr.indexOf("://");
-
- if (index == -1) {
- if (Logging.SHOW_FINE && LOG.isLoggable(Level.FINE)) {
- LOG.fine("Address is not in absolute form: " + addr);
- }
- throw new IllegalArgumentException("Address is not in absolute form: " + addr);
- }
-
- if (0 == index) {
- if (Logging.SHOW_FINE && LOG.isLoggable(Level.FINE)) {
- LOG.fine("Protocol is missing: " + addr);
- }
- throw new IllegalArgumentException("Protocol is missing: " + addr);
- }
-
- try {
- setProtocolName(addr.substring(0, index));
- remainder = addr.substring(index + 3);
- } catch (Exception e) {
- if (Logging.SHOW_FINE && LOG.isLoggable(Level.FINE)) {
- LOG.fine("Protocol address is missing: " + addr);
- }
- throw new IllegalArgumentException("Protocol address is missing: " + addr);
- }
- index = remainder.indexOf("/");
- if (index == -1) {
- setProtocolAddress(remainder);
- return;
- }
-
- setProtocolAddress(remainder.substring(0, index));
-
- remainder = remainder.substring(index + 1);
-
- index = remainder.indexOf("/");
- if (index == -1) {
- setServiceName(remainder);
- return;
- }
-
- setServiceName(remainder.substring(0, index));
-
- remainder = remainder.substring(index + 1);
-
- setServiceParameter(remainder);
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/EndpointListener.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/EndpointListener.java
deleted file mode 100644
index a61d3cc9..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/EndpointListener.java
+++ /dev/null
@@ -1,79 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.endpoint;
-
-
-/**
- * A listener for messages. The listener is invoked for each incoming message
- * which is destined for this listener. Various services register
- *
- * @see net.jxta.endpoint.EndpointService
- * @see net.jxta.endpoint.EndpointAddress
- * @see net.jxta.endpoint.Message
- */
-public interface EndpointListener {
-
- /**
- * This method is invoked by the EndpointService for each incoming message
- * which is addressed to this listener.
- *
- * @param message Incoming message
- * @param srcAddr Endpoint Address of the source of the message.
- * @param dstAddr Endpoint Address of the destination of the message.
- */
- public void processIncomingMessage(Message message, EndpointAddress srcAddr, EndpointAddress dstAddr);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/EndpointService.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/EndpointService.java
deleted file mode 100644
index 27a8bf3c..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/EndpointService.java
+++ /dev/null
@@ -1,552 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.endpoint;
-
-
-import net.jxta.peergroup.PeerGroup;
-import net.jxta.service.Service;
-
-import java.io.IOException;
-import java.util.Iterator;
-
-
-/**
- * The EndpointService provides the API for sending and receiving messages
- * between peers. In general, applications and services use the
- * {@link net.jxta.pipe.PipeService}, or {@link net.jxta.socket.JxtaSocket}
- * rather than using this API directly.
- */
-public interface EndpointService extends Service, EndpointListener {
-
- /**
- * Low Priority Messenger Event Listener.
- */
- public static final int LowPrecedence = 0;
-
- /**
- * Medium Priority Messenger Event Listener.
- */
- public static final int MediumPrecedence = 1;
-
- /**
- * High Priority Messenger Event Listener.
- */
- public static final int HighPrecedence = 2;
-
- /**
- * Returns the group to which this EndpointService is attached.
- *
- * @return the group.
- */
- public PeerGroup getGroup();
-
- /**
- * Returns a messenger to the specified destination.
- *
- * The canonical messenger is shared between all channels who's
- * destination contain the same protocol name and protocol address, in all
- * groups that have access to the same transport. The ChannelMessenger
- * returned is configured to send messages to the specified service name and
- * service param when these are not specified at the time of sending.
- *
- * The channel will also ensure delivery to this EndpointService's group
- * on arrival. The channel is not shared with any other module. That is,
- * each endpoint service interface object (as returned by {@link
- * net.jxta.peergroup.PeerGroup#getEndpointService()}) will return a
- * different channel messenger for the same destination. However, there is
- * no guarantee that two invocations of the same endpoint service interface
- * object for the same destination will return different channel objects.
- * Notably, if the result of a previous invocation is still strongly
- * referenced and in a {@link Messenger#USABLE} state, then that is what
- * this method will return.
- *
- * This method returns immediately. The messenger is not necessarily
- * resolved (the required underlying connection established, for example),
- * and it might never resolve at all. Changes in the state of a messenger
- * may monitored with {@link Messenger#getState} and
- * {@link Messenger#waitState}. One may monitor multiple
- * {@link Messenger messengers} (and {@link Message Messages}) at a time by
- * using a {@link net.jxta.util.SimpleSelector}. One may also arrange to
- * have a listener invoked when resolution is complete by using
- * {@link ListenerAdaptor}.
- *
- * The {@code hint} is interpreted by the transport. The only transport
- * known to consider hints is the endpoint router, and the hint is a route.
- * As a result, if addr is in the form: jxta://uniqueID, then hint may be a
- * RouteAdvertisement. If that route is valid the router will add it to
- * it's cache of route and may then use it to successfully create a messenger
- * to the given destination. There is no guarantee at this time that the
- * route will end up being the one specified, nor that this route will be
- * used only for this messenger (likely the opposite), nor that it will
- * remain in use in the future, nor that it will be used at all. However, if
- * there is no other route, and if the specified route is valid, it will be
- * used rather than seeking an alternative.
- *
- * @param addr The complete destination address.
- * @param hint A optional hint to be supplied to whichever transport ends-up
- * making the real messenger. May be {@code null}, when no hint applies.
- * @return A messenger for the specified destination address or {@code null}
- * if the address is not handled by any of the available Message Transports.
- * The messenger, if returned, is not necessarily functional, nor resolved.
- * @see net.jxta.endpoint.ChannelMessenger
- */
- public Messenger getMessengerImmediate(EndpointAddress addr, Object hint);
-
- /**
- * Returns a messenger for the specified destination address.
- *
- * Behaves like {@link #getMessengerImmediate(EndpointAddress,Object)},
- * except that the invoker is blocked until the Messenger either resolves or
- * it is determined that no usable messenger can be created.
- *
- * @param addr The destination address.
- * @param hint A optional hint to be supplied to whichever transport ends-up
- * making the real messenger. May be {@code null}, when no hint applies.
- * @return A messenger for the specified destination address or {@code null}
- * if the destination address is not reachable.
- */
- public Messenger getMessenger(EndpointAddress addr, Object hint);
-
- /**
- * Creates and maps a canonical messenger to the specified destination.
- *
- * Behaves like {@link #getMessengerImmediate(EndpointAddress,Object)}
- * except that it returns a canonical messenger.
- *
- * The messenger is said to be canonical, because there is only one such
- * live object for any given destination address. The term "live",
- * here means that the messenger is not in any of the
- * {@link Messenger#TERMINAL} states as defined by {@link MessengerState}.
- * Therefore, for a given destination there may be any number of messengers
- * in a {@link Messenger#TERMINAL} state, but at most one in any other state.
- * As long as such an object exists, all calls to
- * {@code getCanonicalMessenger()} for the same address return this very
- * object.
- *
- * When first created, a canonical messenger is usually in the
- * {@link Messenger#UNRESOLVED} state. It becomes resolved by obtaining an
- * actual transport messenger to the destination upon the first attempt at
- * using it or when first forced to attempt resolution. Should resolution
- * fail at that point, it becomes {@link Messenger#UNRESOLVABLE}. Otherwise,
- * subsequent, failures are repaired automatically by obtaining a new
- * transport messenger when needed. If a failure cannot be repaired, the
- * messenger becomes {@link Messenger#BROKEN}.
- *
- * {@code getCanonicalMessenger()} is a recursive function.
- * Exploration of the parent endpoint is done automatically.
- *
- * Note 1: This method is the most fundamental messenger
- * instantiation method. It creates a different messenger for each variant
- * of destination address passed to the constructor. In general invokers
- * should use plain addresses; stripped of any service-specific destination.
- *
- * Note 2: The messengers that this method returns, are not
- * generally meant to be used directly. They provide a single queue for all
- * invokers, and do not perform group redirection and only support only a
- * subset of the {@code sendMessage()} methods. One must get a properly
- * configured channel in order to send messages.
- *
- * If one of the other {@code getMessenger()} methods fits the
- * application needs, it should be preferred.
- *
- * @param addr The destination address. It is recommended, though not
- * mandatory, that the address be stripped of its service name and service
- * param elements.
- * @param hint An object, of a type specific to the protocol of the address,
- * that may be provide additional information to the transport in
- * establishing the connection. Typically but not necessarily, this is a
- * route advertisement. If the transport cannot use the hint, or if it is
- * {@code null}, it will be ignored.
- * @return A Canonical messenger that obtains transport messengers to the
- * specified address, from LOCAL transports. Returns {@code null} if no
- * local transport handles this type address.
- */
- public Messenger getCanonicalMessenger(EndpointAddress addr, Object hint);
-
- /**
- * Removes the specified listener.
- *
- * @param listener The listener that would have been called.
- * @param priority Priority set from which to remove this listener.
- * @return true if the listener was removed, otherwise false.
- */
- public boolean removeMessengerEventListener(MessengerEventListener listener, int priority);
-
- /**
- * Adds the specified listener for all messenger creation.
- *
- * @param listener The listener that will be called.
- * @param priority Order of precedence requested (from 0 to 2). 2 has the
- * highest precedence. Listeners are called in decreasing order of
- * precedence. Listeners with equal precedence are called in an unspecified
- * order. There cannot be more than one listener object for a given
- * precedence. Redundant calls have no effect.
- * @return true if the listener was added, otherwise false.
- */
- public boolean addMessengerEventListener(MessengerEventListener listener, int priority);
-
- /**
- * Propagates (broadcasts) a message via all available Message Transports.
- * Each Message Transport that implements propagation will send the message
- * using it's broadcast functionality to a configured broadcast address. Any
- * peers in the same network scope listening on that broadcast address will
- * receive the propagated message.
- *
- * The message will be sent using the default TTL value (which is
- * unspecified).
- *
- * @param message The message to be propagated. The message will not be
- * modified by this method.
- * @param serviceName The name of the destination service.
- * @param serviceParam An optional parameter for the destination service or
- * {@code null}.
- * @throws IOException Thrown if the message could not be propagated.
- */
- public void propagate(Message message, String serviceName, String serviceParam) throws IOException;
-
- /**
- * Propagates (broadcasts) a message via all available Message Transports.
- * Each Message Transport that implements propagation will send the message
- * using it's broadcast functionality to a configured broadcast address. Any
- * peers in the same network scope listening on that broadcast address will
- * receive the propagated message.
- *
- * @param message The message to be propagated. The message will not be
- * modified by this method.
- * @param serviceName The name of the destination service.
- * @param serviceParam An optional parameter for the destination service or
- * {@code null}.
- * @param initialTTL The requested initial TTL for this message. The actual
- * TTL value used may be lower than this value but will never be higher.
- */
- public void propagate(Message message, String serviceName, String serviceParam, int initialTTL);
-
- /**
- * Verifies that the given address can be reached. The method, and accuracy
- * of the verification depends upon each Message Transport. In some cases
- * the address may be contacted to determine connectivity but this is not
- * guaranteed.
- *
- * @param addr is the Endpoint Address to ping.
- * @return {@code true} if the address can be reached otherwise {@code false}.
- * @deprecated The cost of performing this operation is generally the same
- * as getting a Messenger for the destination. Using {@code getMessenger()}
- * is a better approach because the resulting Messenger is generally needed
- * soon after ping.
- */
- @Deprecated
- public boolean ping(EndpointAddress addr);
-
- /**
- * Add a listener for the specified address.
- *
- * A single registered listener will be called for incoming messages
- * when (in order of preference) :
- * - The service name and service parameter match exactly to the
- * service name and service parameter specified in the destination
- * address of the message.
- *
- * - The service name matches exactly the service name from the
- * message destination address and service parameter is {@code null}.
- *
- *
- *
- * @param listener The listener which will be called when messages are
- * received for the registered destination.
- * @param serviceName The name of the service destination which will be
- * matched against incoming message destination endpoint addresses.
- * @param serviceParam An optional service parameter value which will be
- * matched against destination endpoint addresses. May be null.
- * @return true if the listener was registered, otherwise false.
- */
- public boolean addIncomingMessageListener(EndpointListener listener, String serviceName, String serviceParam);
-
- /**
- * Get the listener for the specified address.
- *
- * @param serviceName The service name to which the listener is registered.
- * @param serviceParam The service parameter to which the listener is
- * registered. May be {@code null}.
- * @return The currently registered listener or {@code null} if there is no
- * listener for the specified name and parameter.
- */
- public EndpointListener getIncomingMessageListener(String serviceName, String serviceParam);
-
- /**
- * Remove the listener for the specified address.
- *
- * @param serviceName The service name to which the listener is registered.
- * @param serviceParam The service parameter to which the listener is
- * registered. May be {@code null}.
- * @return The listener which was removed or {@code null} if there was
- * no listener for the specified name and parameter.
- */
- public EndpointListener removeIncomingMessageListener(String serviceName, String serviceParam);
-
- /**
- * Registers a message filter listener. Each message will be tested against
- * the list of filters as part of its sending or receiving.
- *
- * The listener is invoked for a message when:
- *
- * - The message contains a message element which matches exactly the
- * values specified by namespace and name.
- *
- * - The message contains a message element who's namespace value
- * matches exactly the specified namespace value and the specified name is
- * {@code null}.
- *
- * - The message contains a message element who's names value matches
- * exactly the specified name value and the specified namespace is
- * {@code null}.
- *
- * - The specified name value and the specified namespace are both
- * {@code null}.
- *
- *
- * @param listener The filter which will be called.
- * @param namespace Only messages containing elements of this namespace
- * which also match the 'name' parameter will be processed. {@code null}
- * may be use to specify all namespaces.
- * @param name only messages containing elements of this name which also
- * match the 'namespace' parameter will be processed. {@code null} may be
- * use to specify all names.
- */
- public void addIncomingMessageFilterListener(MessageFilterListener listener, String namespace, String name);
-
- /**
- * Registers a message filter listener. Each message will be tested against
- * the list of filters as part of its sending or receiving.
- *
- * The listener is invoked for a message when:
- *
- * - The message contains a message element which matches exactly the
- * values specified by namespace and name.
- *
- * - The message contains a message element who's namespace value
- * matches exactly the specified namespace value and the specified name is
- * {@code null}.
- *
- * - The message contains a message element who's names value matches
- * exactly the specified name value and the specified namespace is
- * {@code null}.
- *
- * - The specified name value and the specified namespace are both
- * {@code null}.
- *
- *
- * @param listener The filter which will be called.
- * @param namespace Only messages containing elements of this namespace
- * which also match the 'name' parameter will be processed. {@code null}
- * may be used to specify all namespaces.
- * @param name only messages containing elements of this name which also
- * match the 'namespace' parameter will be processed. {@code null} may be
- * use to specify all names.
- */
- public void addOutgoingMessageFilterListener(MessageFilterListener listener, String namespace, String name);
-
- /**
- * Removes the given listener previously registered under the given element
- * name
- *
- * @param listener the listener to remove
- * @param namespace the name space
- * @param name the name
- * @return the removed listener
- */
- public MessageFilterListener removeIncomingMessageFilterListener(MessageFilterListener listener, String namespace, String name);
-
- /**
- * Removes the given listener previously registered under the given element
- * name.
- *
- * @param listener the listener to remove
- * @param namespace the name space
- * @param name the name
- * @return the removed listener
- */
- public MessageFilterListener removeOutgoingMessageFilterListener(MessageFilterListener listener, String namespace, String name);
-
- /**
- * Delivers the provided message to the correct listener as specified by
- * the message's destination address.
- *
- * Two additional common message elements are optionally used by Message
- * Transports in conjunction with the Endpoint Service. Message Transports
- * may typically provide received messages to the Endpoint Service
- * containing these elements and the Endpoint service will dispatch the
- * messages based upon their content. Message Transports may use alternate
- * mechanisms for determining message source and destination addresses and
- * need not use these elements.
- *
- * The {@code jxta:EndpointSourceAddress} Message Element contains an
- * Endpoint Address for the source of this message. The source address has a
- * variety of meanings based upon the usage of the underlying Message
- * Transport. For low level transports such as TCP or HTTP the source
- * address is the return address of the peer from which the message was
- * received, ie. the hop address. For higher level Message Transports such
- * as the Endpoint Router Transport or the TLS transport the source address
- * is the virtual Endpoint Address of the peer which originated the message
- * regardless of any intervening hops the message may have made.
- *
- * The {@code jxta:EndpointDestinationAddress} Message Element contains an
- * Endpoint Address which will be used by the Endpoint Service to dispatch a
- * received message to the recipient specified by the service name and
- * service parameter. The protocol address is also provided to the recipient
- * service and can be used in some protocols for determining how the message
- * was received. For example a service may wish to handle messages which
- * were sent directly differently than messages which were sent via
- * propagation.
- *
- * @param msg The message to be delivered.
- * @deprecated Please convert your code to use the
- * {@link EndpointListener#processIncomingMessage(Message,EndpointAddress,EndpointAddress)}
- * method instead. The addressing method used by demux() was never part of
- * the formal JXTA protocol specification but was a defacto part because
- * demux() depended upon it.
- */
- @Deprecated
- public void demux(Message msg);
-
- /**
- * Adds the specified MessageTransport to this endpoint. A MessageTransport
- * may only be added if there are no other equivalent MessageTransports
- * available (as determined by {@link Object#equals(Object) equals()}).
- *
- * The MessageTransport becomes usable by the endpoint service to send
- * unicast messages and optionally propagation and ping messages if it is a
- * {@link net.jxta.endpoint.MessageSender}. The endpoint service becomes
- * usable by this MessageTransport to handle incoming messages if it is a
- * {@link MessageReceiver}.
- *
- * @param transport the MessageTransport to be installed.
- * @return A messenger event listener to invoke when incoming messengers are
- * created or {@code null} if the MessageTransport was not installed.
- */
- public MessengerEventListener addMessageTransport(MessageTransport transport);
-
- /**
- * Removes the given MessageTransport protocol from this endpoint service.
- *
- * Transports remove themselves from the list when stopped. This method
- * is normally only called from the stoppApp method of the transport. To
- * cleanly remove a transport, call the transport's
- * {@link net.jxta.platform.Module#stopApp() stopApp()}and allow it to call
- * this method.
- *
- * @param transpt the MessageTransport to be removed.
- * @return {@code true} if the Message Transport was removed, otherwise
- * {@code false}.
- */
- public boolean removeMessageTransport(MessageTransport transpt);
-
- /**
- * Get an iterator of the MessageTransports available to this
- * EndpointService.
- *
- * @return the iterator of all message transports.
- */
- public Iterator getAllMessageTransports();
-
- /**
- * Get a Message Transport by protocol name.
- *
- * @param name The protocol name of the MessageTransport.
- * @return The Message Transport for the specified protocol name or
- * {@code null} if there is no matching Message Transport
- */
- public MessageTransport getMessageTransport(String name);
-
- /**
- * Returns a Messenger that may be used to send messages via this endpoint
- * to the specified destination.
- *
- * @param addr the destination address.
- * @return The messenger or {@code null} is returned if the destination
- * address is not reachable.
- */
- public Messenger getMessenger(EndpointAddress addr);
-
- /**
- * Asynchronously acquire a messenger for the specified address. The
- * listener will be called when the messenger has been constructed.
- *
- * @param listener the listener to call when the messenger is ready.
- * @param addr the destination for the messenger.
- * @param hint the messenger hint, if any, otherwise null.
- * @return {@code true} if the messenger is queued for construction
- * otherwise {@code false}.
- * @deprecated This method is being phased out. Prefer one of the other
- * non-blocking variants. If a listener style paradigm is required, use
- * {@link ListenerAdaptor} which emulates this functionality.
- */
- @Deprecated
- public boolean getMessenger(MessengerEventListener listener, EndpointAddress addr, Object hint);
-
- /**
- * Returns a Direct Messenger that may be used to send messages via this endpoint to the specified destination.
- *
- * Direct messengers are non self destructive, they must be explicilty closed.
- *
- * @param addr the destination address.
- * @param hint the messenger hint, if any, otherwise null.
- * @param exclusive if true avoids caching the messenger
- * @return The messenger or {@code null} is returned if the destination address is not reachable.
- * @throws IllegalArgumentException if hint is not of RouteAdvertisement, or PeerAdvertisement type.
- */
- public Messenger getDirectMessenger(EndpointAddress addr, Object hint, boolean exclusive);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/InputStreamMessageElement.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/InputStreamMessageElement.java
deleted file mode 100644
index 16b30edc..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/InputStreamMessageElement.java
+++ /dev/null
@@ -1,325 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.endpoint;
-
-
-import net.jxta.document.MimeMediaType;
-
-import java.io.ByteArrayInputStream;
-import java.io.IOException;
-import java.io.InputStream;
-import java.io.OutputStream;
-import java.io.SequenceInputStream;
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.List;
-import java.util.zip.CRC32;
-import java.util.zip.Checksum;
-
-
-/**
- * A Message Element using {@link java.io.InputStream} as the source for the
- * element data. This implementation copies all of the data from the stream at
- * the time of creation.
- *
- * InputStreamMessageElement is not as efficient as other message element types
- * and should only be used when an input stream is the only available source for
- * the element data.
- */
-public class InputStreamMessageElement extends MessageElement {
-
- /**
- * The bytes of this element.
- */
- protected final List databytes;
-
- /**
- * The length of the data.
- */
- protected final long length;
-
- /**
- * Cached Hash Code
- */
- protected transient int cachedHashCode = 0;
-
- /**
- * Create a new MessageElement. This constructor copies the data as needed
- * and closes the stream upon completion.
- *
- * @param name Name of the MessageElement. May be the empty string ("") if
- * the MessageElement is not named.
- * @param type Type of the MessageElement. null is the same as specifying
- * the type "Application/Octet-stream".
- * @param in the stream containing the body of the MessageElement. The
- * stream will be closed by the MessageElement.
- * @param sig optional message digest/digital signature element or null if
- * no signature is desired.
- * @throws IOException If there is a problem reading from the source stream.
- */
- public InputStreamMessageElement(String name, MimeMediaType type, InputStream in, MessageElement sig) throws IOException {
- this(name, type, in, Long.MAX_VALUE, sig);
- }
-
- /**
- * Create a new Message Element.
- *
- * @param name Name of the MessageElement. May be the empty string ("") if
- * the MessageElement is not named.
- * @param type Type of the MessageElement. null is the same as specifying
- * the type "Application/Octet-stream".
- * @param in the stream containing the body of the MessageElement.
- * The stream will NOT be closed unless EOF is unexpectedly reached.
- * @param len The size of the Element will be limited to len bytes
- * from the stream. If you are using the stream interface and know
- * the size of the stream, specifying it here improves performance
- * and space efficiency a lot. The stream must contain at least
- * len bytes.
- * @param sig optional message digest/digital signature element or null if
- * no signature is desired.
- * @throws IOException if there is a problem reading from the source stream
- */
- public InputStreamMessageElement(String name, MimeMediaType type, InputStream in, long len, MessageElement sig) throws IOException {
- super(name, type, sig);
-
- if ((len < 0)) {
- throw new IllegalArgumentException("len must be >= 0");
- }
-
- // copy the data from the stream
- databytes = CopyToDataBytes(in, len);
-
- // calculate the length
- long buffersSum = 0;
- for (byte[] aBuffer : databytes) {
- buffersSum += aBuffer.length;
- }
-
- length = buffersSum;
-
- // fail if the length is not as promised.
- if ((len != Long.MAX_VALUE) && (len != length)) {
- throw new IllegalArgumentException("Stream was shorter than promised length.");
- }
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public boolean equals(Object target) {
- if (this == target) {
- return true;
- }
-
- if (target instanceof MessageElement) {
- if (!super.equals(target)) {
- return false;
- }
-
- if (target instanceof InputStreamMessageElement) {
- // have to do a slow stream comparison.
- // XXX 20020615 bondolo@jxta.org the performance of this could be much improved.
-
- MessageElement likeMe = (MessageElement) target;
-
- try {
- InputStream myStream = getStream();
- InputStream itsStream = likeMe.getStream();
-
- int mine;
- int its;
-
- do {
- mine = myStream.read();
- its = itsStream.read();
-
- if (mine != its) {
- return false;
- } // content didn't match
-
- } while ((-1 != mine) && (-1 != its));
-
- return ((-1 == mine) && (-1 == its)); // end at the same time?
- } catch (IOException fatal) {
- throw new IllegalStateException("MessageElements could not be compared." + fatal);
- }
- }
- }
-
- return false; // not a new message element
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public synchronized int hashCode() {
- if (0 == cachedHashCode) {
- Checksum crc = new CRC32();
-
- for (byte[] aBuffer : databytes) {
- crc.update(aBuffer, 0, aBuffer.length);
- }
-
- int result = super.hashCode() + (int) crc.getValue() * 6037; // a prime
-
- cachedHashCode = 0 != result ? result : 1;
- }
-
- return cachedHashCode;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public long getByteLength() {
- return length;
- }
-
- /**
- * {@inheritDoc}
- */
- public InputStream getStream() throws IOException {
- List buffers = new ArrayList();
-
- for (byte[] aBuffer : databytes) {
- buffers.add(new ByteArrayInputStream(aBuffer));
- }
-
- return new SequenceInputStream(Collections.enumeration(buffers));
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public void sendToStream(OutputStream sendTo) throws IOException {
- for (byte[] aBuffer : databytes) {
- sendTo.write(aBuffer);
- }
- }
-
- /**
- * Copy data from a stream with best possible efficiency. Unfortunately,
- * this still results in a lot of copying since we have often have no
- * fore-knowledge of the length of the stream.
- *
- * @param in the stream to copy from
- * @param limit the maximum number of bytes to copy from the stream.
- * Long.LONG_MAX will read until EOF.
- * @return A list of buffers.
- * @throws IOException if there is a problem reading from the stream.
- */
- protected List CopyToDataBytes(InputStream in, long limit) throws IOException {
- final long INITIAL_INTERMEDIATE_BUFFERSIZE = 6;
- final long MAXIMUM_INTERMEDIATE_BUFFERSIZE = 18;
-
- List buffs = new ArrayList();
- boolean atEOF = false;
- long read = 0;
- long currentIntermediateBufferSize = INITIAL_INTERMEDIATE_BUFFERSIZE;
-
- // build a list of buffers containing all the element data.
- do {
- long readRequest = (limit - read);
-
- if (Long.MAX_VALUE == limit) {
- readRequest = Math.min(readRequest, (1L << currentIntermediateBufferSize));
- }
- readRequest = Math.min(readRequest, Integer.MAX_VALUE); // limited by size of arrays which are Integer indexed.
-
- byte[] nextBuffer = new byte[(int) readRequest];
- int offsetInThisBuffer = 0;
-
- // fully read the buffer if we can.
- do {
- int readLength = in.read(nextBuffer, offsetInThisBuffer, nextBuffer.length - offsetInThisBuffer);
-
- if (readLength == -1) {
- atEOF = true;
- break;
- }
-
- offsetInThisBuffer += readLength;
- } while (offsetInThisBuffer < nextBuffer.length);
-
- // handle the final buffer.
- if (atEOF) {
- byte[] anotherBuffer = new byte[offsetInThisBuffer];
-
- System.arraycopy(nextBuffer, 0, anotherBuffer, 0, offsetInThisBuffer);
- nextBuffer = anotherBuffer;
- }
-
- read += nextBuffer.length;
- buffs.add(nextBuffer);
-
- if (currentIntermediateBufferSize < MAXIMUM_INTERMEDIATE_BUFFERSIZE) {
- currentIntermediateBufferSize++;
- }
- } while (!atEOF && (read < limit));
-
- // we are done, close if we are at EOF.
- if (atEOF) {
- in.close();
- in = null;
- }
- return buffs;
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/ListenerAdaptor.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/ListenerAdaptor.java
deleted file mode 100644
index 4ebc94e0..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/ListenerAdaptor.java
+++ /dev/null
@@ -1,481 +0,0 @@
-/*
- * Copyright (c) 2004-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.endpoint;
-
-import net.jxta.logging.Logging;
-import net.jxta.util.SimpleSelectable;
-import net.jxta.util.SimpleSelectable.IdentityReference;
-import net.jxta.util.SimpleSelector;
-
-import java.io.IOException;
-import java.util.ArrayList;
-import java.util.Collection;
-import java.util.HashMap;
-import java.util.Map;
-import java.util.concurrent.Executor;
-import java.util.logging.Level;
-import java.util.logging.Logger;
-
-/**
- * The legacy getMessenger asynchronous API never returns any object to the invoker until a messenger could actually be made,
- * allowing the application to supply a listener to be invoked when the operation completes. The legacy Messenger API also
- * provides a method to send messages that calls a listener to report the outcome of the operation.
- *
- * The model has changed, so that an asynchronous messenger is made unresolved and returned immediately to the invoker, which can
- * then request opening or even just send a message to force the opening. Subsequently, the messenger can be used as a control
- * block to monitor progress with {@link Messenger#register} and {@link Messenger#waitState}.
- *
- * Likewise, the outcome of sending a message is a property of that message. Messages can be selected to monitor property changes
- * with {@link Message#register} and {@link net.jxta.endpoint.Message#getMessageProperty(Object)} (the outcome property key is
- * Messenger.class).
- *
- * This class here provides the legacy listener model on top of the new model for applications that prefer listeners. This class
- * is used internally to emulate the legacy listener behaviour, so that applications do not need to be adapted.
- *
- * Note: one instance of this class gets instantiated by each EndpointService interface. However, it does not start using any
- * resources until it first gets used.
- */
-public class ListenerAdaptor implements Runnable {
-
- // FIXME - jice 20040413: Eventhough it is not as critical as it used to be we should get rid of old, never resolved entries.
- // Attempts are supposed to always fail or succeed rather soon. Here, we trust transports in that matter. Is it safe ?
-
- /**
- * Logger
- */
- private final static transient Logger LOG = Logger.getLogger(ListenerAdaptor.class.getName());
-
- /**
- * The in progress messages.
- */
- private final Map inprogress = new HashMap(32);
-
- /**
- * The thread that does the work.
- */
- private Thread bgThread = null;
-
- /**
- * The selector that we use to watch messengers progress.
- */
- private final SimpleSelector selector = new SimpleSelector();
-
- /**
- * Have we been shutdown?
- */
- private volatile boolean shutdown = false;
-
- /**
- * The exceutor service.
- */
- private final Executor executor;
-
- /**
- * The ThreadGroup in which this adaptor will run.
- */
- private final ThreadGroup threadGroup;
-
- /**
- * Standard Constructor
- *
- * @param threadGroup The ThreadGroup in which this adaptor will run.
- */
- public ListenerAdaptor(ThreadGroup threadGroup) {
- this(threadGroup, null);
- }
- /**
- * Creates a ListenerAdaptor with a threadpool for notification callback.
- *
- * @param threadGroup The ThreadGroup in which this adaptor will run.
- * @param executor the excutor to use for notification callback
- */
- public ListenerAdaptor(ThreadGroup threadGroup, Executor executor) {
- this.executor = executor;
- this.threadGroup = threadGroup;
- }
-
- /**
- * Cannot be re-started. Do not call once shutdown.
- */
- private synchronized void init() {
- assert !shutdown;
-
- if (bgThread != null) {
- return;
- }
-
- bgThread = new Thread(threadGroup, this, "Listener Adaptor");
- bgThread.setDaemon(true);
- bgThread.start();
- }
-
- public synchronized void shutdown() {
- shutdown = true;
-
- // Stop the thread if it was ever created.
- Thread bg = bgThread;
- if (bg != null) {
- bg.interrupt();
- }
- }
-
- /**
- * Stop watching a given selectable.
- *
- * @param ts the selectable
- */
- private void forgetSelectable(SimpleSelectable ts) {
- // Either way, we're done with this one.
- ts.unregister(selector);
-
- synchronized (this) {
- inprogress.remove(ts.getIdentityReference());
- }
- }
-
- /**
- * Select the given message and invoke the given listener when the message sending is complete.
- *
- * @param listener The listener to invoke. If null the resolution will take place, but obviously no listener will be invoked.
- * @param message The message being sent.
- * @return true if the message was registered successfully or the listener is null. If true it is guaranteed that the listener
- * will be invoked unless null. If false, it is guaranteed that the listener will not be invoked.
- */
- public boolean watchMessage(OutgoingMessageEventListener listener, Message message) {
- synchronized (this) {
- if (shutdown) {
- return false;
- }
-
- if (listener == null) {
- // We're done, then. The invoker does not really care.
- return true;
- }
-
- // Init if needed.
- init();
-
- // First we must ensure that if the state changes we'll get to handle it.
- MessageListenerContainer allListeners = (MessageListenerContainer) inprogress.get(message.getIdentityReference());
-
- if (allListeners == null) {
- allListeners = new MessageListenerContainer();
- inprogress.put(message.getIdentityReference(), allListeners);
- }
- allListeners.add(listener);
- }
-
- // When we do that, the selector gets notified. Therefore always check the initial state automatically. If the
- // selectable is already done with, the listener will be called by the selector's handler.
- message.register(selector);
-
- return true;
- }
-
- /**
- * Select the given messenger and invoke the given listener when the messenger is resolved.
- *
- * @param listener The listener to invoke. If null the resolution will take place, but obviously no listener will be invoked.
- * @param messenger The messenger being resolved.
- * @return true if the messenger was registered successfully or the listener is null. If true it is guaranteed that the listener
- * will be invoked unless null. If false, it is guaranteed that the listener will not be invoked.
- */
- public boolean watchMessenger(MessengerEventListener listener, Messenger messenger) {
- synchronized (this) {
-
- if (shutdown) {
- return false;
- }
-
- if (listener == null) {
- // We're done, then. The invoker does not really care.
- return true;
- }
-
- // Init if needed.
- init();
-
- // First we must ensure that if the state changes we'll get to handle it.
- MessengerListenerContainer allListeners = (MessengerListenerContainer) inprogress.get(messenger.getIdentityReference());
-
- if (allListeners == null) {
- // Use ArrayList. The code is optimized for that.
- allListeners = new MessengerListenerContainer();
- inprogress.put(messenger.getIdentityReference(), allListeners);
- }
- allListeners.add(listener);
- }
-
- // When we do that, the selector get notified. Therefore we will always check the initial state automatically. If the
- // selectable is already done with, the listener will be called by the selector's handler.
- messenger.register(selector);
-
- return true;
- }
-
- /*
- * Any sort of listener type.
- */
- static abstract class ListenerContainer extends ArrayList {
-
- public ListenerContainer() {
- super(1);
- }
-
- protected abstract void giveUp(S what, Throwable how);
-
- protected abstract void process(S what);
- }
-
-
- /**
- * For messages
- */
- @SuppressWarnings("serial")
- class MessageListenerContainer extends ListenerContainer {
-
- private void messageDone(Message message, OutgoingMessageEvent event) {
- // Note: synchronization is externally provided. When this method is invoked, this
- // object has already been removed from the map, so the list of listener cannot change.
-
- if (event == OutgoingMessageEvent.SUCCESS) {
- // Replace it with a msg-specific one.
- event = new OutgoingMessageEvent(message, null);
-
- for (OutgoingMessageEventListener eachListener : this) {
- try {
- eachListener.messageSendSucceeded(event);
- } catch (Throwable any) {
- if (Logging.SHOW_WARNING && LOG.isLoggable(Level.WARNING)) {
- LOG.log(Level.WARNING, "Uncaught throwable from listener", any);
- }
- }
- }
- } else {
- if (event == OutgoingMessageEvent.OVERFLOW) {
- // Replace it with a msg-specific one.
- event = new OutgoingMessageEvent(message, null);
- }
-
- for (OutgoingMessageEventListener eachListener : this) {
- try {
- eachListener.messageSendFailed(event);
- } catch (Throwable any) {
- if (Logging.SHOW_WARNING && LOG.isLoggable(Level.WARNING)) {
- LOG.log(Level.WARNING, "Uncaught throwable in listener", any);
- }
- }
- }
- }
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected void process(Message message) {
- OutgoingMessageEvent event = (OutgoingMessageEvent) message.getMessageProperty(Messenger.class);
-
- if (event == null) {
- return;
- }
-
- // Remove this container-selectable binding
- forgetSelectable(message);
-
- // Invoke app listeners
- messageDone(message, event);
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected void giveUp(Message m, Throwable how) {
- messageDone(m, new OutgoingMessageEvent(m, how));
- }
- }
-
- /**
- * For messengers
- */
- @SuppressWarnings("serial")
- class MessengerListenerContainer extends ListenerContainer {
-
- private void messengerDone(Messenger messenger) {
-
- // Note: synchronization is externally provided. When this method is invoked, this
- // object has already been removed from the map, so the list of listener cannot change.
-
- MessengerEvent event = new MessengerEvent(ListenerAdaptor.this, messenger, null);
-
- for (MessengerEventListener eachListener : this) {
- try {
- eachListener.messengerReady(event);
- } catch (Throwable any) {
- if (Logging.SHOW_WARNING && LOG.isLoggable(Level.WARNING)) {
- LOG.log(Level.WARNING, "Uncaught throwable in listener", any);
- }
- }
- }
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected void process(Messenger messenger) {
- if ((messenger.getState() & (Messenger.RESOLVED | Messenger.TERMINAL)) == 0) {
- return;
- }
-
- // Remove this container-selectable binding
- forgetSelectable(messenger);
-
- if ((messenger.getState() & Messenger.USABLE) == 0) {
- messenger = null;
- }
-
- // Invoke app listeners
- messengerDone(messenger);
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected void giveUp(Messenger m, Throwable how) {
- messengerDone(null);
- }
- }
-
- /**
- * {@inheritDoc}
- */
- public void run() {
- try {
- while (!shutdown) {
- try {
- Collection changed = selector.select();
- for (SimpleSelectable simpleSelectable : changed) {
- ListenerContainer listeners;
- synchronized (this) {
- listeners = inprogress.get(simpleSelectable.getIdentityReference());
- }
- if (listeners == null) {
- simpleSelectable.unregister(selector);
- continue;
- }
- if (executor == null) {
- listeners.process(simpleSelectable);
- } else {
- executor.execute(new ListenerProcessor(listeners, simpleSelectable));
- }
- }
- } catch (InterruptedException ie) {
- Thread.interrupted();
- }
- }
- } catch (Throwable anyOther) {
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE, "Uncaught Throwable in background thread", anyOther);
- }
-
- // There won't be any other thread. This thing is dead if that
- // happens. And it really shouldn't.
- synchronized (this) {
- shutdown = true;
- }
- } finally {
- try {
- // It's only us now. Stopped is true.
- IOException failed = new IOException("Endpoint interface terminated");
- for (Map.Entry entry : inprogress.entrySet()) {
- SimpleSelectable simpleSelectable = entry.getKey().getObject();
- ListenerContainer listeners = entry.getValue();
- simpleSelectable.unregister(selector);
-
- if (listeners != null) {
- listeners.giveUp(simpleSelectable, failed);
- }
- }
- inprogress.clear();
- } catch (Throwable anyOther) {
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE, "Uncaught Throwable while shutting down background thread", anyOther);
- }
- }
- bgThread = null;
- }
- }
-
- /**
- * A small class for processing individual messages.
- */
- private class ListenerProcessor implements Runnable {
-
- private SimpleSelectable simpleSelectable;
- private ListenerContainer listeners;
- ListenerProcessor(ListenerContainer listeners, SimpleSelectable simpleSelectable) {
- this.listeners = listeners;
- this.simpleSelectable = simpleSelectable;
- }
-
- public void run() {
- listeners.process(simpleSelectable);
- }
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/Message.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/Message.java
deleted file mode 100644
index 134699a8..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/Message.java
+++ /dev/null
@@ -1,1444 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.endpoint;
-
-import java.io.ObjectInputStream;
-import java.io.ObjectOutputStream;
-import java.io.PrintWriter;
-import java.io.Serializable;
-import java.io.StringWriter;
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.HashMap;
-import java.util.Iterator;
-import java.util.List;
-import java.util.ListIterator;
-import java.util.Map;
-
-import java.io.IOException;
-import java.util.ConcurrentModificationException;
-import java.util.NoSuchElementException;
-import java.util.concurrent.atomic.AtomicInteger;
-
-import java.util.logging.Level;
-import net.jxta.logging.Logging;
-import java.util.logging.Logger;
-
-import net.jxta.document.MimeMediaType;
-import net.jxta.util.AbstractSimpleSelectable;
-import net.jxta.util.SimpleSelectable;
-
-import net.jxta.impl.id.UUID.UUID;
-import net.jxta.impl.id.UUID.UUIDFactory;
-
-/**
- * Messages are abstract containers for protocol messages within JXTA. Services
- * and applications are expected to use Messages as the basis for any protocols
- * implemented within JXTA. Messages are exchanged through the
- * {@link net.jxta.endpoint.EndpointService} or
- * {@link net.jxta.pipe.PipeService}.
- *
- * A Message is composed of an ordered list of zero or more
- * {@link net.jxta.endpoint.MessageElement MessageElements}. Each
- * {@link net.jxta.endpoint.MessageElement} is associated with a namespace at
- * the time it is added to the message. Duplicate
- * {@link net.jxta.endpoint.MessageElement MessageElements} are permitted.
- *
- * Messages are not synchronized. All of the iterators returned by this
- * implementation are "fail-fast". Concurrent modification of messages from
- * multiple threads will produce unexpected results and
- * {@code ConcurrentModificationException}.
- *
- * @see net.jxta.endpoint.MessageElement
- * @see net.jxta.endpoint.EndpointAddress
- * @see net.jxta.endpoint.EndpointService
- * @see net.jxta.pipe.InputPipe
- * @see net.jxta.pipe.OutputPipe
- * @see net.jxta.pipe.PipeService
- */
-public class Message extends AbstractSimpleSelectable implements Serializable {
-
- /**
- * Logger
- */
- private static final transient Logger LOG = Logger.getLogger(Message.class.getName());
-
- /**
- * Magic value for this format of serialization version.
- */
- private static final long serialVersionUID = 3418026921074097757L;
-
- /**
- * If {@code true}, then modification logging be activated. This is a very
- * expensive option as it causes a stack crawl to be captured for every
- * message modification.
- *
- * To enable modification tracking, set to {@code true} and recompile.
- */
- protected static final boolean LOG_MODIFICATIONS = false;
-
- /**
- * If {@code true}, then a special tracking element is added to every
- * message. This provides the ability to follow messages throughout the
- * network. If a message has a tracking element then it will be used in
- * the {@code toString()} representation.
- *
- * The element is currently named "Tracking UUID" and is stored in the
- * "jxta" namespace. The element contains an IETF version 1 UUID in string
- * form.
- *
- * To enable addition of a tracking element to every message, set the
- * Java System Property {@code net.jxta.endpoint.Message.globalTracking} to
- * {@code true} and restart your JXTA application.
- *
- * @see java.lang.System#setProperty(String,String)
- */
- protected static final boolean GLOBAL_TRACKING_ELEMENT =
- Boolean.getBoolean(Message.class.getName() + ".globalTracking");
-
- /**
- * Incremented for each standalone message instance. {@see #lineage} for
- * information about how message numbers can be used.
- */
- private static transient AtomicInteger messagenumber = new AtomicInteger(1);
-
- /**
- * This string identifies the namespace which is assumed when calls are
- * made that don't include a namespace specification.
- */
- protected final String defaultNamespace;
-
- /**
- * the namespaces in this message and the elements in each.
- */
- protected transient Map> namespaces = new HashMap>();
-
- /**
- * List of the elements.
- */
- protected transient List elements = new ArrayList();
-
- /**
- * Message properties HashMap
- */
- protected transient Map properties = Collections.synchronizedMap(new HashMap());
-
- /**
- * A list of {@link java.lang.Integer} which details the lineage (history
- * of cloning) that produced this message. This message's number is index
- * 0, all of the ancestors are in order at higher indexes.
- *
- * Message numbers are not part of the message content and are only
- * stored locally. The are useful for following messages throughout their
- * lifetime and is normally shown as part of the toString()
- * display for Messages.
- */
- protected transient List lineage = new ArrayList();
-
- /**
- * Modification count of this message. Can be used to detect message being
- * concurrently modified when message is shared.
- *
- * The modification count is part of the {@code toString()} display for
- * Messages.
- */
- protected transient volatile int modCount = 0;
-
- /**
- * cached aggregate size of all the member elements. Used by
- * {@link #getByteLength()}
- */
- protected transient long cachedByteLength = 0;
-
- /**
- * modcount at the time the message length was last calculated. Used by
- * {@link #getByteLength()}
- */
- protected transient int cachedByteLengthModCount = -1;
-
- /**
- * If true then the message is modifiable. This is primarily
- * intended as a diagnostic tool for detecting concurrent modification.
- *
- * @deprecated You really should not depend on this feature.
- */
- @Deprecated
- public boolean modifiable = true;
-
- /**
- * If {@code LOG_MODIFICATIONS} is {@code true} then this will contain
- * the history of modifications this message.
- *
- *
- * - Values are {@link java.lang.Throwable} with the description
- * field formatted as
timeInAbsoluteMillis : threadName.
- *
- *
- */
- protected transient List modHistory;
-
- /**
- * A ListIterator for MessageElements which also provides the ability to
- * determine the namespace of the current message element. Message Elements
- * are iterated in the order in which they were added to the Message.
- *
- * This Iterator returned is not synchronized with the message. If you
- * modify the state of the Message, the iterator will throw
- * ConcurrentModificationException when {@code next()} or
- * {@code previous()} is called.
- */
- public class ElementIterator implements ListIterator {
-
- /**
- * The elements being iterated.
- */
- ListIterator list;
-
- /**
- * The current element
- */
- element current = null;
-
- /**
- * The modCount at the time when the iterator was created.
- */
- transient int origModCount;
-
- /**
- * Intialize the iterator from a list iterator.
- *
- * @param list The ListIterator we are managing.
- */
- ElementIterator(ListIterator list) {
- origModCount = Message.this.getMessageModCount();
- this.list = list;
- }
-
- /**
- * {@inheritDoc}
- */
- public boolean hasNext() {
- if (origModCount != Message.this.getMessageModCount()) {
- RuntimeException failure = new ConcurrentModificationException(
- Message.this + " concurrently modified. Iterator was made at mod " + origModCount);
-
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE,
- Message.this + " concurrently modified. iterator mod=" + origModCount + " current mod="
- + Message.this.getMessageModCount() + "\n" + getMessageModHistory(),
- failure);
- }
- throw failure;
- }
- return list.hasNext();
- }
-
- /**
- * {@inheritDoc}
- */
- public MessageElement next() {
- if (origModCount != Message.this.getMessageModCount()) {
- RuntimeException failure = new ConcurrentModificationException(
- Message.this + " concurrently modified. Iterator was made at mod " + origModCount);
-
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE,
- Message.this + " concurrently modified. iterator mod=" + origModCount + " current mod="
- + Message.this.getMessageModCount() + "\n" + getMessageModHistory(),
- failure);
- }
- throw failure;
- }
-
- current = list.next();
- return current.element;
- }
-
- /**
- * {@inheritDoc}
- */
- public int nextIndex() {
- return list.nextIndex();
- }
-
- /**
- * {@inheritDoc}
- */
- public boolean hasPrevious() {
- if (origModCount != Message.this.getMessageModCount()) {
- RuntimeException failure = new ConcurrentModificationException(
- Message.this + " concurrently modified. Iterator was made at mod " + origModCount);
-
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE,
- Message.this + " concurrently modified. iterator mod=" + origModCount + " current mod="
- + Message.this.getMessageModCount() + "\n" + getMessageModHistory(),
- failure);
- }
- throw failure;
- }
-
- return list.hasPrevious();
- }
-
- /**
- * {@inheritDoc}
- */
- public MessageElement previous() {
- if (origModCount != Message.this.getMessageModCount()) {
- RuntimeException failure = new ConcurrentModificationException(
- Message.this + " concurrently modified. Iterator was made at mod " + origModCount);
-
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE,
- Message.this + " concurrently modified. iterator mod=" + origModCount + " current mod="
- + Message.this.getMessageModCount() + "\n" + getMessageModHistory(),
- failure);
- }
- throw failure;
- }
-
- current = list.previous();
- return current.element;
- }
-
- /**
- * {@inheritDoc}
- */
- public int previousIndex() {
- return list.previousIndex();
- }
-
- /**
- * {@inheritDoc}
- *
- * Not provided because the namespace cannot be specified.
- */
- public void add(MessageElement obj) {
- throw new UnsupportedOperationException("add() not supported");
- }
-
- /**
- * {@inheritDoc}
- */
- public void remove() {
- if (origModCount != Message.this.getMessageModCount()) {
- RuntimeException failure = new ConcurrentModificationException(
- Message.this + " concurrently modified. Iterator was made at mod " + origModCount);
-
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE,
- Message.this + " concurrently modified. iterator mod=" + origModCount + " current mod="
- + Message.this.getMessageModCount() + "\n" + getMessageModHistory(),
- failure);
- }
-
- throw failure;
- }
-
- if (null == current) {
- throw new IllegalStateException("no current element, call next() or previous()");
- }
-
- ListIterator elsPosition = Message.this.elements.listIterator();
- ListIterator nsPosition = namespaces.get(current.namespace).listIterator();
-
- int currentPrevious = list.previousIndex();
-
- // restart this iterator
- while (list.previousIndex() >= 0) {
- list.previous();
- }
-
- // readvance to the current position, but track in ns list and master list
- while (list.previousIndex() < currentPrevious) {
- element anElement = list.next();
-
- try {
- // advance to the same element in the master list.
- element anElsElement;
-
- do {
- anElsElement = elsPosition.next();
- } while (anElement != anElsElement);
-
- // advance to the same element in the ns list.
- MessageElement anNsElement;
-
- if (current.namespace.equals(anElement.namespace)) {
- do {
- anNsElement = nsPosition.next();
- } while (anElement.element != anNsElement);
- }
- } catch (NoSuchElementException ranOut) {
- RuntimeException failure = new ConcurrentModificationException(
- Message.this + " concurrently modified. Iterator was made at mod " + origModCount);
-
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE,
- Message.this + " concurrently modified. iterator mod=" + origModCount + " current mod="
- + Message.this.getMessageModCount() + "\n" + getMessageModHistory(),
- failure);
- }
-
- throw failure;
- }
- }
-
- elsPosition.remove();
- nsPosition.remove();
- list.remove();
- origModCount = Message.this.incMessageModCount();
- if (Logging.SHOW_FINER && LOG.isLoggable(Level.FINER)) {
- LOG.finer(
- "Removed " + current.namespace + "::" + current.element.getElementName() + "/"
- + current.element.getClass().getName() + "@" + current.element.hashCode() + " from " + Message.this);
- }
- current = null;
- }
-
- /**
- * {@inheritDoc}
- *
- * Replacement MessageElement will be in the same name space as the
- * replaced element.
- */
- public void set(MessageElement obj) {
- if (origModCount != Message.this.getMessageModCount()) {
- RuntimeException failure = new ConcurrentModificationException(
- Message.this + " concurrently modified. ");
-
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE,
- Message.this + " concurrently modified. iterator mod=" + origModCount + " current mod="
- + Message.this.getMessageModCount() + "\n" + getMessageModHistory(),
- failure);
- }
- throw failure;
- }
-
- if (null == current) {
- throw new IllegalStateException("no current element, call next() or previous()");
- }
-
- ListIterator elsPosition = Message.this.elements.listIterator();
- ListIterator nsPosition = namespaces.get(current.namespace).listIterator();
-
- int currentPrevious = list.previousIndex();
-
- // restart this iterator
- while (list.previousIndex() >= 0) {
- list.previous();
- }
-
- // readvance to the current position, but track in ns list and master list
- while (list.previousIndex() < currentPrevious) {
- element anElement = list.next();
-
- try {
- // advance to the same element in the master list.
- element anElsElement;
-
- do {
- anElsElement = elsPosition.next();
- } while (anElement != anElsElement);
-
- // advance to the same element in the ns list.
- MessageElement anNsElement;
-
- if (current.namespace.equals(anElement.namespace)) {
- do {
- anNsElement = nsPosition.next();
- } while (anElement.element != anNsElement);
- }
- } catch (NoSuchElementException ranOut) {
- RuntimeException failure = new ConcurrentModificationException(
- Message.this + " concurrently modified. Iterator was made at mod " + origModCount);
-
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE,
- Message.this + " concurrently modified. iterator mod=" + origModCount + " current mod="
- + Message.this.getMessageModCount() + "\n" + getMessageModHistory(),
- failure);
- }
- throw failure;
- }
- }
-
- Message.element newCurrent = new Message.element(current.namespace, obj, null);
-
- elsPosition.set(newCurrent);
- nsPosition.set(obj);
- list.set(newCurrent);
- origModCount = Message.this.incMessageModCount();
- if (Logging.SHOW_FINER && LOG.isLoggable(Level.FINER)) {
- LOG.finer(
- "Replaced " + current.namespace + "::" + current.element.getElementName() + "/"
- + current.element.getClass().getName() + "@" + current.element.hashCode() + " with "
- + newCurrent.namespace + "::" + newCurrent.element.getElementName() + "/"
- + newCurrent.element.getClass().getName() + "@" + newCurrent.element.hashCode() + " in " + Message.this);
- }
- current = newCurrent;
- }
-
- /**
- * return the namespace of the current element.
- *
- * @return String containing the name space of the current element.
- */
- public String getNamespace() {
- if (null == current) {
- throw new IllegalStateException("no current element, call next() or previous()");
- }
-
- return current.namespace;
- }
-
- /**
- * Return the signature element of the current element.
- *
- * @return The signature element of the current element.
- */
- public MessageElement getSignature() {
- if (null == current) {
- throw new IllegalStateException("no current element, call next() or previous()");
- }
-
- return (null != current.signature) ? current.signature : current.element.getSignature();
- }
- }
-
-
- /**
- * Holds an element, its namespace and optionally an override signature
- * element.
- */
- protected static class element {
- final String namespace;
- final MessageElement element;
- final MessageElement signature;
-
- element(String namespace, MessageElement element, MessageElement signature) {
- this.namespace = namespace;
- this.element = element;
- this.signature = signature;
- }
- }
-
- /**
- * Standard Constructor for messages. The default namespace will be the
- * empty string ("")
- */
- public Message() {
- this("", false);
- }
-
- /**
- * Standard Constructor for messages.
- *
- * @param defaultNamespace the namespace which is assumed by methods which
- * do not require a namespace specification.
- */
- protected Message(String defaultNamespace) {
- this(defaultNamespace, false);
- }
-
- /**
- * Standard Constructor for messages.
- *
- * @param defaultNamespace the namespace which is assumed by methods which
- * do not require a namespace specification.
- * @param clone If {@code true} then we are creating a clone.
- */
- private Message(String defaultNamespace, boolean clone) {
- this.defaultNamespace = defaultNamespace;
-
- lineage.add(messagenumber.getAndIncrement());
-
- if (LOG_MODIFICATIONS) {
- modHistory = new ArrayList();
- incMessageModCount();
- }
-
- if (!clone && GLOBAL_TRACKING_ELEMENT) {
- UUID tracking = UUIDFactory.newSeqUUID();
-
- MessageElement trackingElement = new StringMessageElement("Tracking UUID", tracking.toString(), null);
-
- addMessageElement("jxta", trackingElement);
- }
- }
-
- /**
- * {@inheritDoc}
- *
- * Duplicates the Message. The returned duplicate is a real copy. It may
- * be freely modified without causing change to the originally cloned
- * message.
- *
- * @return Message a Message that is a copy of the original message
- */
- @Override
- public Message clone() {
- Message clone = new Message(getDefaultNamespace(), true );
-
- clone.lineage.addAll(lineage);
- clone.elements.addAll(elements);
-
- for (String aNamespace : namespaces.keySet()) {
- List namespaceElements = namespaces.get(aNamespace);
-
- List newNamespaceElements = new ArrayList(namespaceElements.size());
-
- newNamespaceElements.addAll(namespaceElements);
- clone.namespaces.put(aNamespace, newNamespaceElements);
- }
-
- if (Logging.SHOW_FINER && LOG.isLoggable(Level.FINER)) {
- LOG.finer("Created clone " + clone + " of " + this);
- }
-
- return clone;
- }
-
- /**
- * {@inheritDoc}
- *
- * Compare this Message against another. Returns {@code true} if all of the
- * elements are identical and in the same order. Message properties
- * (setProperty()/getProperty()) are not considered in the calculation.
- *
- * @param target The Message to compare against.
- * @return {@code true} if the elements are identical otherwise
- * {@code false}.
- */
- @Override
- public boolean equals(Object target) {
- if (this == target) {
- return true;
- }
-
- if (target instanceof Message) {
- Message likeMe = (Message) target;
-
- ElementIterator myElements = getMessageElements();
- ElementIterator itsElements = likeMe.getMessageElements();
-
- while (myElements.hasNext()) {
- if (!itsElements.hasNext()) {
- return false; // it has fewer than i do.
- }
-
- MessageElement mine = myElements.next();
- MessageElement its = itsElements.next();
-
- if (!myElements.getNamespace().equals(itsElements.getNamespace())) {
- return false; // elements not in the same namespace
- }
-
- if (!mine.equals(its)) {
- return false; // content didnt match
- }
- }
-
- return (!itsElements.hasNext()); // ran out at the same time?
- }
-
- return false; // not a message
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public int hashCode() {
- int result = 0;
- Iterator eachElement = getMessageElements();
-
- while (eachElement.hasNext()) {
- MessageElement anElement = eachElement.next();
-
- result += anElement.hashCode();
- result *= 6037; // a prime
- }
-
- if (0 == result) {
- result = 1;
- }
-
- return result;
- }
-
- /**
- * {@inheritDoc}
- *
- * This implementation is intended to assist debugging. You should not
- * depend upon the format of the result.
- */
- @Override
- public String toString() {
- StringBuilder toString = new StringBuilder(128);
-
- toString.append(getClass().getName());
- toString.append('@');
- toString.append(super.hashCode());
- toString.append('(');
- toString.append(modCount);
- toString.append("){");
-
- Iterator allLineage = getMessageLineage();
-
- while (allLineage.hasNext()) {
- toString.append(allLineage.next().toString());
- if (allLineage.hasNext()) {
- toString.append(',');
- }
- }
-
- toString.append('}');
-
- if (GLOBAL_TRACKING_ELEMENT) {
- toString.append("[");
- Iterator eachUUID = getMessageElements("jxta", "Tracking UUID");
-
- while (eachUUID.hasNext()) {
- toString.append("[");
- toString.append(eachUUID.next().toString());
- toString.append("]");
- if (eachUUID.hasNext()) {
- toString.append(',');
- }
- }
- toString.append("]");
- }
-
- return toString.toString();
- }
-
- /**
- * Read this Object in for Java Serialization
- *
- * @param s The stream from which the Object will be read.
- * @throws IOException for errors reading from the input stream.
- * @throws ClassNotFoundException if the serialized representation contains
- * references to classes which cannot be found.
- */
- private void readObject(ObjectInputStream s) throws IOException, ClassNotFoundException {
- // reads defaultNamespace, modifiable flag
- s.defaultReadObject();
-
- MimeMediaType readType = new MimeMediaType(s.readUTF());
-
- // XXX bondolo 20040307 Should do something with encoding here.
-
- Message readMessage = WireFormatMessageFactory.fromWire(s, readType, null);
-
- namespaces = readMessage.namespaces;
- elements = readMessage.elements;
-
- if (!namespaces.containsKey(defaultNamespace)) {
- throw new IOException("Corrupted Object--does not contain required namespace.");
- }
-
- properties = new HashMap();
- lineage = new ArrayList();
-
- lineage.add(messagenumber.getAndIncrement());
-
- if (LOG_MODIFICATIONS) {
- modHistory = new ArrayList();
- incMessageModCount();
- }
- }
-
- /**
- * Write this Object out for Java Serialization
- *
- * @param s The stream to which the Object will be written.
- * @throws IOException for errors writing to the output stream.
- */
- private void writeObject(ObjectOutputStream s) throws IOException {
- s.defaultWriteObject();
-
- MimeMediaType writeType = WireFormatMessageFactory.DEFAULT_WIRE_MIME;
-
- s.writeUTF(writeType.toString());
-
- // XXX bondolo 20040307 Should do something with encoding here.
-
- WireFormatMessage serialed = WireFormatMessageFactory.toWire(this, writeType, null);
-
- serialed.sendToStream(s);
- }
-
- /**
- * Return the default Namespace of this message.
- *
- * @return The default namespace for this message.
- */
- protected String getDefaultNamespace() {
- return defaultNamespace;
- }
-
- /**
- * Add a MessageElement into the message. The MessageElement is stored in
- * the default namespace.
- *
- * @param add the Element to add to the message.
- */
- public void addMessageElement(MessageElement add) {
-
- addMessageElement(null, add);
- }
-
- /**
- * Add a MessageElement into the message using the specified namespace.
- *
- * @param namespace contains the namespace of the element to add. You can
- * specify null as a shorthand for the default namespace.
- * @param add the MessageElement to add to the message.
- */
- public void addMessageElement(String namespace, MessageElement add) {
- addMessageElement(namespace, add, null);
- }
-
- /**
- * Add a MessageElement into the Message using the specified namespace.
- *
- * @param namespace contains the namespace of the element to add. You can
- * specify null as a shorthand for the default namespace.
- * @param add the MessageElement to add to the message.
- * @param signature The signature MessageElement associated with the
- * MessageElement. This allows for an alternate signature element to the
- * signature element associated with the message element.
- */
- public void addMessageElement(String namespace, MessageElement add, MessageElement signature) {
- if (null == namespace) {
- namespace = getDefaultNamespace();
- }
-
- if (null == add) {
- throw new IllegalArgumentException("Message Element must be non-null");
- }
-
- elements.add(new element(namespace, add, signature));
-
- List namespaceElements = namespaces.get(namespace);
-
- if (null == namespaceElements) {
- namespaceElements = new ArrayList();
- namespaces.put(namespace, namespaceElements);
- }
-
- namespaceElements.add(add);
- incMessageModCount();
- if (Logging.SHOW_FINER && LOG.isLoggable(Level.FINER)) {
- LOG.finer( "Added " + namespace + "::" + add.getElementName() + "/" +
- add.getClass().getName() + "@" + add.hashCode() + " to " + this);
- }
- }
-
- /**
- * Replace a {@link net.jxta.endpoint.MessageElement} in the message. This
- * method will remove all MessageElement instances in the default namespace
- * which match the specified name (if any) and then insert the replacement
- * element. The existing version of the element is returned, if more than
- * one matching element was removed, a random matching element is returned.
- *
- * For greatest control over element replacement, use the
- * {@link java.util.ListIterator#set(java.lang.Object)} method as returned
- * by {@link #getMessageElements()},
- * {@link #getMessageElements(java.lang.String)} or
- * {@link #getMessageElementsOfNamespace(java.lang.String)}
- *
- * @param replacement the Element to be inserted into to the message.
- * @return One of the elements which was replaced or null if no existing
- * matching item was located.
- */
- public MessageElement replaceMessageElement(MessageElement replacement) {
- return replaceMessageElement(null, replacement);
- }
-
- /**
- * Replace a {@link net.jxta.endpoint.MessageElement} in the message using the specified
- * namespace. This method will remove all MessageElement instances which
- * match the specified name (if any) and then insert the replacement
- * element. The existing version of the element is returned, if more than
- * one matching element was removed, a random matching element is returned.
- *
- * For greatest control over element replacement, use the
- * {@link java.util.ListIterator#set(java.lang.Object)} method as returned
- * by {@link #getMessageElements()},
- * {@link #getMessageElements(java.lang.String)} or
- * {@link #getMessageElementsOfNamespace(java.lang.String)}
- *
- * @param namespace contains the namespace of the element to be replaced.
- * You can specify null as a shorthand for the default namespace.
- * @param replacement the Element to be inserted into to the message.
- * @return One of the elements which was replaced or null if no existing
- * matching item was located.
- */
- public MessageElement replaceMessageElement(String namespace, MessageElement replacement) {
- if (null == namespace) {
- namespace = getDefaultNamespace();
- }
-
- if (null == replacement) {
- throw new IllegalArgumentException("Message Element must be non-null");
- }
-
- MessageElement removed = null;
- Iterator allMatching = getMessageElements(namespace, replacement.getElementName());
-
- while (allMatching.hasNext()) {
- MessageElement anElement = allMatching.next();
-
- allMatching.remove();
- removed = anElement;
- }
-
- addMessageElement(namespace, replacement); // updates mod count
-
- return removed;
- }
-
- /**
- * Returns an iterator of the namespaces present in this message.
- *
- * @return iterator of strings of the namespaces of this message.
- */
- public Iterator getMessageNamespaces() {
- return Collections.unmodifiableMap(namespaces).keySet().iterator();
- }
-
- /**
- * Retrieve a message element by name from the message without regard to
- * namespace. If there is more than one message element with this name, the
- * first message element will be returned.
- *
- * @param name The name of the message element to attempt to retrieve.
- * @return Element the element or null if no matching element could be
- * found.
- */
- public MessageElement getMessageElement(String name) {
- Iterator eachElement = elements.listIterator();
-
- while (eachElement.hasNext()) {
- element anElement = eachElement.next();
-
- if (name.equals(anElement.element.getElementName())) {
- return anElement.element;
- }
- }
-
- return null;
- }
-
- /**
- * Retrieve a message element by name in the specified namespace from the
- * message. If there is more than one message element matching this name,
- * the first message element will be returned.
- *
- * @param namespace contains the namespace of the element to get. You can
- * specify {@code null} as a shorthand for the default namespace.
- * @param name The name of the message element to retrieve.
- * @return The Message Element or {@code null} if no matching message
- * element could be found.
- */
- public MessageElement getMessageElement(String namespace, String name) {
- if (null == namespace) {
- namespace = getDefaultNamespace();
- }
-
- List namespaceElements = namespaces.get(namespace);
-
- // no namespace means no element.
- if (null == namespaceElements) {
- return null;
- }
-
- Iterator eachElement = namespaceElements.listIterator();
-
- while (eachElement.hasNext()) {
- MessageElement anElement = eachElement.next();
-
- if (name.equals(anElement.getElementName())) {
- return anElement;
- }
- }
-
- return null;
- }
-
- /**
- * Returns a list iterator of all of the elements contained in this message.
- * Elements from all namespaces are returned.
- *
- * The iterator returned is not synchronized with the message and will
- * throw {@link java.util.ConcurrentModificationException} if the
- * message is modified.
- *
- * @return Enumeration of Elements.
- */
- public ElementIterator getMessageElements() {
- List theMsgElements = new ArrayList(elements);
-
- return new ElementIterator(theMsgElements.listIterator());
- }
-
- /**
- * Returns a list iterator of all of the elements contained in this
- * message who's name matches the specified name. Elements from all
- * namespaces are returned. Message Elements are iterated in the order in
- * which they were added to the Message.
- *
- * The iterator returned is not synchronized with the message and will
- * throw {@link java.util.ConcurrentModificationException} if the
- * message is modified.
- *
- * @param name the name of the elements to match against
- * @return iterator of the elements matching the specified name, if any.
- */
- public ElementIterator getMessageElements(String name) {
- List theMsgElements = new ArrayList(elements.size());
-
- for (element anElement : elements) {
- if (name.equals(anElement.element.getElementName())) {
- theMsgElements.add(anElement);
- }
- }
-
- return new ElementIterator(theMsgElements.listIterator());
- }
-
- /**
- * Returns a list iterator of all of the elements contained in this message
- * which match the specified namespace. Message Elements are iterated in
- * the order in which they were added to the Message.
- *
- * The ListIterator returned is not synchronized with the message. If
- * you modify the state of the Message, the iterator will throw
- * ConcurrentModificationException when {@code next()} or
- * {@code previous()} is called.
- *
- * @param namespace contains the namespace which must be matched in the
- * elements returned. You can specify {@code null} as a shorthand for the
- * default namespace.
- * @return Iterator of Message Elements matching namespace.
- */
- public ElementIterator getMessageElementsOfNamespace(String namespace) {
- List theMsgElements = new ArrayList(elements.size());
-
- if (null == namespace) {
- namespace = getDefaultNamespace();
- }
-
- for (element anElement : elements) {
- if (namespace.equals(anElement.namespace)) {
- theMsgElements.add(anElement);
- }
- }
-
- return new ElementIterator(theMsgElements.listIterator());
- }
-
- /**
- * Returns a list iterator of all of the elements contained in the
- * specified namespace who's name matches the specified name in the order
- * in which they were added to the Message.
- *
- * The iterator returned is not synchronized with the message and will
- * throw {@link java.util.ConcurrentModificationException} if the message
- * is modified.
- *
- * @param namespace The namespace which must be matched in the elements
- * returned. You can specify {@code null} as a shorthand for the default
- * namespace.
- * @param name The name of the elements to retrieve.
- * @return Iterator of Message Elements matching namespace and name.
- */
- public ElementIterator getMessageElements(String namespace, String name) {
- List theMsgElements = new ArrayList(elements.size());
-
- if (null == namespace) {
- namespace = getDefaultNamespace();
- }
-
- for (element anElement : elements) {
- if (namespace.equals(anElement.namespace) && name.equals(anElement.element.getElementName())) {
- theMsgElements.add(anElement);
- }
- }
-
- return new ElementIterator(theMsgElements.listIterator());
- }
-
- /**
- * Returns a list iterator of all of the elements contained in this message
- * whose mime-type matchs the given in the order they were added to the
- * message. Elements from all namespaces are returned.
- *
- * The iterator returned is not synchronized with the message and will
- * throw {@link java.util.ConcurrentModificationException} if the
- * message is modified.
- *
- * @param type contains the type of the elements to get
- * @return Iterator of Message Elements matching type.
- */
- public ElementIterator getMessageElements(MimeMediaType type) {
- List theMsgElements = new ArrayList(elements.size());
-
- ListIterator eachElement = elements.listIterator();
-
- while (eachElement.hasNext()) {
- element anElement = eachElement.next();
-
- if (type.equals(anElement.element.getMimeType())) {
- theMsgElements.add(anElement);
- }
- }
-
- return new ElementIterator(theMsgElements.listIterator());
- }
-
- /**
- * Returns a list iterator of all of the elements contained in this message
- * whose type matches the given in the order they were added to the message.
- *
- * The iterator returned is not synchronized with the message and will
- * throw {@link java.util.ConcurrentModificationException} if the
- * message is modified.
- *
- * @param namespace contains the namespace which must be matched in the
- * elements returned. You can specify null as a shorthand for the default
- * namespace.
- * @param type contains the type of the elements to get
- * @return Iterator of Message Elements matching namespace and matching
- * type.
- */
- public ElementIterator getMessageElements(String namespace, MimeMediaType type) {
- List theMsgElements = new ArrayList(elements.size());
-
- if (null == namespace) {
- namespace = getDefaultNamespace();
- }
-
- for (element anElement : elements) {
- if (namespace.equals(anElement.namespace) && type.equals(anElement.element.getMimeType())) {
- theMsgElements.add(anElement);
- }
- }
-
- return new ElementIterator(theMsgElements.listIterator());
- }
-
- /**
- * Remove an the first occurrence of the provided MessageElement from the
- * message.
- *
- * @param remove the Element to remove from the message.
- * @return boolean returns true if the element was removed, otherwise false.
- */
- public boolean removeMessageElement(MessageElement remove) {
- Iterator eachElement = getMessageElements();
-
- while (eachElement.hasNext()) {
- MessageElement anElement = eachElement.next();
-
- if (remove == anElement) {
- eachElement.remove(); // updates mod count
-
- return true;
- }
- }
-
- return false;
- }
-
- /**
- * Remove the first occurrence of the provided MessageElement within the
- * specified namespace from the message. You can specify null as a
- * shorthand for the default namespace.
- *
- * @param namespace the namespace from which the element is to be removed.
- * @param remove the Element to remove from the message.
- * @return boolean returns true if the element was removed, otherwise false.
- */
- public boolean removeMessageElement(String namespace, MessageElement remove) {
- Iterator eachElement = getMessageElementsOfNamespace(namespace);
-
- while (eachElement.hasNext()) {
- MessageElement anElement = eachElement.next();
-
- if (remove == anElement) {
- eachElement.remove(); // updates mod count
-
- return true;
- }
- }
-
- return false;
- }
-
- /**
- * Removes all of the elements in all namespaces from the message. Also
- * clears any properties set for this message.
- */
- public void clear() {
- elements.clear();
- namespaces.clear();
- properties.clear();
- // a cleared message has no ancestors
- lineage.retainAll(Collections.singletonList(lineage.get(0)));
-
- incMessageModCount();
-
- if (Logging.SHOW_FINER && LOG.isLoggable(Level.FINER)) {
- LOG.finer("Cleared " + this);
- }
- }
-
- /**
- * Returns the aggregate size of all the member elements.
- *
- * @return the sum of all element sizes in bytes.
- */
- public synchronized long getByteLength() {
- if (modCount != cachedByteLengthModCount) {
- cachedByteLength = 0;
- Iterator eachElement = getMessageElements();
-
- while (eachElement.hasNext()) {
- MessageElement anElement = eachElement.next();
-
- cachedByteLength += anElement.getByteLength();
- }
-
- cachedByteLengthModCount = modCount;
- }
-
- return cachedByteLength;
- }
-
- /**
- * Returns the modification count of this message. This ever ascending
- * number can be used to determine if the message has been modified by
- * another thread or for use in caching of parts of the message structure.
- *
- * @return the modification count of this message.
- */
- public int getMessageModCount() {
- return modCount;
- }
-
- /**
- * Returns the modification count of this message. This ever ascending
- * number can be used to determine if the message has been modified by
- * another thread or for use in caching of parts of the message structure.
- *
- * @return the modification count of this message.
- */
- protected synchronized int incMessageModCount() {
- modCount++;
-
- if (LOG_MODIFICATIONS) {
- modHistory.add(new Throwable(Long.toString(System.currentTimeMillis()) + " : " + Thread.currentThread().getName()));
- }
-
- if (!modifiable) {
- IllegalStateException failure = new IllegalStateException("Unmodifiable message should not have been modified");
-
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE, failure.getMessage(), failure);
- }
- throw failure;
- }
-
- if (Logging.SHOW_FINER && LOG.isLoggable(Level.FINER)) {
- LOG.finer("Modification to " + this);
- }
-
- return modCount;
- }
-
- /**
- * Returns a String containing the modification history for this message
- *
- * @return a String containing the modification history for this message.
- */
- public synchronized String getMessageModHistory() {
-
- if (LOG_MODIFICATIONS) {
- StringBuilder modHistoryStr = new StringBuilder("Message Modification History for ");
-
- modHistoryStr.append(toString());
- modHistoryStr.append("\n\n");
- for (int eachMod = modHistory.size() - 1; eachMod >= 0; eachMod--) {
- StringWriter aStackStr = new StringWriter();
- Throwable aStack = modHistory.get(eachMod);
-
- aStack.printStackTrace(new PrintWriter(aStackStr));
- modHistoryStr.append("Modification #");
- modHistoryStr.append(eachMod + 1);
- modHistoryStr.append(":\n\n");
- modHistoryStr.append(aStackStr.toString());
- modHistoryStr.append("\n");
- }
- return modHistoryStr.toString();
- } else {
- return "Modification history tracking is disabled";
- }
- }
-
- /**
- * Returns the message number of this message. Message Numbers are intended
- * to assist with debugging and the management of message cloning.
- *
- * Each message is assigned a unique number upon creation. Message
- * Numbers are monotonically increasing for each message created.
- *
- * Message Numbers are transient, ie. if the message object is
- * serialized then the message number after deserialization will be
- * probably be a different value. Message numbers should not be used to
- * record permanent relationships between messages.
- *
- * @return int this message's message number.
- */
- public int getMessageNumber() {
- return lineage.get(0);
- }
-
- /**
- * Returns an iterator which describes the lineage of this message. Each
- * entry is an {@link java.lang.Integer} Message Number. The first entry is
- * this message's number, following entries are the ancestors of this
- * message.
- *
- * @return an Iterator of {@link java.lang.Integer}. Each entry is a
- * message number.
- */
- public Iterator getMessageLineage() {
- return Collections.unmodifiableList(lineage).iterator();
- }
-
- /**
- * Associate a transient property with this message. if there was a
- * previous value for the key provided then it is returned. This feature is
- * useful for managing the state of messages during processing and for
- * caching. Message Properties are not transmitted as part of the
- * Message when the message is serialized!
- *
- * The setting of particular keys may be controlled by a Java Security
- * Manager. Keys of type 'java.lang.Class' are checked against the caller of
- * this method. Only callers which are instances of the key class may modify
- * the property. This check is not possible through reflection. All other
- * types of keys are unchecked.
- *
- * @param key the property key
- * @param value the value for the property
- * @return previous value for the property or null if no previous
- */
- public Object setMessageProperty(Object key, Object value) {
-
- /*
- if( key instanceof java.lang.Class ) {
- Class keyClass = (Class) key;
- SecurityManager secure = new SecurityManager() {
- public boolean checkCallerOfClass( Class toCheck ) {
- Class [] context = getClassContext();
-
- return toCheck.isAssignableFrom( context[2] );
- }
- };
-
- if( !secure.checkCallerOfClass( keyClass ) ) {
- throw new SecurityException( "You can't set that key from this context." );
- }
- }
- */
-
- Object res = properties.put(key, value);
-
- // Any property addition (including redundant) is notified. Removals are
- // too, since removal is done by assigning null.
-
- // Exception: when removing what was not there: no notification.
-
- if (res != null || value != null) {
- notifyChange();
- }
-
- return res;
- }
-
- /**
- * Retrieves a transient property from the set for this message.
- *
- * @param key the property key.
- * @return value for the property or null if no property for this key.
- */
- public Object getMessageProperty(Object key) {
-
- return properties.get(key);
- }
-
- /**
- * {@inheritDoc}
- */
- public void itemChanged(SimpleSelectable o) {// For now, messages are not themselves registered with anything.
- // Therefore itemChanged does not do a thing.
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessageElement.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessageElement.java
deleted file mode 100644
index 5c004c97..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessageElement.java
+++ /dev/null
@@ -1,567 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.endpoint;
-
-
-import java.io.DataInput;
-import java.io.DataInputStream;
-import java.io.IOException;
-import java.io.InputStream;
-import java.io.InputStreamReader;
-import java.io.OutputStream;
-import java.io.Reader;
-import java.lang.ref.SoftReference;
-import java.util.HashMap;
-import java.util.Map;
-
-import java.io.UnsupportedEncodingException;
-import java.util.UUID;
-
-import java.util.logging.Level;
-import net.jxta.logging.Logging;
-import java.util.logging.Logger;
-
-import net.jxta.document.Document;
-import net.jxta.document.MimeMediaType;
-import net.jxta.util.CountingOutputStream;
-import net.jxta.util.DevNullOutputStream;
-
-// imported for implementation of {@link #getSequentialName()}
-import net.jxta.impl.id.UUID.UUIDFactory;
-
-
-/**
- * JXTA Message Elements are used to add data to a JXTA Message. Message
- * Elements are immutable objects. A Message Element may be shared amongst as
- * many messages as is desired.
- *
- * Several Message Element sub-classes are provided for handling various types
- * of data. All Message Elements are internally converted to raw bytes when sent
- * as part of a Message. The various Message Element flavors are provided for
- * convenience and efficiency. They enable the simplest creation and most
- * efficient conversion from the individual data types to the appropriate binary
- * data. Because Message Elements are merely a convenient representation for
- * binary data the object type of Message Element received by a peer may not
- * be the same as was sent by the sending peer. Even though the Message
- * Element container may change during transmission the data contained in the
- * Message Element is faithfully preserved.
- *
- * A Message Element is composed of four components:
- *
- *
- * - An optional name. This may be any {@link java.lang.String}. Unnamed
- * elements are assumed to have the name "" (the empty string).
- * - An optional {@link net.jxta.document.MimeMediaType}. If not specified
- * the Mime Media Type is assumed to be "Application/Octet-Stream".
- * - Data. Sub-classes of MessageElement allow you to create elements based
- * on a variety of data formats.
- * - An optional signature. This is a Message Element that is associated to
- * this element and may contain a cryptographic signature/hash of this message
- * element.
- *
- *
- *
- * The data contained within a MessageElement is accessible in four ways:
- *
- *
- * - As an {@link java.io.InputStream} from {@link #getStream()}
- * - Sending the data a {@link java.io.OutputStream} via {@link #sendToStream(OutputStream)}
- * - As a {@link java.lang.String} from {@link #toString()}
- * - As a byte array from from {@link #getBytes(boolean)}
- *
- *
- * @see net.jxta.endpoint.Message
- */
-public abstract class MessageElement implements Document {
-
- /**
- * Logger
- */
- private static transient final Logger LOG = Logger.getLogger(MessageElement.class.getName());
-
- /**
- * The name of this element. May be the empty string ("") if the element is
- * unnamed.
- */
- protected final String name;
-
- /**
- * The type of this element.
- */
- protected final MimeMediaType type;
-
- /**
- * The optional element which digitally signs or digests this element.
- * If null then the element is has no signature element.
- */
- protected final MessageElement sig;
-
- /**
- * message properties hashmap
- */
- private Map properties = null;
-
- /**
- * cached result of {@link #getByteLength()} operation.
- */
- protected transient long cachedGetByteLength = -1;
-
- /**
- * cached result of {@link #getBytes(boolean)} operation.
- */
- protected transient SoftReference cachedGetBytes = null;
-
- /**
- * cached result of {@link #toString()} operation.
- */
- protected transient SoftReference cachedToString = null;
-
- /**
- * Returns a pseudo-random unique string which can be used as an element
- * name.
- *
- * @return String containing a pseudo-random value
- */
- public static String getUniqueName() {
- return UUID.randomUUID().toString();
- }
-
- /**
- * Returns a string containing a pseudo-random unique string. The result of
- * String.compare() will be consistent with the order in which
- * results were returned from this function.
- *
- * Security Consideration : Be aware that the pseudo random portion of
- * the names generated by this string are shared amongst all peer groups
- * running in the same classloader. You may be at a risk for loss of
- * anonymity if you use the element names produced in more than one peer
- * group.
- *
- * @return String containing a pseudo-random value. The result of
- * String.compare() will be consistent with the order in
- * which results were returned from this function.
- */
- public static String getSequentialName() {
- return UUIDFactory.newSeqUUID().toString();
- }
-
- /**
- * Internal constructor for initializing everything but the data.
- *
- * @param name Name of the Element. May be the empty string ("") if
- * the Element is not named.
- * @param type Type of the Element. null is equivalent to specifying
- * the type "Application/Octet-stream"
- * @param sig optional message digest/digital signature element. If
- * no signature is to be specified, pass null.
- */
- protected MessageElement(String name, MimeMediaType type, MessageElement sig) {
- this.name = (null != name) ? name : "";
-
- this.type = (null != type) ? type.intern() : MimeMediaType.AOS;
-
- if ((null != sig) && (null != sig.sig)) {
- throw new IllegalArgumentException("Invalid Signature Element. Signatures may not have signatures.");
- }
-
- this.sig = sig;
- }
-
- /**
- * {@inheritDoc}
- *
- * @deprecated Since Message Elements are immutable this method does
- * nothing useful.
- */
- @Override
- @Deprecated
- public final MessageElement clone() {
- return this;
- }
-
- /**
- * {@inheritDoc}
- *
- * Elements are considered equal if they have the same name, type and
- * signatures. Element data is not considered by this implementation as
- * it is mostly intended for subclass use.
- */
- @Override
- public boolean equals(Object target) {
- if (this == target) {
- return true; // same object
- }
-
- if (target instanceof MessageElement) {
- MessageElement likeMe = (MessageElement) target;
-
- // sig is nullable so test seperatly.
- boolean sigequals = (null != sig) ? sig.equals(likeMe.sig) : (null == likeMe.sig);
-
- return sigequals && name.equals(likeMe.name) && type.equals(likeMe.type);
- }
-
- return false; // not a MessageElement
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public int hashCode() {
- int sigHash = ((null != getSignature()) && (this != getSignature())) ? getSignature().hashCode() : 1;
-
- int result = sigHash * 2467 + // a prime
- getElementName().hashCode() * 3943 + // also a prime
- getMimeType().hashCode();
-
- return (0 != result) ? result : 1;
- }
-
- /**
- * {@inheritDoc}
- *
- * Returns a String representation of the element data. The
- * 'charset' parameter of the message element's mimetype, if
- * any, is used to determine encoding. If the charset specified is
- * unsupported then the default encoding will be used.
- *
- * synchronized for caching purposes.
- */
- @Override
- public synchronized String toString() {
- String result;
-
- if (null != cachedToString) {
- result = cachedToString.get();
-
- if (null != result) {
- return result;
- }
- }
-
- if (Logging.SHOW_FINE && LOG.isLoggable(Level.FINE)) {
- LOG.fine("creating toString of " + getClass().getName() + '@' + Integer.toHexString(hashCode()));
- }
-
- String charset = type.getParameter("charset");
-
- StringBuilder theString = new StringBuilder();
-
- Reader asString;
-
- try {
- if (null == charset) {
- asString = new InputStreamReader(getStream());
- } else {
- try {
- asString = new InputStreamReader(getStream(), charset);
- } catch (UnsupportedEncodingException caught) {
- throw new IllegalStateException("Unsupported charset : " + charset);
- }
- }
-
- char[] characters = new char[256];
-
- do {
- int res = asString.read(characters);
-
- if (res < 0) {
- break;
- }
-
- theString.append(characters, 0, res);
- } while (true);
-
- result = theString.toString();
-
- cachedToString = new SoftReference(result);
- return result;
- } catch (IOException caught) {
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE, "Could not generate string for element. ", caught);
- }
-
- throw new IllegalStateException("Could not generate string for element. " + caught);
- }
- }
-
- /**
- * Returns the name of the MessageElement. Unnamed elements will return
- * the empty string ("");
- *
- * @return String containing the name of the MessageElement.
- */
- public String getElementName() {
- return name;
- }
-
- /**
- * {@inheritDoc}
- *
- * Will return "Application/Octet-Stream" if no type was originally
- * specified.
- */
- public MimeMediaType getMimeType() {
- return type;
- }
-
- /**
- * {@inheritDoc}
- *
- * We use the "unknown" extension and leave it to sub-classes to
- * extend this. If we had a mailcap facility we could do better
- * classification based on mimetype.
- */
- public String getFileExtension() {
- return "???";
- }
-
- /**
- * Returns the size of the element data in bytes.
- *
- * @return long containing the size of the element data.
- */
- public synchronized long getByteLength() {
- if (cachedGetByteLength >= 0) {
- return cachedGetByteLength;
- }
-
- CountingOutputStream countBytes = new CountingOutputStream(new DevNullOutputStream());
-
- try {
- sendToStream(countBytes);
- cachedGetByteLength = countBytes.getBytesWritten();
- return cachedGetByteLength;
- } catch (IOException caught) {
- throw new IllegalStateException("Could not get length of element : " + caught.toString());
- }
- }
-
- /**
- * Returns a byte array which contains the element data. The byte array
- * returned may be shared amongst all copies of the element,
- * do not modify it. The copy parameter allows you to request a
- * private, modifiable copy of the element data.
- *
- * This implementation builds the byte array from the stream.
- *
- * @param copy If true then the result can be modified without damaging the state of this
- * MessageElement. If false, then the result may be a shared copy of the data and
- * should be considered read-only.
- * @return byte[] Contents of message element.
- */
- public synchronized byte[] getBytes(boolean copy) {
- byte[] result;
-
- if (null != cachedGetBytes) {
- result = cachedGetBytes.get();
-
- if (null != result) {
- if (copy) {
- byte[] theCopy = new byte[result.length];
-
- System.arraycopy(theCopy, 0, result, 0, result.length);
- } else {
- return result;
- }
- }
- }
-
- if (Logging.SHOW_FINE && LOG.isLoggable(Level.FINE)) {
- LOG.fine("creating getBytes of " + getClass().getName() + '@' + Integer.toHexString(hashCode()));
- }
-
- long len = getByteLength();
-
- if (len > Integer.MAX_VALUE) {
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.severe("MessageElement is too large to be stored in a byte array.");
- }
-
- throw new IllegalStateException("MessageElement is too large to be stored in a byte array.");
- }
-
- result = new byte[(int) len];
-
- try {
- DataInput di = new DataInputStream(getStream());
-
- di.readFully(result);
- } catch (IOException caught) {
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE, "Failed to get bytes of Message Element. ", caught);
- }
- throw new IllegalStateException("Failed to get bytes of Message Element. " + caught);
- }
-
- // if this is supposed to be a shared buffer then we can cache it.
- if (!copy) {
- cachedGetBytes = new SoftReference(result);
- }
-
- return result;
- }
-
- /**
- * {@inheritDoc}
- *
- * This version probably has sub-optimal performance. Sub-classes
- * should override this implementation.
- */
- public void sendToStream(OutputStream sendTo) throws IOException {
- copyInputStreamToOutputStream(getStream(), sendTo);
- }
-
- /**
- * Returns the element containing the digest/digital signature for
- * this element
- *
- * @return Element containing the digital signature.
- */
- public MessageElement getSignature() {
-
- return sig;
- }
-
- /**
- * Associate a transient property with this element. If there was a previous
- * value for the key provided then it is returned.
- *
- * Element properties are useful for managing the state of element
- * during processing. Element properties are not transmitted with the
- * message element when the message element is sent as part of a message.
- *
- * The setting of particular keys may be controlled by a Java Security
- * Manager. Keys of type 'java.lang.Class' are checked against the caller of
- * this method. Only callers which are instances of the key class may modify
- * the property. This check is not possible through reflection. All other
- * types of keys are unchecked.
- *
- * @param key the property key
- * @param value the value for the property
- * @return previous value for the property or null if no previous
- */
- public synchronized Object setElementProperty(Object key, Object value) {
-
- /*
- if( key instanceof java.lang.Class ) {
- Class keyClass = (Class) key;
- SecurityManager secure = new SecurityManager() {
- public boolean checkCallerOfClass( Class toCheck ) {
- Class [] context = getClassContext();
-
- return toCheck.isAssignableFrom( context[2] );
- }
- };
-
- if( !secure.checkCallerOfClass( keyClass ) ) {
- throw new SecurityException( "You can't set that key from this context." );
- }
- }
- */
-
- if (null == properties) {
- properties = new HashMap();
- }
-
- return properties.put(key, value);
- }
-
- /**
- * Retrieves a transient property from the set for this element.
- *
- * Element properties are useful for managing the state of element
- * during processing. Element properties are not transmitted with the
- * message element when the message element is sent as part of a message.
- *
- * @param key the property key.
- * @return value for the property or null if there is no property for this
- * key.
- */
- public Object getElementProperty(Object key) {
-
- if (null == properties) {
- return null;
- }
-
- return properties.get(key);
- }
-
- /**
- * Copies an input stream to an output stream with buffering.
- *
- * @param source The stream to copy from.
- * @param sink The stream to send the data to.
- * @throws IOException if there is a problem copying the data
- */
- protected static void copyInputStreamToOutputStream(InputStream source, OutputStream sink) throws IOException {
- int c;
- byte[] buf = new byte[4096];
-
- do {
- c = source.read(buf);
-
- if (-1 == c) {
- break;
- }
-
- sink.write(buf, 0, c);
- } while (true);
- }
-}
-
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessageFilterListener.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessageFilterListener.java
deleted file mode 100644
index 1fd9d76d..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessageFilterListener.java
+++ /dev/null
@@ -1,86 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.endpoint;
-
-
-/**
- * This interface is used by Message Filters.
- *
- * @see net.jxta.endpoint.EndpointService
- * @see net.jxta.endpoint.EndpointAddress
- * @see net.jxta.endpoint.Message
- */
-public interface MessageFilterListener {
-
- /**
- * This method is invoked by the EndpointService for each message for which
- * this filter is registered.
- *
- * The src and destination addresses are the addresses as they were
- * before any filters were run upon the message. If your filter is dependant
- * upon the current value of thse addresses it should examine the message
- * directly.
- *
- * @param message Incoming message
- * @param srcAddr Endpoint Address of the original source of the message
- * @param dstAddr Endpoint Address of the original destination of the message
- * @return Message The potentially modified or alternate message. If null
- * is returned then the message has been discarded.
- */
- public Message filterMessage(Message message, EndpointAddress srcAddr, EndpointAddress dstAddr);
-
-}
-
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessagePropagater.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessagePropagater.java
deleted file mode 100644
index d105c2a4..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessagePropagater.java
+++ /dev/null
@@ -1,100 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.endpoint;
-
-
-/**
- * A MessagePropagater is a MessageTransport that can send propagated
- * (multicast) messages.
- *
- * @see net.jxta.endpoint.MessageTransport
- * @see net.jxta.endpoint.Message
- * @see net.jxta.endpoint.Messenger
- * @see net.jxta.endpoint.EndpointService
- * @see net.jxta.endpoint.MessageSender
- * @see net.jxta.endpoint.MessageReceiver
- */
-public interface MessagePropagater extends MessageTransport {
-
- /**
- * Returns the {@link EndpointAddress} which will be used as the source
- * address for all messages sent by this message sender. This is the
- * "preferred" address to which replies should be sent. This address is not
- * necessarily the best or only address by which the peer may be reached.
- *
- * The public address may also be for a different message transport.
- *
- * @return an EndpointAddress containing the public address for this
- * message receiver.
- */
- public EndpointAddress getPublicAddress();
-
- /**
- * Propagates a Message via this Message Transport.
- *
- * @param msg The Message to be propagated.
- * @param serviceName Contains the name of the destination service, if any.
- * This will be integrated into the destination address.
- * @param serviceParams Contains the parameters associated with the service,
- * if any. This will be integrated into the destination address.
- * @param initialTTL The requested initial TTL for this message. This value
- * may be reduced by the implementation.
- * @return {@code true} if the Message was propagated otherwise
- * {@code false}.
- */
- public boolean propagate(Message msg, String serviceName, String serviceParams, int initialTTL);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessageReceiver.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessageReceiver.java
deleted file mode 100644
index 766e20a6..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessageReceiver.java
+++ /dev/null
@@ -1,85 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.endpoint;
-
-
-import java.util.Iterator;
-
-
-/**
- * A MessageReceiver is a MessageTransport that is capable of receiving messages.
- * A MessageReceiver receives messages from the network and hands them to the
- * the {@link EndpointService} for processing. A Message Receiver is known by
- * the {@link EndpointAddress EndpointAddresses} it provides.
- *
- * @see net.jxta.endpoint.EndpointAddress
- * @see net.jxta.endpoint.MessageTransport
- * @see net.jxta.endpoint.EndpointService
- **/
-public interface MessageReceiver extends MessageTransport {
-
- /**
- * Returns an Iterator of all of the
- * {@link EndpointAddress EndpointAddresses} by which this
- * MessageReceiver is reachable. The list is in order of
- * "preference" with the most "preferred" EndpointAddress being at the
- * beginning of the list.
- *
- * @return an Iterator of EndpointAddresses.
- */
- public Iterator getPublicAddresses();
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessageSender.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessageSender.java
deleted file mode 100644
index 84fad198..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessageSender.java
+++ /dev/null
@@ -1,150 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.endpoint;
-
-
-import java.io.IOException;
-
-
-/**
- * A MessageSender is a MessageTransport that is able to send messages to
- * remote peers using some protocol. MessageSenders provide facilities for
- * sending point-to-point (unicast) messages.
- *
- * MessageSenders additionally describe themselves in terms of their
- * abilities.
- *
- * - {@link #isConnectionOriented()}
- Indicates that the
- * Message Transport can provide efficient transport of a series of messages to
- * the same destination
- * - {link@ #allowRouting()}
- Indicates that the Message Transport
- * can be used in the routing of messages to destinations which are not
- * directly reachable via this transport.
- *
- *
- * @see net.jxta.endpoint.MessageTransport
- * @see net.jxta.endpoint.Message
- * @see net.jxta.endpoint.Messenger
- * @see net.jxta.endpoint.EndpointService
- * @see net.jxta.endpoint.MessageReceiver
- * @see net.jxta.endpoint.MessagePropagater
- */
-public interface MessageSender extends MessageTransport {
-
- /**
- * Returns the {@link EndpointAddress} which will be used as the source
- * address for all messages sent by this message sender. This is the
- * "preferred" address to which replies should be sent. This address is not
- * necessarily the best or only address by which the peer may be reached.
- *
- * The public address may also be for a different message transport.
- *
- * @return an EndpointAddress containing the public address for this
- * message receiver.
- */
- public EndpointAddress getPublicAddress();
-
- /**
- * Returns {@code true} if the Message Transport is connection oriented
- * (like TCP/IP). Indicates that the Message Transport can provide
- * efficient transport of a series of messages to the same destination.
- *
- * @return {@code true} if the Message Transport is connection oriented.
- */
- public boolean isConnectionOriented();
-
- /**
- * Returns true if the Message Transport can be used by the EndpointRouter.
- * Indicates that the Message Transport can be used in the routing of
- * messages to destinations which are not directly reachable via this
- * transport.
- *
- * More specifically, this Message Transport will be used to route
- * messages who's final destination is not one of the endpoint
- * addresses available from {@code getReachableEndpointAddresses}.
- *
- * @return true if the protocol can be used by the EndpointRouter
- */
- public boolean allowsRouting();
-
- /**
- * Return a {@link Messenger} for sending messages to the specified
- * destination {@link EndpointAddress}.
- *
- @param dest The destination address for which a messenger is requested.
- * @param hint An optional hint for the transport to use when creating the
- * messenger. The format of the hint is specific to each Message Transport
- * and may be {@code null} if no hint is provided.
- * @return a Messenger or {@code null} if the destination is not reachable.
- */
- public Messenger getMessenger(EndpointAddress dest, Object hint);
-
- /**
- * Returns {@code true} if the specified destination address is reachable
- * via this Message Transport otherwise returns {@code false}.
- *
- * @deprecated This operation is often very expensive and usually
- * duplicates the work of {@link #getMessenger}. If you want to determine
- * the reachability of a destination, get a Messenger to the destination.
- *
- * @param addr Address to ping
- * @return {@code true} if the specified destination address is reachable
- * via this Message Transport otherwise returns {@code false}.
- */
- @Deprecated
- public boolean ping(EndpointAddress addr);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessageTransport.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessageTransport.java
deleted file mode 100644
index 36584cae..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessageTransport.java
+++ /dev/null
@@ -1,105 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.endpoint;
-
-
-/**
- * A MessageTransport is responsible for sending and/or receiving JXTA
- * messages from an external network. A MessageTransport may use whatever
- * protocol it wishes in transporting messages. Messages passed to
- * MessageTransports are required to pass the messages cleanly (unaltered).
- *
- * @see net.jxta.endpoint.EndpointService
- * @see net.jxta.endpoint.EndpointAddress
- * @see net.jxta.endpoint.MessageSender
- * @see net.jxta.endpoint.MessageReceiver
- */
-public interface MessageTransport {
-
- /**
- * Returns a String containing the name of the protocol used by this
- * MessageTransport. The value will match the "protocol" portion of all
- * {@link EndpointAddress}.
- *
- * @return a String containing the name of the protocol used by this
- * MessageTransport.
- */
- public String getProtocolName();
-
- /**
- * Returns the endpoint service with which this MessageTransport is
- * registered. If it is unregistered then null will be returned.
- *
- * @return the EndpointService with which this MessageTransport is
- * registered.
- */
- public EndpointService getEndpointService();
-
- /**
- * Pass a transport control object to a message transport.
- *
- * @param operation Object that specifies the type of control operation
- * to be performed
- * @param value Object that specifies a value object associated
- * with the control operation
- * @return returned object
- * @deprecated Under development, may change.
- */
- @Deprecated
- public Object transportControl(Object operation, Object value);
-}
-
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/Messenger.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/Messenger.java
deleted file mode 100644
index 34b16337..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/Messenger.java
+++ /dev/null
@@ -1,696 +0,0 @@
-/*
- * Copyright (c) 2004-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.endpoint;
-
-
-import net.jxta.peergroup.PeerGroupID;
-import net.jxta.util.SimpleSelectable;
-
-import java.io.IOException;
-
-
-/**
- * A Messenger is used to send messages to a destination.
- *
- * This interface specifies the allowed observable states for a messenger. (fine grain). This serves to normalize
- * the state machines of the various messenger implementations and allows for more meaningful diagnostics. Implementations may
- * use substates by adding high order bits, but these should never be reported by the public state observation methods. Most
- * implementations will not use all these states.
- *
- * Each valid state is represented by a integer that is a power of 2.
- *
- * The (coarse grain) constants: USABLE, RESOLVED, TERMINAL, IDLE, SATURATED represent meaningful partitions of the space of
- * states.
- *
- * The value of each constant is the bitwise OR of the states for which a given predicate is true: usable or not,
- * confirmed or not, etc. Therefore the value of predicate p in state s is (s & p)!=0.
- *
- * These particular predicates are chosen so that they have a relevant truth value for all states. Therefore the bitwise negation
- * of the corresponding constants represents the obvious: ~USABLE really lists all states that mean "not USABLE".
- *
- * These constants may be combined by bit logic operators to represent more predicates. {@link #waitState} accepts such values as
- * a parameter.
- *
- * Applications should depend on the coarse grain constants, rather than those denoting discrete states.
- *
- * @see net.jxta.endpoint.EndpointService
- * @see net.jxta.util.SimpleSelector
- * @see net.jxta.endpoint.EndpointAddress
- * @see net.jxta.endpoint.Message
- * @see MessengerState
- */
-public interface Messenger extends SimpleSelectable {
-
- /**
- * No message was ever submitted for sending. No connection has ever been attempted.
- */
- public static final int UNRESOLVED = 0x1;
-
- /**
- * Initial connection is being attempted. No message is pending.
- */
- public static final int RESOLVING = 0x2;
-
- /**
- * Currently connected. No message is pending (being sent implies pending).
- */
- public static final int CONNECTED = 0x4;
-
- /**
- * Currently not connected. No message is pending.
- */
- public static final int DISCONNECTED = 0x8;
-
- /**
- * Initial connection is being attempted. Messages are pending.
- */
- public static final int RESOLPENDING = 0x10;
-
- /**
- * Initial connection is being attempted. Messages are pending. New messages may not be submitted at this time.
- */
- public static final int RESOLSATURATED = 0x20;
-
- /**
- * Currently connected and sending messages.
- */
- public static final int SENDING = 0x40;
-
- /**
- * Currently sending messages.New messages may not be submitted at this time.
- */
- public static final int SENDINGSATURATED = 0x80;
-
- /**
- * Currently trying to re-establish connection. Messages are pending.
- */
- public static final int RECONNECTING = 0x100;
-
- /**
- * Currently trying to re-establish connection. New messages may not be submitted at this time.
- */
- public static final int RECONSATURATED = 0x200;
-
- /**
- * Attempting initial connection. Close has been requested. Messages are pending.
- * New messages may no longer be submitted.
- */
- public static final int RESOLCLOSING = 0x400;
-
- /**
- * Currently sending messages. Close has been requested. New messages may no longer be submitted.
- */
- public static final int CLOSING = 0x800;
-
- /**
- * Trying to re-establish connection. Close has been requested. Messages are pending.
- * New messages may no longer be submitted.
- */
- public static final int RECONCLOSING = 0x1000;
-
- /**
- * Failed to establish initial connection. Pending messages are being rejected. New messages may no longer be submitted.
- */
- public static final int UNRESOLVING = 0x2000;
-
- /**
- * Failed to re-establish connection. Pending messages are being rejected. New messages may no longer be submitted.
- */
- public static final int BREAKING = 0x4000;
-
- /**
- * Breaking established connection for expedite closure. Pending messages are being rejected.
- * New messages may no longer be submitted.
- */
- public static final int DISCONNECTING = 0x8000;
-
- /**
- * Failed to establish initial connection. New messages may no longer be submitted. State will never change again.
- */
- public static final int UNRESOLVABLE = 0x10000;
-
- /**
- * Failed to re-establish connection. New messages may no longer be submitted. State will never change again.
- */
- public static final int BROKEN = 0x20000;
-
- /**
- * Closed as requested. All pending messages could be sent. New messages may no longer be submitted.
- * State will never change again.
- */
- public static final int CLOSED = 0x40000;
-
- /**
- * The bitwise OR of all valid states.
- */
- public static final int ANYSTATE = 0x7FFFF;
-
- /* Predicates. */
-
- /**
- * Composite state.
- *
- * Not known to be broken.
- * Messenger may be used to send messages. Viability has not been evaluated yet.
- * This is the most useful predicate to applications. USABLE means that
- * it is reasonable to try and send a message.
- */
- public static final int USABLE = (UNRESOLVED | RESOLVING | CONNECTED | DISCONNECTED | RESOLPENDING | RESOLSATURATED | SENDING
- | SENDINGSATURATED | RECONNECTING | RECONSATURATED);
-
- /**
- * Composite state.
- *
- *
- * - Messenger was once resolved.
- *
- Messenger was at least once proven viable. Current usability is
- * not asserted. For example a messenger may be found to be in a
- * TERMINAL state, but also be in a RESOLVED state. Thus proving that
- * the destination of the messenger is sometimes valid.
- *
- */
- public static final int RESOLVED = (CONNECTED | SENDING | SENDINGSATURATED | CLOSING | CLOSED | DISCONNECTED | RECONNECTING
- | RECONSATURATED | RECONCLOSING | BREAKING | DISCONNECTING | BROKEN);
-
- /**
- * Composite state.
- *
- * Messenger has terminated its useful life. State will never change any more.
- */
- public static final int TERMINAL = (UNRESOLVABLE | CLOSED | BROKEN);
-
- /**
- * Composite state.
- *
- * Any message that may have been submitted in the past has been either sent or failed already.
- * If a messenger is in a state IDLE & RESOLVED & USABLE, then the expected delay in sending a message
- * is minimal.
- */
- public static final int IDLE = (UNRESOLVED | RESOLVING | CONNECTED | DISCONNECTED | UNRESOLVABLE | CLOSED | BROKEN);
-
- /**
- * Composite state.
- *
- * This messenger cannot take new messages for now. All available buffering space is occupied.
- * Note that only the usable states can be saturated. Once a messenger is in the process of terminating
- * and thus takes no new messages anyway, it no-longer shows as saturated.
- */
- public static final int SATURATED = (RESOLSATURATED | SENDINGSATURATED | RECONSATURATED);
-
- /**
- * Returns the current state.
- *
- * @return one of the legal discrete state values.
- */
- public int getState();
-
- /**
- * Blocks unless and until the current state is or has become one of the desired values. The observable states are guaranteed
- * to be represented by a single bit. Multiple desired values may be specified by passing them ORed together.
- *
- * This class defines the list of constants that may be used and how these may be combined.
- *
- * Note that the state can change as soon as this method returns, so any observation is only an indication of the
- * past. Synchronizing on the object itself has no other effect than interfering with other threads doing the same. Obviously,
- * certain transitions cannot happen unless a new message is submitted. So unless another thread is using a messenger, it is
- * safe to assume that a non-saturated messenger will not become saturated spontaneously. Note that messengers returned by
- * different endpoint service interface objects (what {@link net.jxta.peergroup.PeerGroup#getEndpointService()} returns) are
- * different. However a given endpoint interface object will return an existing messenger to the same exact destination if
- * there is a {@link Messenger#USABLE} one.
- *
- * With an unshared messenger, one can wait for any change with {@code waitState(~getState(), 0);}.
- *
- * Note that it is advisable to always include {@link #TERMINAL} as part
- * of the desired states with unless being blocked past the messenger
- * termination is an acceptable behaviour.
- *
- * Examples:
- *
- * Ensure that the messenger can take more messages (or is {@code UNUSABLE}): {@code waitState(~SATURATED)}
- *
- * Ensure that all submitted messages have been sent: {@code waitState(TERMINAL | IDLE)}
- *
- * Ensure that the messenger is already resolved and can take more messages: {@code waitState(TERMINAL | (RESOLVED & ~SATURATED))}
- *
- * @param wantedStates The binary OR of the desired states.
- * @param timeout The maximum number of milliseconds to wait. A timeout of 0 means no time limit.
- * @return The desired state that was reached or the current state when time ran out.
- * @throws InterruptedException If the invoking thread was interrupted before the condition was realized.
- */
- int waitState(int wantedStates, long timeout) throws InterruptedException;
-
- /**
- * Returns {@code true} if this messenger is closed and no longer
- * accepting messages to be sent. This is a shortcut for
- * {@code (getState() & USABLE == 0)}. Once closed, a messenger should be
- * discarded.
- *
- * @return {@code true} if this messenger is closed, otherwise {@code false}.
- */
- boolean isClosed();
-
- /**
- * Returns an indication of whether this messenger may be worth closing.
- *
- * @return {@code true} if the messenger is idle otherwise {@code false}.
- * @deprecated no longer relevant and always false. This notably is not equivalent to the {@link #IDLE} state.
- */
- @Deprecated
- boolean isIdle();
-
- /**
- * Returns {@code true} if the sendMessage methods of
- * this messenger are fully synchronous.
- *
- * @deprecated all messengers are asynchronous, and the {@link #sendMessageB} method is always blocking.
- *
- * @return true if synchronous
- */
- @Deprecated
- boolean isSynchronous();
-
- /**
- * Returns the destination of this messenger.
- *
- * @return The destination address of this messenger
- * @see Messenger#getLogicalDestinationAddress()
- */
- EndpointAddress getDestinationAddress();
-
- /**
- * Returns the internal EndpointAddress object of the destination of the user.
- * This method is intended to be used for applications that require a weak
- * or soft reference to an EndpointMessenger: the returned Endpoint Address
- * object will be unreferenced when this messenger will finalize.
- *
- * @deprecated EndpointAddress is now immutable which means that this result
- * is the same as {@link #getDestinationAddress()}. This method will be
- * eventually removed.
- *
- * @return EndpointAddress the destination address of this messenger
- * @see #getDestinationAddress()
- */
- @Deprecated
- EndpointAddress getDestinationAddressObject();
-
- /**
- * Returns the logical destination of this messenger. This may be a
- * different address than is returned by
- * {@link #getDestinationAddress() getDestinationAddress} and refers to
- * the entity which is located at the destination address.
- *
- * By analogy, a telephone number would be the destination address, and
- * the owner of that telephone number would be the logical destination.
- * Each logical destination may be known by one or more destination
- * addresses.
- *
- * @return EndpointAddress the logical destination address of this messenger.
- * @see #getDestinationAddress()
- */
- EndpointAddress getLogicalDestinationAddress();
-
- /**
- * Returns the maximum message size that this messenger can be used to send.
- * The limit refers to the cumulative size of application level elements.
- * The various {@code sendMessage()} variants will refuse to send messages
- * that exceed this limit.
- *
- * @return the limit.
- */
- long getMTU();
-
- /**
- * If applicable, returns another messenger that will send messages to the same destination address than this one, but with
- * the specified default service and serviceParam, possibly rewriting addresses to ensure delivery through the specified
- * redirection. This is not generally useful to applications and most messengers will return null. This method is needed
- * by the EndpointService when interacting with Messengers provided by Transport modules. If you are not implementing a
- * Transport module, then you can ignore this method.
- *
- * Important: The channel so obtained is not configured to support the {@link #sendMessage(Message,String,String,
- *OutgoingMessageEventListener)} legacy method. If use of this method is desired, {@link ChannelMessenger#setMessageWatcher}
- * must be used first.
- *
- * @param redirection The requested redirection. The resulting channel messenger will use this to force
- * delivery of the message only in the specified group (or possibly descendents, but not parents). If null the local
- * group is assumed. This redirection is applied only to messages that are sent to a service name and service param that
- * do not imply a group redirection.
- * @param service The service to which the resulting channel will send messages, when they are not sent to a
- * specified service.
- * @param serviceParam The service parameter that the resulting channel will use to send messages, when no parameter is
- * specified.
- * @return a channelMessenger as specified.
- * @see MessageSender#getMessenger(EndpointAddress,Object)
- */
- Messenger getChannelMessenger(PeerGroupID redirection, String service, String serviceParam);
-
- /**
- * Close this messenger after processing any pending messages. This method
- * is not blocking. Upon return, the messenger will be in one of the non
- * {@link #USABLE} states, which means that no message may be sent through
- * it. Any other effect of this method, such as an underlying connection
- * being closed, or all pending messages being processed, may be deferred
- * indefinitely. When the messenger has completely processed the closure
- * request, it will be in one of the {@link #TERMINAL} states (which are
- * also {@link #IDLE} states). Therefore, if one is interested in the
- * outcome of the closure, one may wait for the messenger to be in a
- * {@link #TERMINAL} or {@link #IDLE} state, and check which it is.
- * {@link #CLOSED} denotes success (all outstanding messages have been
- * sent), as opposed to {@link #UNRESOLVABLE} or {@link #BROKEN}.
- */
- void close();
-
- /**
- * Makes sure that all outstanding messages have been processed;
- * successfully or not. This method waits unless and until the state of the
- * messenger is an {@link #IDLE} state. If the reached state is neither
- * {@link #CLOSED} or any {@link #USABLE} state, then it throws an
- * IOException. Else it returns silently.
- *
- * If another thread keeps sending messages, this method may never
- * return.
- *
- * This method is deliberately simple. If a timeout needs to be
- * provided, or if more detailed conditions are required, the
- * {@link #waitState(int,long)} and {@link #getState()} methods should be
- * used. For example :
- *
- *
- * int myFlush(long notTooLong) {
- * messenger.waitState(IDLE, notTooLong);
- * if ((messenger.getState() & IDLE) == 0) return TOOLONG;
- * if ((messenger.getState() & USABLE) != 0) return FLUSHED;
- * if (messenger.getState() == CLOSED) return CLOSEDANDFLUSHED;
- * return BROKEN;
- * }
- * flush() after close() as a form of synchronous
- * variant of close(). If this messenger is not shared with any
- * other thread, then invoking flush() before
- * close is a more familiar means of achieving the same effect.
- *
- * @throws IOException This messenger failed before processing all
- * outstanding messages successfully.
- */
- void flush() throws IOException;
-
- /**
- * Force the messenger to start resolving if it is not resolved yet. Any
- * attempt at sending a message has the same effect, but the message may
- * fail as a result, depending upon the method used.
- */
- void resolve();
-
- /**
- * Simple sending: blocks until the message was accepted for sending or the messenger is not {@link #USABLE}; whichever occurs
- * first. If a service name and service param are specified, they will replace those specified at construction for the
- * purpose of sending this message only.
- *
- * Error Handling:
- *
- *
- * - An {@link java.io.IOException} means that this message is invalid or that this messenger is now in one of the non {@link
- * #USABLE} states and may no longer send new messages, and means that the message was not sent. The exact state of the
- * messenger may be obtained from the {@link #getState()} method. If no exception is thrown, the message is accepted for
- * sending and may or may not be fully processed.
- *
- * - The invoker may have confirmation of completion by observing the message's properties. When the message has been
- * fully processed, {@link Message#getMessageProperty(Object) Message#getMessageProperty(Messenger.class)} will return an
- * object of class {@link OutgoingMessageEvent}. Changes in a message's set of properties may be tracked by selecting the
- * message. If an exception was thrown, the message's properties will not be modified
- *
- *
- There is no guarantee that the process of sending the message will not fail after that method returned. If this messenger
- * subsequently reaches an {@link #IDLE} state that is either {@link #CLOSED} or a {@link #USABLE} state, then it may be inferred
- * that all outstanding messages have been processed without this messenger detecting an error.
- *
- *
- * WARNING: The Message object should not be reused or modified until completely processed. Concurrent modification
- * of a message while a messenger is sending the message will produce incorrect and unpredictable results. If completion is
- * not monitored, the message should never be reused. If necessary, a clone of the message may be provided to
- * {@link #sendMessageB}:
- *
- *
- * messenger.sendMessageB( (Message) myMessage.clone(), theService, theParam );
- *
- * - A return result of {@code false} indicates that the message was not accepted to be sent. This may be due to
- * local resource limits being reached or to the messenger being in a state that is not {@link #USABLE} or to the message
- * being invalid. The exact cause of the failure can be retrieved from the message by using
- * {@link Message#getMessageProperty(Object)
Message.getMessageProperty(Messenger.class)}. If appropriate,
- * another attempt at sending the message, may be made after waiting for the congestion to clear (for example by using
- * {@link #waitState(int,long)}).
- *
- * - A return result of {@code true} indicates that the message was accepted for sending. It does not imply that
- * the message will be sent or that the destination will receive the message. There will be no indication by this method
- * of any errors in sending the message. If this messenger subsequently reaches an {@link #IDLE} state that is either {@link
- * #CLOSED} or a {@link #USABLE} state, then it may be inferred that all outstanding messages have been processed without this
- * messenger detecting an error.
- *
- * - The invoker may have confirmation of completion (successful or not) by observing the message's properties. When the
- * message has been fully processed, {@link Message#getMessageProperty(Object)
Message.getMessageProperty(Messenger.class)}
- * will return an object of class {@link OutgoingMessageEvent}. Changes in a message's set of properties may be tracked by
- * selecting the message.
- *
- *
- * WARNING: The Message object should not be reused or modified until completely processed. Concurrent modification
- * of a message while a messenger is sending the message will produce incorrect and unpredictable results. If completion is
- * not monitored, the message should never be reused. If necessary, a clone of the message may be provided to
- * {@link #sendMessageN}:
- *
- *
- * messenger.sendMessageN( (Message) myMessage.clone(), theService, theParam );
- *
- *
- * - An {@link java.io.IOException} means that this message is invalid or that this messenger is now in one of the
- * non {@link #USABLE} states and may no longer send new messages, and that the message was not sent. The exact state of
- * the messenger may be obtained from the {@link #getState()} method.
- *
- * - A return result of {@code false} indicates that the message was not accepted to be sent. Usually this is due to
- * local resource limits being reached. If needed, another attempt at sending the message, may be made after waiting for the
- * congestion to clear (for example by using {@link #waitState(int,long)}).
- *
- * - A return result of {@code true} indicates that the message was accepted for sending. It does not imply that
- * the message will be sent or that the destination will receive the message. There will be no immediate indication of any
- * errors in sending the message. If this messenger subsequently reaches an {@link #IDLE} state that is either {@link #CLOSED}
- * or a {@link #USABLE} state, then it may be inferred that all outstanding messages have been processed without this
- * messenger detecting an error.
- *
- * - The invoker may have confirmation of completion by observing the message's properties. When the message has been fully
- * processed, {@link Message#getMessageProperty(Object)
Message.getMessageProperty(Messenger.class)} will return
- * an object of class {@link OutgoingMessageEvent}. Changes in a message's set of properties may be tracked by selecting
- * the message.
- *
- *
- *
- * WARNING: The Message object should not be reused or modified until completely processed. Concurrent modification
- * of a message while a messenger is sending the message will produce incorrect and unpredictable results. If completion is
- * not monitored, the message should never be reused. If necessary, a clone of the message may be provided to
- * sendMessage:
- *
- *
- * messenger.sendMessage( (Message) myMessage.clone(), theService, theParam );
- *
sendMessage:
- *
- *
- * messenger.sendMessage( (Message) myMessage.clone() );
- *
- *
- * - If a listener was provided, it will always be invoked. Depending upon the outcome either the
- * {@link OutgoingMessageEventListener#messageSendFailed(OutgoingMessageEvent)} or the {@link
- * OutgoingMessageEventListener#messageSendSucceeded(OutgoingMessageEvent)} method will be invoked:
- *
- *
- *
- * - If the message could not be accepted for sending due to temporary resource saturation,
- *
messageSendFailed will be invoked. The {@link Throwable} object returned by the {@link
- * OutgoingMessageEvent#getFailure()} method of the passed event object will be null.
- *
- * - If the message could not be accepted for sending due to the messenger not being {@link #USABLE},
- *
messageSendFailed will be invoked. The {@link Throwable} object returned by the {@link
- * OutgoingMessageEvent#getFailure()} method of the passed event object will reflect the messenger's condition.
- *
- * - If the message is accepted for sending but later fails, then
messageSendFailed will be invoked. The
- * {@link Throwable} object returned by the {@link OutgoingMessageEvent#getFailure()} method of the passed event object
- * will reflect the origin of the failure.
- *
- * - If the message is accepted for sending and later succeeds, then
messageSendSucceeded will be
- * invoked.
- *
- *
- *
- * - If a listener was provided, it is always possible that it is invoked before this method returns.
- *
- * - If no listener was provided, There will be no notification of any errors nor success in sending the message. If
- * this messenger subsequently reaches an {@link #IDLE} state that is either {@link #CLOSED} or a {@link #USABLE} state, then it
- * may be inferred that all outstanding messages have been processed without this messenger detecting an error.
- *
- * - This method does not throw exceptions. As a result, when used with a {@code null} listener, it provides very
- * little feedback to the invoker. A messenger should be abandoned once it is in one of the {@link #TERMINAL} states.
- *
- *
- *
- * As with all sendMessage methods, success is not a guarantee that the message will actually be received.
- *
- * This is a legacy method. Modern code should prefer the other methods and select messages. If a listener API is preferred, it is possible to use a {@link ListenerAdaptor} object explicitly to have a listener called.
- *
- * @param msg The message to send.
- * @param service Optionally replaces the service in the destination
- * address. If {@code null} then the destination address's default
- * service will be used. If the empty string ("") is used then
- * no service is included in the destination address.
- * @param serviceParam Optionally replaces the service param in the
- * destination address. If {@code null} then the destination address's
- * default service parameter will be used. If the empty string ("") is used
- * then no service param is included in the destination address.
- * @param listener listener for events about this message or null if no notification is desired.
- * @throws UnsupportedOperationException If this messenger is not a channel or was not given a {@link ListenerAdaptor}.
- * (all messengers obtained through {@link EndpointService#getMessenger} are configured properly.
- */
- void sendMessage(Message msg, String service, String serviceParam, OutgoingMessageEventListener listener);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessengerEvent.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessengerEvent.java
deleted file mode 100644
index bcf4b6a1..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessengerEvent.java
+++ /dev/null
@@ -1,110 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.endpoint;
-
-/**
- * An event which indicates that a messenger has been successfully created.
- *
- * The source of Message Transport providing the messenger.
- *
- * @see net.jxta.endpoint.MessageTransport
- * @see net.jxta.endpoint.Messenger
- * @see net.jxta.endpoint.EndpointService
- */
-public class MessengerEvent extends java.util.EventObject {
-
- /**
- * The newly created messenger.
- */
- final transient Messenger messenger;
-
- /**
- * The destination address of the messenger.
- */
- final EndpointAddress connectionAddress;
-
- /**
- * Creates a new instance of MessengerEvent
- *
- * @param source The source of Message Transport providing the messenger
- * @param messenger the messenger
- * @param connectionAddress The connection address
- */
- public MessengerEvent(Object source, Messenger messenger, EndpointAddress connectionAddress) {
- super(source);
-
- this.messenger = messenger;
- this.connectionAddress = connectionAddress;
- }
-
- public Messenger getMessenger() {
- return messenger;
- }
-
- public EndpointAddress getConnectionAddress() {
- return connectionAddress;
- }
-
- /**
- * {@inheritDoc}
- *
- * A simple implementation for debugging. Don't depend upon this format.
- */
- @Override
- public String toString() {
- return source.toString() + "-->" + messenger.toString() + " (" + connectionAddress + ")";
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessengerEventListener.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessengerEventListener.java
deleted file mode 100644
index 09896027..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessengerEventListener.java
+++ /dev/null
@@ -1,73 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.endpoint;
-
-import java.util.EventListener;
-
-/**
- * A listener for MessengerEvents.
- */
-public interface MessengerEventListener extends EventListener {
-
- /**
- * A messenger is ready.
- *
- * @param event The Messenger Event.
- * @return {@code true} if the listener wants to claim the Messenger.
- * (Normally means that it will not be offered to any other listener).
- */
- public boolean messengerReady(MessengerEvent event);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessengerState.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessengerState.java
deleted file mode 100644
index df7c1cd6..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/MessengerState.java
+++ /dev/null
@@ -1,443 +0,0 @@
-/*
- * Copyright (c) 2004-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.endpoint;
-
-/**
- * The complete standard messenger life cycle state machine that all messengers
- * must obey. Compliant messengers can be built by implementing and using this
- * class as an engine to orchestrate discrete operations.
- *
- * In order to use this class, one must implement the various abstract Action
- * methods, so that they trigger the required operations.
- *
- * Synchronization has to be externally provided and usually needs to extend
- * around sections wider than just the invocation of this class' methods. For
- * example, if the user of this class maintains a queue, the state of the queue
- * must be kept consistent with the invocation of {@link #msgsEvent},
- * {@link #saturatedEvent}, and {@link #idleEvent}, which all denote different
- * states of that queue. It is suggested to use the instance of this class as
- * the synchronization object.
- */
-public abstract class MessengerState {
-
- // All the transition map setup is rather terse because java tends to make
- // it extremely verbose. We do not want to end up with 1000 lines of code
- // for what amounts to initializing a table.
-
- // Below is a method reference. It permits putting "what to do" in a field.
- // The {@code doIt()} method is given the target object because we want our
- // entire transition table to be a static singleton. Otherwise it would cost
- // too much initializing each instance of this class.
-
- private interface Action {
- public void doIt(MessengerState messengerState);
- }
-
- // Action method "pointers".
- // The transition table is static. Otherwise it would cost too much initializing each instance of this class.
-
- private final static Action Connect = new Action() {
- public void doIt(MessengerState messengerState) {
- messengerState.connectAction();
- }
- };
- private final static Action Closein = new Action() {
- public void doIt(MessengerState s) {
- s.closeInputAction();
- }
- };
- private final static Action Start = new Action() {
- public void doIt(MessengerState s) {
- s.startAction();
- }
- };
- private final static Action Closeout = new Action() {
- public void doIt(MessengerState messengerState) {
- messengerState.closeOutputAction();
- }
- };
- private final static Action Failall = new Action() {
- public void doIt(MessengerState messengerState) {
- messengerState.failAllAction();
- }
- };
- private final static Action Closeio = new Action() {
- public void doIt(MessengerState s) {
- s.closeInputAction();
- s.closeOutputAction();
- }
- };
- private final static Action Closefail = new Action() {
- public void doIt(MessengerState messengerState) {
- messengerState.closeInputAction();
- messengerState.failAllAction();
- }
- };
- private final static Action Nop = new Action() {
- public void doIt(MessengerState messengerState) {
- }
- };
-
- /**
- * The transition each event causes when in that state.
- */
- private static class State {
- private final int number;
-
- private State stResolve;
- private Action acResolve;
-
- private State stMsgs;
- private Action acMsgs;
-
- private State stSaturated;
- private Action acSaturated;
-
- private State stClose;
- private Action acClose;
-
- private State stShutdown;
- private Action acShutdown;
-
- private State stUp;
- private Action acUp;
-
- private State stDown;
- private Action acDown;
-
- private State stIdle;
- private Action acIdle;
-
- State(int stateNum) {
- number = stateNum;
- }
-
- void init(Object[] data) {
- stResolve = (State) data[0];
- acResolve = (Action) data[1];
- stMsgs = (State) data[2];
- acMsgs = (Action) data[3];
- stSaturated = (State) data[4];
- acSaturated = (Action) data[5];
- stClose = (State) data[6];
- acClose = (Action) data[7];
- stShutdown = (State) data[8];
- acShutdown = (Action) data[9];
- stUp = (State) data[10];
- acUp = (Action) data[11];
- stDown = (State) data[12];
- acDown = (Action) data[13];
- stIdle = (State) data[14];
- acIdle = (Action) data[15];
- }
- }
-
-
- // All the states. (We put them together in a class essentially to simplify initialization).
- private static class TransitionMap {
-
- private final static State Unresolved = new State(Messenger.UNRESOLVED);
- private final static State ResPending = new State(Messenger.RESOLPENDING);
- private final static State Resolving = new State(Messenger.RESOLVING);
- private final static State ResolSat = new State(Messenger.RESOLSATURATED);
- private final static State Connected = new State(Messenger.CONNECTED);
- private final static State Disconned = new State(Messenger.DISCONNECTED);
- private final static State Reconning = new State(Messenger.RECONNECTING);
- private final static State ReconSat = new State(Messenger.RECONSATURATED);
- private final static State Sending = new State(Messenger.SENDING);
- private final static State SendingSat = new State(Messenger.SENDINGSATURATED);
- private final static State ResClosing = new State(Messenger.RESOLCLOSING);
- private final static State ReconClosing = new State(Messenger.RECONCLOSING);
- private final static State Closing = new State(Messenger.CLOSING);
- private final static State Disconning = new State(Messenger.DISCONNECTING);
- private final static State Unresable = new State(Messenger.UNRESOLVABLE);
- private final static State Closed = new State(Messenger.CLOSED);
- private final static State Broken = new State(Messenger.BROKEN);
-
- // The states need to exist before init, because they refer to each other.
- // We overwrite them in-place with the complete data.
-
- private final static Object[][] INIT_TRANSITION_MAP = {
-
- /* STATE resolve, msgs, saturated, close, shutdown, up, down, idle */
-
- /* UNRESOLVED */
- {Resolving, Connect, ResPending, Connect, ResolSat, Connect, Closed, Closein, Broken, Closein, Connected, Nop, Unresolved, Nop, Unresolved, Nop},
-
- /* RESOLPENDING */
- {ResPending, Nop, ResPending, Nop, ResolSat, Nop, ResClosing, Closein, Broken, Closefail, Sending, Start, Unresable, Closefail, Resolving, Nop},
-
- /* RESOLVING */
- {Resolving, Nop, ResPending, Nop, ResolSat, Nop, Closed, Closein, Broken, Closein, Connected, Nop, Unresable, Closein, Resolving, Nop},
-
- /* RESOLSATURATED */
- {ResolSat, Nop, ResPending, Nop, ResolSat, Nop, ResClosing, Closein, Broken, Closefail, SendingSat, Start, Unresable, Closefail, Resolving, Nop},
-
- /* CONNECTED */
- {Connected, Nop, Sending, Start, SendingSat, Start, Closed, Closeio, Broken, Closeio, Connected, Nop, Disconned, Nop, Connected, Nop},
-
- /* DISCONNECTED */
- {Disconned, Nop, Reconning, Connect, ReconSat, Connect, Closed, Closein, Broken, Closein, Connected, Nop, Disconned, Nop, Disconned, Nop},
-
- /* RECONNECTING */
- {Reconning, Nop, Reconning, Nop, ReconSat, Nop, ReconClosing, Closein, Broken, Closefail, Sending, Start, Broken, Closefail, Disconned, Nop},
-
- /* RECONSATURATED */
- {ReconSat, Nop, Reconning, Nop, ReconSat, Nop, ReconClosing, Closein, Broken, Closefail, SendingSat, Start, Broken, Closefail, Disconned, Nop},
-
- /* SENDING */
- {Sending, Nop, Sending, Nop, SendingSat, Nop, Closing, Closein, Disconning, Closeio, Sending, Nop, Reconning, Connect, Connected, Nop},
-
- /* SENDINGSATURATED*/
- {SendingSat, Nop, Sending, Nop, SendingSat, Nop, Closing, Closein, Disconning, Closeio, SendingSat, Nop, ReconSat, Connect, Connected, Nop},
-
- /* RESOLCLOSING */
- {ResClosing, Nop, ResClosing, Nop, ResClosing, Nop, ResClosing, Nop, Broken, Failall, Closing, Start, Unresable, Failall, ResClosing, Nop},
-
- /* RECONCLOSING */
- {ReconClosing, Nop, ReconClosing, Nop, ReconClosing, Nop, ReconClosing, Nop, Broken, Failall, Closing, Start, Broken, Failall, ReconClosing, Nop},
-
- /* CLOSING */
- {Closing, Nop, Closing, Nop, Closing, Nop, Closing, Nop, Disconning, Closeout, Closing, Nop, ReconClosing, Connect, Closed, Closeout},
-
- /* DISCONNECTING */
- {Disconning, Nop, Disconning, Nop, Disconning, Nop, Disconning, Nop, Disconning, Nop, Disconning, Nop, Broken, Failall, Broken, Nop},
-
- /* UNRESOLVABLE */
- {Unresable, Nop, Unresable, Nop, Unresable, Nop, Unresable, Nop, Unresable, Nop, Unresable, Closeout, Unresable, Nop, Unresable, Nop},
-
- /* CLOSED */
- {Closed, Nop, Closed, Nop, Closed, Nop, Closed, Nop, Closed, Nop, Closed, Closeout, Closed, Nop, Closed, Nop},
-
- /* BROKEN */
- {Broken, Nop, Broken, Nop, Broken, Nop, Broken, Nop, Broken, Nop, Broken, Closeout, Broken, Nop, Broken, Nop}
- };
-
- static {
- // install the transitions map in its proper place.
- Unresolved.init(INIT_TRANSITION_MAP[0]);
- ResPending.init(INIT_TRANSITION_MAP[1]);
- Resolving.init(INIT_TRANSITION_MAP[2]);
- ResolSat.init(INIT_TRANSITION_MAP[3]);
- Connected.init(INIT_TRANSITION_MAP[4]);
- Disconned.init(INIT_TRANSITION_MAP[5]);
- Reconning.init(INIT_TRANSITION_MAP[6]);
- ReconSat.init(INIT_TRANSITION_MAP[7]);
- Sending.init(INIT_TRANSITION_MAP[8]);
- SendingSat.init(INIT_TRANSITION_MAP[9]);
- ResClosing.init(INIT_TRANSITION_MAP[10]);
- ReconClosing.init(INIT_TRANSITION_MAP[11]);
- Closing.init(INIT_TRANSITION_MAP[12]);
- Disconning.init(INIT_TRANSITION_MAP[13]);
- Unresable.init(INIT_TRANSITION_MAP[14]);
- Closed.init(INIT_TRANSITION_MAP[15]);
- Broken.init(INIT_TRANSITION_MAP[16]);
- }
- }
-
- /**
- * The current state!
- */
- private volatile State state = null;
-
- /**
- * Constructs a new messenger state machine.
- *
- * The transition map is static and we refer to it only to grab the first
- * state. After that, states refer to each other. The only reason they are
- * members in the map is so that we can make references during init.
- *
- * @param connected If true, the initial state is {@link Messenger#CONNECTED} otherwise {@link Messenger#UNRESOLVED}.
- */
- protected MessengerState(boolean connected) {
-
- state = connected ? TransitionMap.Connected : TransitionMap.Unresolved;
- }
-
- /**
- * @return The current state.
- */
- public int getState() {
- // getState is always just a peek. It needs no sync.
- return state.number;
- }
-
- /**
- * Event input.
- */
- public void resolveEvent() {
- Action a = state.acResolve;
-
- state = state.stResolve;
- a.doIt(this);
- }
-
- /**
- * Message event
- */
- public void msgsEvent() {
- Action a = state.acMsgs;
-
- state = state.stMsgs;
- a.doIt(this);
- }
-
- /**
- * Saturated Event
- */
- public void saturatedEvent() {
- Action a = state.acSaturated;
-
- state = state.stSaturated;
- a.doIt(this);
- }
-
- /**
- * Close Event
- */
- public void closeEvent() {
- Action a = state.acClose;
-
- state = state.stClose;
- a.doIt(this);
- }
-
- /**
- * Shutdown Event
- */
- public void shutdownEvent() {
- Action a = state.acShutdown;
-
- state = state.stShutdown;
- a.doIt(this);
- }
-
- /**
- * Up Event
- */
- public void upEvent() {
- Action a = state.acUp;
-
- state = state.stUp;
- a.doIt(this);
- }
-
- /**
- * Down Event
- */
- public void downEvent() {
- Action a = state.acDown;
-
- state = state.stDown;
- a.doIt(this);
- }
-
- /**
- * Idle Event
- */
- public void idleEvent() {
- Action a = state.acIdle;
-
- state = state.stIdle;
- a.doIt(this);
- }
-
- /**
- * Actions they're always called in sequence by event methods.
- *
- * Actions must not call event methods in sequence.
- **/
-
- /**
- * Try to make a connection. Called whenever transitioning from a state that neither needs nor has a connection to a state
- * that needs a connection and does not have it. Call upEvent when successful, or downEvent when failed.
- */
- protected abstract void connectAction();
-
- /**
- * Start sending. Called whenever transitioning to a state that has both a connection and messages to send from a state that
- * lacked either attributes. So, will be called after sending stopped due to broken cnx or idle condition. Call downEvent
- * when stopping due to broken or closed connection, call {@link #idleEvent} when no pending message is left.
- */
- protected abstract void startAction();
-
- /**
- * Reject new messages from now on. Called whenever transitioning from a state that is {@link Messenger#USABLE} to a state
- * that is not. No event expected once done.
- */
- protected abstract void closeInputAction();
-
- /**
- * Drain pending messages, all failed. Called once output is down and there are still pending messages.
- * Call {@link #idleEvent} when done, as a normal result of no pending messages being left.
- */
- protected abstract void failAllAction();
-
- /**
- * Force close output. Called whenever the underlying connection is to be discarded and never to be needed again. That is
- * either because orderly close has completed, or shutdown is in progress. No event expected once done, but this action
- * must cause any sending in progress to stop eventually. The fact that the sending has stopped must be reported as
- * usual: either with a {@link #downEvent}, if the output closure caused the sending process to fail, or with an {@link
- * #idleEvent} if the sending of the last message could be sent successfully despite the attempt at interrupting it.
- *
- * Sending is said to be in progress if, and only if, the last call to startAction is more recent than the last call to
- * {@link #idleEvent} or {@link #downEvent}.
- *
- * It is advisable to also cancel an ongoing connect action, but not mandatory. If a {@link #connectAction} later succeeds,
- * then {@link #upEvent} must be called as usual. This will result in another call to {@link #closeOutputAction}.
- */
- protected abstract void closeOutputAction();
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/OutgoingMessageEvent.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/OutgoingMessageEvent.java
deleted file mode 100644
index 47133f16..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/OutgoingMessageEvent.java
+++ /dev/null
@@ -1,110 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.endpoint;
-
-/**
- * An event which provides notification of the the transmission status of an
- * outgoing message. The source of the event is the Message object.
- */
-public class OutgoingMessageEvent extends java.util.EventObject {
-
- // Two low-cost msg events for reporting to selectors: success does not require an exception. An exception is too expensive
- // for overflow. The message component is useless for select but we need a dummy src in order to construct an Event. Note,
- // to convert OVERFLOW or SUCCESS to listener-compatible events, clone them and set the message member. Other events are
- // already all right.
- public static final OutgoingMessageEvent SUCCESS = new OutgoingMessageEvent();
- public static final OutgoingMessageEvent OVERFLOW = new OutgoingMessageEvent();
-
- private Throwable failure = null;
-
- /**
- * Create an Outgoing Message Event with a dummy src (message
- * is not specified because the event is a constant).
- */
- public OutgoingMessageEvent() {
- super("Unspecified");
- }
-
- /**
- * Create an Outgoing Message Event.
- *
- * @param source the message for which the event is occurring.
- */
- public OutgoingMessageEvent(Message source) {
- super(source);
- }
-
- /**
- * Create an Outgoing Message Event.
- *
- * @param source The message for which the event is occurring.
- * @param failure The failure associated with this event.
- */
- public OutgoingMessageEvent(Message source, Throwable failure) {
- super(source);
- this.failure = failure;
- }
-
- /**
- * Get the failure associated with this event, if any.
- *
- * @return the Throwable associated with the failure, if any.
- * null if there was no associated failure.
- */
- public Throwable getFailure() {
- return failure;
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/OutgoingMessageEventListener.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/OutgoingMessageEventListener.java
deleted file mode 100644
index 9b458e14..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/OutgoingMessageEventListener.java
+++ /dev/null
@@ -1,95 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.endpoint;
-
-/**
- * A listener for events concerning the status of outgoing messages.
- */
-public interface OutgoingMessageEventListener extends java.util.EventListener {
-
- /**
- * The message identified by the event could not be sent.
- *
- * The cause of the failure, if any, is available from
- * {@link OutgoingMessageEvent#getFailure()}. Failures while sending
- * messages have several causes :
- *
- *
- * - An {@link java.io.IOException} means that the messenger cannot
- * send the message and the messenger will accept no further messages
- * to be sent.
- *
- * - A {@link java.lang.RuntimeException} mean that the message was
- * not sent, but retries may or may not be possible based upon the
- * status returned by {@link Messenger#isClosed()}.
- *
- * null means that the message was not sent, but may
- * be retried. Usually the failure is due to local resource limits
- * being exceeded. Attempts may be made to later resend the message,
- * usually after waiting for congestion to clear.
- * @param event the event
- */
- void messageSendFailed(OutgoingMessageEvent event);
-
- /**
- * The message identified by the event was successfully sent. Successfully
- * sending a message is not a guarantee that it will be successfully
- * received by the destination.
- * @param event the event
- */
- void messageSendSucceeded(OutgoingMessageEvent event);
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/StringMessageElement.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/StringMessageElement.java
deleted file mode 100644
index 43254243..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/StringMessageElement.java
+++ /dev/null
@@ -1,546 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.endpoint;
-
-
-import net.jxta.document.MimeMediaType;
-import net.jxta.logging.Logging;
-
-import java.io.ByteArrayInputStream;
-import java.io.IOException;
-import java.io.InputStream;
-import java.io.InputStreamReader;
-import java.io.OutputStream;
-import java.io.Reader;
-import java.io.StringReader;
-import java.io.UnsupportedEncodingException;
-import java.io.Writer;
-import java.lang.ref.SoftReference;
-import java.nio.ByteBuffer;
-import java.nio.CharBuffer;
-import java.nio.charset.Charset;
-import java.nio.charset.CharsetEncoder;
-import java.nio.charset.CoderResult;
-import java.nio.charset.CodingErrorAction;
-import java.util.logging.Level;
-import java.util.logging.Logger;
-
-
-/**
- * A Message Element using character strings for the element data.
- */
-public class StringMessageElement extends TextMessageElement {
-
- /**
- * Logger
- */
- private final static transient Logger LOG = Logger.getLogger(StringMessageElement.class.getName());
-
- /**
- * The MIME media type we will be use for encoding {@code String}s when no
- * encoding is specified.
- */
- private static final MimeMediaType DEFAULT_TEXT_ENCODING = new MimeMediaType(MimeMediaType.TEXT_DEFAULTENCODING, "charset=\"" + Charset.defaultCharset().name() + "\"", true).intern();
-
- /**
- * The data for this Message Element.
- */
- protected String data;
-
- /**
- * Returns an appropriate mime type for the given encoding name. The
- * mimetype will contain the canonical name of the encoding.
- *
- * @param encoding name of the desired encoding.
- * @return the mime type.
- * @throws java.io.UnsupportedEncodingException
- * if the mime is unsupported
- */
- private static MimeMediaType makeMimeType(String encoding) throws UnsupportedEncodingException {
- InputStreamReader getEncoding = new InputStreamReader(new ByteArrayInputStream(new byte[0]), encoding);
-
- String canonicalName = getEncoding.getEncoding();
-
- return new MimeMediaType(MimeMediaType.TEXT_DEFAULTENCODING, "charset=\"" + canonicalName + "\"", true).intern();
- }
-
- /**
- * Create a new Message Element from the provided String. The String will
- * be encoded for transmission using UTF-8.
- *
- * @param name Name of the Element. May be the empty string ("") or null if
- * the Element is not named.
- * @param value A String containing the contents of this element.
- * @param sig Message digest/digital signature element. If no signature is
- * to be specified, pass null.
- * @throws IllegalArgumentException if value is
- * null.
- */
- public StringMessageElement(String name, String value, MessageElement sig) {
- super(name, MimeMediaType.TEXTUTF8, sig);
-
- if (null == value) {
- throw new IllegalArgumentException("value must be non-null");
- }
-
- data = value;
- }
-
- /**
- * Create a new Message Element from the provided String. The string will
- * be encoded for transmission using specified character encoding.
- *
- * @param name Name of the MessageElement. May be the empty string ("") or
- * null if the MessageElement is not named.
- * @param value A String containing the contents of this element.
- * @param encoding Name of the character encoding to use. If
- * null then the system default character encoding will be
- * used. (Using the system default character encoding should be used with
- * extreme caution).
- * @param sig Message digest/digital signature element. If no signature is
- * to be specified, pass null.
- * @throws IllegalArgumentException if value is
- * null.
- * @throws UnsupportedEncodingException if the requested encoding is not
- * supported.
- */
- public StringMessageElement(String name, String value, String encoding, MessageElement sig) throws UnsupportedEncodingException {
- super(name, (null == encoding) ? DEFAULT_TEXT_ENCODING : makeMimeType(encoding), sig);
-
- if (null == value) {
- throw new IllegalArgumentException("value must be non-null");
- }
-
- data = value;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public boolean equals(Object target) {
- if (this == target) {
- return true;
- }
-
- if (target instanceof MessageElement) {
- if (!super.equals(target)) {
- return false;
- }
-
- if (target instanceof StringMessageElement) {
- StringMessageElement likeMe = (StringMessageElement) target;
-
- return data.equals(likeMe.data); // same chars?
- } else if (target instanceof TextMessageElement) {
- // have to do a slow char by char comparison. Still better than the stream since it saves encoding.
- // XXX 20020615 bondolo@jxta.org the performance of this could be much improved.
-
- TextMessageElement likeMe = (TextMessageElement) target;
-
- try {
- Reader myReader = getReader();
- Reader itsReader = likeMe.getReader();
-
- int mine;
- int its;
-
- do {
- mine = myReader.read();
- its = itsReader.read();
-
- if (mine != its) {
- return false;
- } // content didn't match
-
- } while ((-1 != mine) && (-1 != its));
-
- return ((-1 == mine) && (-1 == its)); // end at the same time?
- } catch (IOException fatal) {
- IllegalStateException failure = new IllegalStateException("MessageElements could not be compared.");
-
- failure.initCause(fatal);
- throw failure;
- }
- } else {
- // have to do a slow stream comparison.
- // XXX 20020615 bondolo@jxta.org the performance of this could be much improved.
-
- MessageElement likeMe = (MessageElement) target;
-
- try {
- InputStream myStream = getStream();
- InputStream itsStream = likeMe.getStream();
-
- int mine;
- int its;
-
- do {
- mine = myStream.read();
- its = itsStream.read();
-
- if (mine != its) {
- return false;
- } // content didn't match
-
- } while ((-1 != mine) && (-1 != its));
-
- return ((-1 == mine) && (-1 == its)); // end at the same time?
- } catch (IOException fatal) {
- IllegalStateException failure = new IllegalStateException("MessageElements could not be compared.");
-
- failure.initCause(fatal);
- throw failure;
- }
- }
- }
-
- return false; // not a new message element
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public int hashCode() {
- int result = super.hashCode() * 6037 + // a prime
- data.hashCode();
-
- return result;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public String toString() {
- return data;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public synchronized byte[] getBytes(boolean copy) {
- byte[] cachedBytes = null;
-
- if (null != cachedGetBytes) {
- cachedBytes = cachedGetBytes.get();
- }
-
- if (null == cachedBytes) {
- if (Logging.SHOW_FINER && LOG.isLoggable(Level.FINER)) {
- LOG.finer(
- "Creating getBytes of " + getClass().getName() + '@' + Integer.toHexString(System.identityHashCode(this)));
- }
-
- String charset = type.getParameter("charset");
-
- try {
- cachedBytes = data.getBytes(charset);
- } catch (UnsupportedEncodingException caught) {
- if (Logging.SHOW_WARNING && LOG.isLoggable(Level.WARNING)) {
- LOG.log(Level.WARNING, "MessageElement Data could not be generated", caught);
- }
- IllegalStateException failure = new IllegalStateException("MessageElement Data could not be generated");
-
- failure.initCause(caught);
- throw failure;
- }
-
- cachedGetBytes = new SoftReference(cachedBytes);
- }
-
- if (!copy) {
- return cachedBytes;
- }
-
- byte[] bytesCopy = cachedBytes.clone();
-
- return bytesCopy;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public long getCharLength() {
- return data.length();
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public synchronized char[] getChars(boolean copy) {
- char[] cachedChars = null;
-
- if (null != cachedGetChars) {
- cachedChars = cachedGetChars.get();
- }
-
- if (null == cachedChars) {
- if (Logging.SHOW_FINER && LOG.isLoggable(Level.FINER)) {
- LOG.finer("creating cachedGetChars of " + getClass().getName() + '@' + Integer.toHexString(hashCode()));
- }
-
- cachedChars = new char[data.length()];
-
- data.getChars(0, data.length(), cachedChars, 0);
-
- // if this is supposed to be a shared buffer then we can cache it.
-
- cachedGetChars = new SoftReference(cachedChars);
- }
-
- if (!copy) {
- return cachedChars;
- }
-
- char[] copyChars = cachedChars.clone();
-
- return copyChars;
- }
-
- /**
- * {@inheritDoc}
- */
- public InputStream getStream() throws IOException {
- byte cachedBytes[] = null;
-
- synchronized (this) {
- if (null != cachedGetBytes) {
- cachedBytes = cachedGetBytes.get();
- }
- }
-
- if (null != cachedBytes) {
- return new ByteArrayInputStream(cachedBytes);
- } else {
- String charset = type.getParameter("charset");
- return new CharSequenceInputStream(data, charset);
- }
- }
-
- /**
- * {@inheritDoc}
- *
- * @return InputStream of the stream containing element data.
- * @throws IOException when there is a problem getting a reader.
- */
- public Reader getReader() throws IOException {
-
- return new StringReader(data);
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public void sendToStream(OutputStream sendTo) throws IOException {
-
- sendTo.write(getBytes(false));
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public void sendToWriter(Writer sendTo) throws IOException {
- sendTo.write(data);
- }
-
- /**
- *
- **/
- private static class CharSequenceInputStream extends InputStream {
-
- private final CharBuffer charData;
-
- private final CharsetEncoder conversion;
-
- private boolean marked = false;
- private byte mark_multiByteChar[];
- private int mark_position;
-
- private byte multiByteChar[];
- private int position;
-
- /**
- * @param s the char sequence
- * @param encoding the charset encoding
- */
- CharSequenceInputStream(CharSequence s, String encoding) {
- charData = CharBuffer.wrap(s);
-
- Charset encodingCharset = Charset.forName(encoding);
-
- conversion = encodingCharset.newEncoder();
- conversion.onMalformedInput(CodingErrorAction.REPLACE);
- conversion.onUnmappableCharacter(CodingErrorAction.REPLACE);
-
- int maxBytes = new Float(conversion.maxBytesPerChar()).intValue();
-
- multiByteChar = new byte[maxBytes];
- position = multiByteChar.length;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public void mark(int ignored) {
- charData.mark();
- mark_multiByteChar = multiByteChar.clone();
- mark_position = position;
- marked = true;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public boolean markSupported() {
- return true;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public void reset() throws IOException {
-
- if (!marked) {
- throw new IOException("reset() called before mark()");
- }
-
- charData.reset();
- multiByteChar = mark_multiByteChar.clone();
- position = mark_position;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public int read() throws IOException {
- // prefill the buffer
- while (multiByteChar.length == position) {
- int readsome = read(multiByteChar, 0, multiByteChar.length);
-
- if (-1 == readsome) {
- return -1;
- }
-
- position = multiByteChar.length - readsome;
-
- if ((0 != position) && (0 != readsome)) {
- System.arraycopy(multiByteChar, 0, multiByteChar, position, readsome);
- }
- }
-
- return (multiByteChar[position++] & 0xFF);
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public int read(byte[] buffer) throws IOException {
- return read(buffer, 0, buffer.length);
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public int read(byte[] buffer, int offset, int length) throws IOException {
- // handle partial characters;
- if (multiByteChar.length != position) {
- int copying = Math.min(length, multiByteChar.length - position);
-
- System.arraycopy(multiByteChar, position, buffer, offset, copying);
- position += copying;
- return copying;
- }
-
- ByteBuffer bb = ByteBuffer.wrap(buffer, offset, length);
-
- int before = bb.remaining();
-
- CoderResult result = conversion.encode(charData, bb, true);
-
- int readin = before - bb.remaining();
-
- if (CoderResult.UNDERFLOW == result) {
- if (0 == readin) {
- return -1;
- } else {
- return readin;
- }
- }
-
- if (CoderResult.OVERFLOW == result) {
- return readin;
- }
-
- result.throwException();
-
- // NEVERREACHED
- return 0;
- }
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/TextDocumentMessageElement.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/TextDocumentMessageElement.java
deleted file mode 100644
index 763c257d..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/TextDocumentMessageElement.java
+++ /dev/null
@@ -1,358 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.endpoint;
-
-
-import net.jxta.document.MimeMediaType;
-import net.jxta.document.TextDocument;
-import net.jxta.logging.Logging;
-
-import java.io.ByteArrayInputStream;
-import java.io.IOException;
-import java.io.InputStream;
-import java.io.OutputStream;
-import java.io.Reader;
-import java.io.UnsupportedEncodingException;
-import java.io.Writer;
-import java.lang.ref.SoftReference;
-import java.util.logging.Level;
-import java.util.logging.Logger;
-
-
-/**
- * A Message Element using JXTA TextDocument for the element data.
- */
-public class TextDocumentMessageElement extends TextMessageElement {
-
- /**
- * Log4J Logger
- */
- private static final Logger LOG = Logger.getLogger(TextDocumentMessageElement.class.getName());
-
- /**
- * The data for this element.
- */
- protected TextDocument doc;
-
- /**
- * Create a new Message Element from the provided Document.
- *
- * @param name Name of the Element. May be the empty string ("") or null if
- * the Element is not named.
- * @param doc A Document containing the contents of this element.
- * @param sig optional message digest/digital signature elemnent. If
- * no signature is to be specified, pass null.
- */
- public TextDocumentMessageElement(String name, TextDocument doc, MessageElement sig) {
- super(name, doc.getMimeType(), sig);
-
- this.doc = doc;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public boolean equals(Object target) {
- if (this == target) {
- return true;
- }
-
- if (target instanceof MessageElement) {
- if (!super.equals(target)) {
- return false;
- }
-
- if (target instanceof TextMessageElement) {
- // have to do a slow char by char comparison. Still better than the stream since it saves encoding.
- // XXX 20020615 bondolo@jxta.org the performance of this could be much improved.
-
- TextMessageElement likeMe = (TextMessageElement) target;
-
- try {
- Reader myReader = getReader();
- Reader itsReader = likeMe.getReader();
-
- int mine;
- int its;
-
- do {
- mine = myReader.read();
- its = itsReader.read();
-
- if (mine != its) {
- return false;
- } // content didn't match
-
- } while ((-1 != mine) && (-1 != its));
-
- return ((-1 == mine) && (-1 == its)); // end at the same time?
- } catch (IOException fatal) {
- throw new IllegalStateException("MessageElements could not be compared." + fatal);
- }
- } else {
- // have to do a slow stream comparison.
- // XXX 20020615 bondolo@jxta.org the performance of this could be much improved.
-
- MessageElement likeMe = (MessageElement) target;
-
- try {
- InputStream myStream = getStream();
- InputStream itsStream = likeMe.getStream();
-
- int mine;
- int its;
-
- do {
- mine = myStream.read();
- its = itsStream.read();
-
- if (mine != its) {
- return false;
- } // content didn't match
-
- } while ((-1 != mine) && (-1 != its));
-
- return ((-1 == mine) && (-1 == its)); // end at the same time?
- } catch (IOException fatal) {
- throw new IllegalStateException("MessageElements could not be compared." + fatal);
- }
- }
- }
-
- return false; // not a new message element
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public int hashCode() {
- int result = super.hashCode() * 6037 + // a prime
- toString().hashCode();
-
- return result;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public synchronized String toString() {
- String result;
-
- if (null != cachedToString) {
- result = cachedToString.get();
-
- if (null != result) {
- return result;
- }
- }
-
- if (Logging.SHOW_FINER && LOG.isLoggable(Level.FINER)) {
- LOG.finer("creating toString of " + getClass().getName() + "@" + super.hashCode());
- }
-
- result = doc.toString();
- cachedToString = new SoftReference(result);
- return result;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public MimeMediaType getMimeType() {
- return doc.getMimeType();
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public String getFileExtension() {
- return doc.getFileExtension();
- }
-
- /**
- * {@inheritDoc}
- */
- public InputStream getStream() throws IOException {
- byte[] sending = getBytes(false);
-
- return new ByteArrayInputStream(sending);
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public void sendToStream(OutputStream sendTo) throws IOException {
-
- byte[] sending = getBytes(false);
-
- sendTo.write(sending, 0, sending.length);
- }
-
- /**
- * {@inheritDoc}
- */
- public Reader getReader() throws IOException {
-
- return doc.getReader();
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public void sendToWriter(Writer sendTo) throws IOException {
- doc.sendToWriter(sendTo);
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public byte[] getBytes(boolean copy) {
- byte[] result;
-
- if (null != cachedGetBytes) {
- result = cachedGetBytes.get();
-
- if (null != result) {
- if (copy) {
- byte[] theCopy = new byte[result.length];
-
- System.arraycopy(theCopy, 0, result, 0, result.length);
- } else {
- return result;
- }
- }
- }
-
- if (Logging.SHOW_FINER && LOG.isLoggable(Level.FINER)) {
- LOG.finer("creating getBytes of " + getClass().getName() + '@' + Integer.toHexString(hashCode()));
- }
-
- String charset = type.getParameter("charset");
-
- if (null == charset) {
- result = toString().getBytes();
- } else {
- try {
- result = toString().getBytes(charset);
- } catch (UnsupportedEncodingException caught) {
- if (Logging.SHOW_WARNING && LOG.isLoggable(Level.WARNING)) {
- LOG.log(Level.WARNING, "MessageElement Data could not be generated", caught);
- }
- throw new IllegalStateException("MessageElement Data could not be generated due to " + caught.getMessage());
- }
- }
-
- // if this is supposed to be a shared buffer then we can cache it.
- if (!copy) {
- cachedGetBytes = new SoftReference(result);
- }
-
- return result;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public long getCharLength() {
- return toString().length();
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- public char[] getChars(boolean copy) {
- char[] result;
-
- if (null != cachedGetChars) {
- result = cachedGetChars.get();
-
- if (null != result) {
- if (copy) {
- char[] theCopy = new char[result.length];
-
- System.arraycopy(theCopy, 0, result, 0, result.length);
- } else {
- return result;
- }
- }
- }
-
- if (Logging.SHOW_FINER && LOG.isLoggable(Level.FINER)) {
- LOG.finer("creating getChars of " + getClass().getName() + '@' + Integer.toHexString(hashCode()));
- }
-
- String asString = toString();
-
- result = asString.toCharArray();
-
- // if this is supposed to be a shared buffer then we can cache it.
- if (!copy) {
- cachedGetChars = new SoftReference(result);
- }
-
- return result;
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/TextMessageElement.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/TextMessageElement.java
deleted file mode 100644
index 4f866a1d..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/TextMessageElement.java
+++ /dev/null
@@ -1,316 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.endpoint;
-
-
-import net.jxta.document.MimeMediaType;
-import net.jxta.document.TextDocument;
-import net.jxta.logging.Logging;
-import net.jxta.util.CountingWriter;
-import net.jxta.util.DevNullWriter;
-
-import java.io.IOException;
-import java.io.Reader;
-import java.io.Writer;
-import java.lang.ref.SoftReference;
-import java.util.logging.Level;
-import java.util.logging.Logger;
-
-
-/**
- * An extension of MessageElement for managing elements that are composed of
- * character text. (as opposed to raw bytes).
- *
- * The data contained within a {@code TextMessageElement} is accessible in three
- * additional ways to those provided by {@code MessageElement} :
- *
- *
- * - As an {@link java.io.Reader} from {@link #getReader()}
- * - Sending the data a {@link java.io.Writer} via {@link #sendToWriter(Writer)}
- * - As a char array from from {@link #getChars(boolean)}
- *
- *
- */
-public abstract class TextMessageElement extends MessageElement implements TextDocument {
-
- /**
- * Log4J Logger
- */
- private static final Logger LOG = Logger.getLogger(TextMessageElement.class.getName());
-
- /**
- * cached result of {@link #getCharLength()} operation.
- */
- protected transient long cachedGetCharLength = -1;
-
- /**
- * cached result of {@link #getBytes(boolean)} operation.
- */
- protected transient SoftReference cachedGetChars = null;
-
- /**
- * Internal constructor for initializaing everything but the data.
- *
- * @param name Name of the Element. May be the empty string ("") if
- * the Element is not named.
- * @param type Type of the Element. null is equivalent to specifying
- * the type "Application/Octet-stream"
- * @param sig optional message digest/digital signature elemnent. If
- * no signature is to be specified, pass null.
- */
- protected TextMessageElement(String name, MimeMediaType type, MessageElement sig) {
- super(name, type, sig);
- }
-
- /**
- * {@inheritDoc}
- *
- * synchronized for caching purposes.
- */
- @Override
- public synchronized String toString() {
- String result;
-
- if (null != cachedToString) {
- result = cachedToString.get();
-
- if (null != result) {
- return result;
- }
- }
-
- if (Logging.SHOW_FINE && LOG.isLoggable(Level.FINE)) {
- LOG.fine("creating toString of " + getClass().getName() + '@' + Integer.toHexString(hashCode()));
- }
-
- StringBuilder theString = new StringBuilder();
-
- try {
- Reader asString = getReader();
- char[] characters = new char[256];
-
- do {
- int res = asString.read(characters);
-
- if (res < 0) {
- break;
- }
-
- theString.append(characters, 0, res);
- } while (true);
-
- result = theString.toString();
-
- cachedToString = new SoftReference(result);
- return result;
- } catch (IOException caught) {
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE, "Could not generate string for element. ", caught);
- }
-
- throw new IllegalStateException("Could not generate string for element. " + caught);
- }
- }
-
- /**
- * {@inheritDoc}
- *
- * We use the "text" extension and leave it to sub-classes to extend
- * this.
- */
- @Override
- public String getFileExtension() {
- return "txt";
- }
-
- /**
- * Returns the size of the element data in characters
- *
- * synchronized for caching purposes.
- *
- * @return long containing the size of the element data.
- */
- public synchronized long getCharLength() {
- if (cachedGetCharLength >= 0) {
- return cachedGetCharLength;
- }
-
- CountingWriter countChars = new CountingWriter(new DevNullWriter());
-
- try {
- sendToWriter(countChars);
- cachedGetByteLength = countChars.getCharsWritten();
- return cachedGetByteLength;
- } catch (IOException caught) {
- throw new IllegalStateException("Could not get length of element : " + caught.toString());
- }
- }
-
- /**
- * Returns a char array which contains the element data. The char array
- * returned may be shared amongst all copies of the element,
- * do not modify it. The copy parameter allows you to request a
- * private, modifiable copy of the element data.
- *
- * synchronized for caching purposes.
- *
- * @param copy return a copy if true
- * @return char[] Contents of message element.
- */
- public synchronized char[] getChars(boolean copy) {
- char[] result;
-
- if (null != cachedGetChars) {
- result = cachedGetChars.get();
-
- if (null != result) {
- if (copy) {
- char[] theCopy = new char[result.length];
-
- System.arraycopy(theCopy, 0, result, 0, result.length);
- } else {
- return result;
- }
- }
- }
-
- if (Logging.SHOW_FINE && LOG.isLoggable(Level.FINE)) {
- LOG.fine("creating getChars of " + getClass().getName() + '@' + Integer.toHexString(hashCode()));
- }
-
- long len = getCharLength();
-
- if (len > Integer.MAX_VALUE) {
- throw new IllegalStateException("MessageElement is too large to be stored in a char array.");
- }
-
- result = new char[(int) len];
-
- try {
- Reader reader = getReader();
-
- int toRead = (int) len;
- int offset = 0;
-
- do {
- int read = reader.read(result, offset, toRead);
-
- if (-1 == read) {
- break;
- }
-
- toRead -= read;
- offset += read;
- } while (toRead < len);
-
- if (toRead != 0) {
- IOException failure = new IOException("Unexpected EOF");
-
- if (Logging.SHOW_WARNING && LOG.isLoggable(Level.WARNING)) {
- LOG.log(Level.WARNING, failure.getMessage(), failure);
- }
-
- throw failure;
- }
- } catch (IOException caught) {
- IllegalStateException failure = new IllegalStateException("Failed to get bytes of Message Element");
-
- if (Logging.SHOW_WARNING && LOG.isLoggable(Level.WARNING)) {
- LOG.log(Level.WARNING, failure.getMessage(), caught);
- }
- throw failure;
- }
-
- // if this is supposed to be a shared buffer then we can cache it.
- if (!copy) {
- cachedGetChars = new SoftReference(result);
- }
-
- return result;
- }
-
- /**
- * {@inheritDoc}
- *
- * This version probably has sub-optimal performance. Sub-classes
- * should override this implementation if possible.
- */
- public void sendToWriter(Writer sendTo) throws IOException {
- copyReaderToWriter(getReader(), sendTo);
- }
-
- /**
- * Copies a reader to a writer with buffering.
- *
- * @param source The reader to copy from.
- * @param sink The writer to send the data to.
- * @throws IOException if there is a problem copying the data
- */
- private void copyReaderToWriter(Reader source, Writer sink) throws IOException {
- int c;
- char[] buf = new char[4096];
-
- do {
- c = source.read(buf);
-
- if (-1 == c) {
- break;
- }
-
- sink.write(buf, 0, c);
- } while (true);
- }
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/ThreadedMessenger.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/ThreadedMessenger.java
deleted file mode 100644
index 995c7570..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/ThreadedMessenger.java
+++ /dev/null
@@ -1,800 +0,0 @@
-/*
- * Copyright (c) 2004-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.endpoint;
-
-import net.jxta.logging.Logging;
-import net.jxta.peergroup.PeerGroupID;
-
-import java.io.IOException;
-import java.util.WeakHashMap;
-import java.util.concurrent.BlockingQueue;
-import java.util.concurrent.LinkedBlockingQueue;
-import java.util.logging.Level;
-import java.util.logging.Logger;
-
-/**
- * This is a messenger meant to be shared by multiple channels and automatically
- * distribute the available bandwidth among the channels. This one is implemented
- * with a dedicated background thread.
- */
-public abstract class ThreadedMessenger extends AbstractMessenger implements Runnable {
-
- /**
- * Logger
- */
- private final static transient Logger LOG = Logger.getLogger(ThreadedMessenger.class.getName());
-
- /**
- * Our thread group.
- */
- private final static transient ThreadGroup myThreadGroup = new ThreadGroup("Threaded Messengers");
-
- /**
- * The logical destination address of the other party (if we know it).
- */
- private volatile EndpointAddress logicalDestination = null;
-
- /**
- * true if we have deliberately closed our input queue.
- */
- private volatile boolean inputClosed = false;
-
- /**
- * Need to know which group the transports we use live in, so that we can suppress channel redirection when in the same group.
- * This is currently the norm.
- */
- private PeerGroupID homeGroupID = null;
-
- /**
- * The duration in milliseconds which the background thread will remain
- * idle before quitting.
- */
- private static final long THREAD_IDLE_DEAD = 15000;
-
- /*
- * Actions that we defer to after returning from event methods. In other
- * words, they cannot be done with the lock held, or they require calling
- * more event methods. Because this messenger can take only one message at a
- * time, actions do not cascade much. It may happen that the invoking thread
- * is required to perform closure after performing send. That's about it.
- * In addition, there's always only one deferred action per event. The only
- * actions that cluster are closeInput and closeOutput. We do not defer
- * those.
- */
- private enum DeferredAction {
-
- /**
- * No action deferred.
- */
- ACTION_NONE,
-
- /**
- * Must send the current message.
- */
- ACTION_SEND,
-
- /**
- * Must report failure to connect.
- */
- ACTION_CONNECT
- }
-
- /**
- * The current deferred action.
- */
- private DeferredAction deferredAction = DeferredAction.ACTION_NONE;
-
- /**
- * The current background thread.
- */
- private volatile Thread bgThread = null;
-
- /**
- * The number of messages which may be queued for in each channel.
- */
- private final int channelQueueSize;
-
- /**
- * The active channel queue.
- */
- private final BlockingQueue activeChannels = new LinkedBlockingQueue();
-
- /**
- * The resolving channels set. This is unordered. We use a weak hash map because abandoned channels could otherwise
- * accumulate in-there until the resolution attempt completes. A buggy application could easily do much damage.
- *
- * Note: a channel with at least one message in it is not considered abandoned. To prevent it from disappearing we set a
- * strong reference as the value in the map. A buggy application can do great damage, still, by queuing a single message
- * and then abandoning the channel. This is has to be dealt with at another level; limiting the number of channels
- * per application, or having a global limit on messages...TBD.
- */
- private final WeakHashMap resolvingChannels = new WeakHashMap(4);
-
- /**
- * A default channel where we put messages that are send directly through
- * this messenger rather than via one of its channels.
- */
- private ThreadedMessengerChannel defaultChannel = null;
-
- /**
- * State lock and engine.
- */
- private final ThreadedMessengerState stateMachine = new ThreadedMessengerState();
-
- /**
- * The implementation of channel messenger that getChannelMessenger returns:
- */
- private class ThreadedMessengerChannel extends AsyncChannelMessenger {
-
- public ThreadedMessengerChannel(EndpointAddress baseAddress, PeerGroupID redirection, String origService, String origServiceParam, int queueSize, boolean connected) {
- super(baseAddress, redirection, origService, origServiceParam, queueSize, connected);
- }
-
- /**
- * {@inheritDoc}
- *
- * We're supposed to return the complete destination, including
- * service and param specific to that channel. It is not clear, whether
- * this should include the cross-group mangling, though. Historically,
- * it does not.
- */
- public EndpointAddress getLogicalDestinationAddress() {
- return logicalDestination;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected void startImpl() {
- if (!addToActiveChannels(this)) {
- // We do not need to hold our lock to call this, and it is just as well since it could re-enter.
- down();
- }
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected void connectImpl() {
-
- // If it cannot be done, it is because we known that we will never be able to generate the resulting event. That means
- // that either the shared messenger is already resolved, or that it is already dead. In that case, we invoke down/up
- // in sequence accordingly.
- //
- // NOTE: the shared messenger may become dead 1 ns from now...that or 1 hour makes no difference, the channel will
- // notice when it first tries to send, in that case. The otherway around is more obvious: If the shared messenger is
- // not USABLE, it cannot come back.
- //
- // addToResolvingChannels() garantees us that if it returns true, either of the channel's down or up methods will be
- // invoked at some point.
-
- if (!addToResolvingChannels(this)) {
- if ((ThreadedMessenger.this.getState() & USABLE) != 0) {
- up();
- } else {
- down();
- }
- }
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected void resolPendingImpl() {
- // If this channel is still among the ones pending resolution, make sure
- // it becomes strongly referenced.
- strongRefResolvingChannel(this);
- }
-
- }
-
-
- /**
- * Our statemachine implementation; just connects the standard AbstractMessengerState action methods to
- * this object.
- */
- private class ThreadedMessengerState extends MessengerState {
-
- protected ThreadedMessengerState() {
- super(false);
- }
-
- /*
- * The required action methods.
- */
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected void connectAction() {
- deferAction(DeferredAction.ACTION_CONNECT);
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected void startAction() {
- deferAction(DeferredAction.ACTION_SEND);
- }
-
- /**
- * {@inheritDoc}
- *
- * This is a synchronous action. The state machine assumes that it
- * is done when we return. There is No need (nor means) to signal
- * completion. No need for synchronization either: we're already
- * synchronized.
- */
- @Override
- protected void closeInputAction() {
- inputClosed = true;
- ThreadedMessengerChannel[] channels = resolvingChannels.keySet().toArray(new ThreadedMessengerChannel[0]);
-
- resolvingChannels.clear();
- int i = channels.length;
-
- while (i-- > 0) {
- channels[i].down();
- }
- channels = null;
- }
-
- /**
- * {@inheritDoc}
- */
- @Override
- protected void closeOutputAction() {
- // This will break the cnx; thereby causing a down event if we have a send in progress.
- // If the cnx does not break before the current message is sent, then the message will be sent successfully,
- // resulting in an idle event. Either of these events is enough to complete the shutdown process.
- closeImpl();
- }
-
- /**
- * {@inheritDoc}
- *
- * The input is now closed, so we can rest assured that the last
- * channel is really the last one.
- * This is a synchronous action. The state machine assumes that it is
- * done when we return. There is no need to signal completion with an
- * idleEvent.
- * No need for synchronization either: we're already synchronized.
- */
- @Override
- protected void failAllAction() {
-
- while (true) {
- ThreadedMessengerChannel theChannel;
-
- theChannel = activeChannels.poll();
- if (theChannel == null) {
- break;
- }
- theChannel.down();
- }
- }
- }
-
- /**
- * Create a new ThreadedMessenger.
- *
- * @param homeGroupID the group that this messenger works for. This is the group of the endpoint service or transport
- * that created this messenger.
- * @param destination where messages should be addressed to
- * @param logicalDestination the expected logical address of the destination. Pass null if unknown/irrelevant
- * @param channelQueueSize The queue size that channels should have.
- */
- public ThreadedMessenger(PeerGroupID homeGroupID, EndpointAddress destination, EndpointAddress logicalDestination, int channelQueueSize) {
-
- super(destination);
-
- this.homeGroupID = homeGroupID;
-
- // We tell our super class that we synchronize our state on the stateMachine object. Logic would dictate
- // that we pass it to super(), but it is not itself constructed until super() returns. No way around it.
-
- setStateLock(stateMachine);
-
- this.logicalDestination = logicalDestination;
- this.channelQueueSize = channelQueueSize;
- }
-
- /**
- * Runs the state machine until there's nothing left to do.
- *
- * Three exposed methods may need to inject new events in the system: sendMessageN, close, and shutdown. Since they can both
- * cause actions, and since connectAction and startAction are deferred, it seems possible that one of the
- * actions caused by send, close, or shutdown be called while connectAction or startAction are in progress.
- *
- * However, the state machine gives us a few guarantees: All the actions except closeInput and closeOutput have an *end*
- * event. No state transition that results in an action other than closeInput or closeOutput, may occur until the end event
- * for an on-going action has been called.
- *
- * We perform closeInput and closeOutput on the fly, so none of the exposed methods are capable of producing deferred actions
- * while an action is already deferred. So, there is at most one deferred action after returning from an event method,
- * regardless the number of concurrent threads invoking the exposed methods, and it can only happen once per deferred action
- * performed.
- */
- public void run() {
-
- try {
- while (true) {
- switch (nextAction()) {
- case ACTION_NONE:
- return;
-
- case ACTION_SEND:
- send();
- break;
-
- case ACTION_CONNECT:
- connect();
- break;
- }
- }
- } catch (Throwable any) {
- if (Logging.SHOW_SEVERE && LOG.isLoggable(Level.SEVERE)) {
- LOG.log(Level.SEVERE, "Uncaught throwable in background thread", any);
- // Hope the next thread has more luck. It'll need it.
- }
- } finally {
- synchronized (stateMachine) {
- bgThread = null;
- }
- }
- }
-
- private void deferAction(DeferredAction action) {
- deferredAction = action;
-
- if (bgThread == null) {
- bgThread = new Thread(myThreadGroup, this, "ThreadedMessenger for " + getDestinationAddress());
- bgThread.setDaemon(true);
- bgThread.start();
- }
- }
-
- private DeferredAction nextAction() {
-
- long quitAt = System.currentTimeMillis() + THREAD_IDLE_DEAD;
-
- synchronized (stateMachine) {
- while (deferredAction == DeferredAction.ACTION_NONE) {
- // Still nothing to do. Is it time to quit, or where we just awakened for nothing ?
- if (System.currentTimeMillis() > quitAt) {
- // Ok. Time to quit.
- return DeferredAction.ACTION_NONE;
- }
-
- // We do not need to wakeup exactly on the deadline, so there's no need to
- // recompute the deadline. THREAD_IDLE_DEAD is comparatively short.
- try {
- stateMachine.wait(THREAD_IDLE_DEAD);
- } catch (InterruptedException ie) {
- // Only shutdown can force termination.
- Thread.interrupted();
- }
- }
-
- DeferredAction action = deferredAction;
-
- deferredAction = DeferredAction.ACTION_NONE;
- return action;
- }
- }
-
- /**
- * Performs the ACTION_SEND deferred action: sends the messages in our channel queues until there's none left or
- * we are forced to stop by connection breakage.
- * @throws InterruptedException if interrupted
- */
- private void send() throws InterruptedException {
-
- ThreadedMessengerChannel theChannel;
-
- synchronized (stateMachine) {
- theChannel = activeChannels.peek();
- if (theChannel == null) {
- // No notifyChange: this is defensive code. NotifyChange() should have been called already.
- stateMachine.idleEvent();
- stateMachine.notifyAll();
- return;
- }
- }
-
- while (true) {
- AsyncChannelMessenger.PendingMessage theMsg = theChannel.peek();
-
- if (theMsg == null) {
- // done with that channel for now. (And it knows it). Move to the next channel. Actually
- // it should have been removed when we popped the last message, except if we went down upon sending it.
- // In that later case, we leave the channel queue as is so that we cannot have to report, idle
- // in the same time than down.
- synchronized (stateMachine) {
- activeChannels.poll();
- theChannel = activeChannels.peek();
- if (theChannel != null) {
- continue; // Nothing changes; we do not call msgsEvent because we never call saturatedEvent either.
- }
- // Done with all channels. We're now idle.
-
- stateMachine.idleEvent();
- stateMachine.notifyAll();
- }
- notifyChange();
- return;
- }
-
- Message currentMsg = theMsg.msg;
- String currentService = theMsg.service;
- String currentParam = theMsg.param;
-
- try {
- sendMessageBImpl(currentMsg, currentService, currentParam);
- } catch (Throwable any) {
-
- // When the current message fails, we leave it in there. sendMessageBImpl does not report failures. So that we can retry if
- // applicable. It is up to us to report failures. See failall in AsyncChannel. However, there is a risk that a bad
- // message causes this messenger to go down repeatedly. We need some kind of safeguard. So, if there's already a failure
- // recorded for this message, we bounce it.
- synchronized (stateMachine) {
- if (theMsg.failure != null) {
- theChannel.poll();
- currentMsg.setMessageProperty(Messenger.class, new OutgoingMessageEvent(currentMsg, theMsg.failure));
- } else {
- theMsg.failure = any;
- }
- stateMachine.downEvent();
- stateMachine.notifyAll();
- }
- notifyChange();
- return;
- }
-
- synchronized (stateMachine) {
- // Remove the message sent
- theChannel.poll();
- // Rotate the queues (Things are quite a bit simpler if there's a single still active channel
- // and it's frequent, so it's worth checking)
- boolean empty = (theChannel.peek() == null);
-
- if ((activeChannels.size() != 1) || empty) {
- activeChannels.poll();
- if (!empty) {
- // We're not done with that channel. Put it back at the end
- activeChannels.put(theChannel);
- }
-
- // Get the next channel.
- theChannel = activeChannels.peek();
- if (theChannel == null) {
- // Done with all channels. We're now idle.
- stateMachine.idleEvent();
- stateMachine.notifyAll();
- }
- } // else {continue to use the current channel}
- }
-
- if (theChannel == null) {
- notifyChange();
- // We're about to go wait(). Yielding is a good bet. It is
- // very inexpenssive and may be all it takes to get a new job
- // queued.
- Thread.yield();
- return;
- }
- }
- }
-
- /**
- * Performs the ACTION_CONNECT deferred action. Generates a down event if it does not work.
- */
- private void connect() {
- boolean worked = connectImpl();
- ThreadedMessengerChannel[] channels = null;
-
- synchronized (stateMachine) {
- if (worked) {
-
- // we can now get the logical destination from the underlying implementation (likely obtained from a transport
- // messenger)
-
- EndpointAddress effectiveLogicalDest = getLogicalDestinationImpl();
-
- if (logicalDestination == null) {
- // We did not know what was supposed to be on the other side. Anything will do.
- logicalDestination = effectiveLogicalDest;
- stateMachine.upEvent();
- channels = resolvingChannels.keySet().toArray(new ThreadedMessengerChannel[0]);
- resolvingChannels.clear();
- } else if (logicalDestination.equals(effectiveLogicalDest)) {
- // Good. It's what we expected.
- stateMachine.upEvent();
-
- channels = resolvingChannels.keySet().toArray(new ThreadedMessengerChannel[0]);
- resolvingChannels.clear();
- } else {
- // Ooops, not what we wanted. Can't connect then. (force close the underlying cnx).
- closeImpl();
- stateMachine.downEvent();
- }
-
- } else {
- stateMachine.downEvent();
- }
- stateMachine.notifyAll();
- }
-
- // If it worked, we need to tell all the channels that were waiting for resolution.
- // If it did not work, the outcome depends upon what will happen after the down event.
- // It's ok to do that outside of sync. Channel.up may synchronize, but it never calls
- // this class while synchronized.
- if (channels != null) {
-
- int i = channels.length;
-
- while (i-- > 0) {
- channels[i].up();
- }
- channels = null;
- }
-
- notifyChange();
- }
-
- /*
- * Messenger API top level methods.
- */
-
- /**
- * The endpoint service may call this to cause an orderly closure of its messengers.
- */
- protected final void shutdown() {
- synchronized (stateMachine) {
- stateMachine.shutdownEvent();
- stateMachine.notifyAll();
- }
- notifyChange();
- }
-
- /**
- * {@inheritDoc}
- */
- public EndpointAddress getLogicalDestinationAddress() {
-
- // If it's not resolved, we can't know what the logical destination is, unless we had an expectation.
- // And if we had, the messenger will fail as soon as we discover that the expectation is wrong.
- // In most if not all cases, either we have an expectation, or the messenger comes already resolved.
- // Otherwise, if you need the logical destination, you must resolve first. We do not want this method
- // to be blocking.
- return logicalDestination;
- }
-
- /**
- * {@inheritDoc}
- */
- public void close() {
- synchronized (stateMachine) {
- stateMachine.closeEvent();
- stateMachine.notifyAll();
- }
- notifyChange();
- }
-
- /**
- * {@inheritDoc}
- *
- * In this case, this method is here out of principle but is not really expected to be invoked. The normal way
- * of using a ThreadedMessenger is through its channels. We do provide a default channel that all invokers that go around
- * channels will share. That could be useful to send rare out of band messages for example.
- */
- public final boolean sendMessageN(Message msg, String service, String serviceParam) {
-
- synchronized (stateMachine) {
- if (defaultChannel == null) {
- // Need a default channel.
- defaultChannel = new ThreadedMessengerChannel(getDestinationAddress(), null, null, null, channelQueueSize, false);
- }
- }
-
- return defaultChannel.sendMessageN(msg, service, serviceParam);
- }
-
- /**
- * {@inheritDoc}
- */
- public final void sendMessageB(Message msg, String service, String serviceParam) throws IOException {
-
- synchronized (stateMachine) {
- if (defaultChannel == null) {
- // Need a default channel.
- defaultChannel = new ThreadedMessengerChannel(getDestinationAddress(), null, null, null, channelQueueSize, false);
- }
- }
-
- defaultChannel.sendMessageB(msg, service, serviceParam);
- }
-
- private boolean addToActiveChannels(ThreadedMessengerChannel channel) {
-
- synchronized (stateMachine) {
- if (inputClosed) {
- return false;
- }
-
- try {
- activeChannels.put(channel);
- } catch (InterruptedException failed) {
- Thread.interrupted();
- return false;
- }
-
- // There are items in the queue now.
- stateMachine.msgsEvent();
-
- // We called an event. The state may have changed. Notify waiters.
- stateMachine.notifyAll();
- }
-
- notifyChange();
-
- return true;
- }
-
- private void strongRefResolvingChannel(ThreadedMessengerChannel channel) {
-
- // If, and only if, this channel is already among the resolving channels, add a strong ref
- // to it. This is invoked when a message is queued to that channel while it is still
- // resolving. However we must verify its presence in the resolvingChannels map: this method
- // may be called while the channel has been removed from the list, but has not been told
- // yet.
- synchronized (stateMachine) {
- if (resolvingChannels.containsKey(channel)) {
- resolvingChannels.put(channel, channel);
- }
- }
- }
-
- private boolean addToResolvingChannels(ThreadedMessengerChannel channel) {
-
- synchronized (stateMachine) {
- // If we're in a state where no resolution event will ever occur, we must not add anything to the list.
- if ((stateMachine.getState() & (RESOLVED | TERMINAL)) != 0) {
- return false;
- }
-
- // We use the weak map only for the weak part, not for the map part.
- resolvingChannels.put(channel, null);
-
- stateMachine.resolveEvent();
- stateMachine.notifyAll();
- }
-
- notifyChange();
- return true;
- }
-
- /**
- * {@inheritDoc}
- */
- public final void resolve() {
- synchronized (stateMachine) {
- stateMachine.resolveEvent();
- stateMachine.notifyAll();
- }
- notifyChange();
- }
-
- /**
- * {@inheritDoc}
- */
- public final int getState() {
- return stateMachine.getState();
- }
-
- /**
- * {@inheritDoc}
- */
- public Messenger getChannelMessenger(PeerGroupID redirection, String service, String serviceParam) {
-
- // Our transport is always in the same group. If the channel's target group is the same, no group
- // redirection is ever needed.
- // are we happily resolved ?
- return new ThreadedMessengerChannel(getDestinationAddress(), homeGroupID.equals(redirection) ? null : redirection, service,
- serviceParam, channelQueueSize, (stateMachine.getState() & (RESOLVED & USABLE)) != 0);
- }
-
- /*
- * Abstract methods to be provided by implementor. These are fully expected
- * to be blocking and may be implemented by invoking transport blocking
- * methods, such as EndpointServiceImpl.getLocalTransportMessenger() or
- * whateverTransportMessengerWasObtained.sendMessageB(). Should the
- * underlying code be non-blocking, these impl methods must simulate it. If
- * it's not obvious to do, then this base class is not a good choice.
- */
-
- /**
- * {@inheritDoc}
- */
- protected abstract void closeImpl();
-
- /**
- * Make underlying connection.
- *
- * @return true if successful
- */
- protected abstract boolean connectImpl();
-
- /**
- * Send a message blocking as needed until the message is sent.
- *
- * @param msg The message to send.
- * @param service The destination service.
- * @param param The destination serivce param.
- * @throws IOException Thrown for errors encountered while sending the message.
- */
- protected abstract void sendMessageBImpl(Message msg, String service, String param) throws IOException;
-
- /**
- * {@inheritDoc}
- */
- protected abstract EndpointAddress getLogicalDestinationImpl();
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/WireFormatMessage.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/WireFormatMessage.java
deleted file mode 100644
index e28c3297..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/WireFormatMessage.java
+++ /dev/null
@@ -1,87 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-package net.jxta.endpoint;
-
-
-import java.nio.ByteBuffer;
-import net.jxta.document.Document;
-import net.jxta.document.DocumentByteBufferIO;
-import net.jxta.document.MimeMediaType;
-
-
-/**
- * A wire serialization of an abstract message.
- *
- * @see net.jxta.endpoint.Message
- * @see net.jxta.endpoint.WireFormatMessageFactory
- */
-public interface WireFormatMessage extends Document, DocumentByteBufferIO {
-
- /**
- * Returns the encoding used for this content. May be {@code null} for
- * unencoded (raw) content.
- *
- * @return The encoding used for this message.
- */
- MimeMediaType getContentEncoding();
-
- /**
- * Returns the size of the serialized and encoded form of the message in bytes.
- *
- * @return The size of the serialized and encoded message in bytes.
- */
- long getByteLength();
-}
diff --git a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/WireFormatMessageFactory.java b/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/WireFormatMessageFactory.java
deleted file mode 100644
index 707fc0fa..00000000
--- a/p2pproxy/dependencies-src/jxse-src-2.5/api/src/net/jxta/endpoint/WireFormatMessageFactory.java
+++ /dev/null
@@ -1,361 +0,0 @@
-/*
- * Copyright (c) 2001-2007 Sun Microsystems, Inc. All rights reserved.
- *
- * The Sun Project JXTA(TM) Software License
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * 3. The end-user documentation included with the redistribution, if any, must
- * include the following acknowledgment: "This product includes software
- * developed by Sun Microsystems, Inc. for JXTA(TM) technology."
- * Alternately, this acknowledgment may appear in the software itself, if
- * and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
- * not be used to endorse or promote products derived from this software
- * without prior written permission. For written permission, please contact
- * Project JXTA at http://www.jxta.org.
- *
- * 5. Products derived from this software may not be called "JXTA", nor may
- * "JXTA" appear in their name, without prior written permission of Sun.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
- * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SUN
- * MICROSYSTEMS OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
- * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * JXTA is a registered trademark of Sun Microsystems, Inc. in the United
- * States and other countries.
- *
- * Please see the license information page at :
- * for instructions on use of
- * the license in source files.
- *
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many individuals
- * on behalf of Project JXTA. For more information on Project JXTA, please see
- * http://www.jxta.org.
- *
- * This license is based on the BSD license adopted by the Apache Foundation.
- */
-
-package net.jxta.endpoint;
-
-
-import net.jxta.document.MimeMediaType;
-import net.jxta.logging.Logging;
-import net.jxta.util.ClassFactory;
-
-import java.io.IOException;
-import java.io.InputStream;
-import java.nio.ByteBuffer;
-import java.util.Hashtable;
-import java.util.Map;
-import java.util.NoSuchElementException;
-import java.util.logging.Level;
-import java.util.logging.Logger;
-
-
-/**
- * This class is a class factory for Wire Format Messages. This class abstracts
- * The implementation of Wire Format Messages and allows for construction based
- * on the MimeType of InputStreams.
- *
- * The WireFormatMessageFactory extends the ClassFactory to register the
- * various Message wire format implementations into a static hashtable. The
- * factory is called with the Mime type requested to create the corresponding
- * Wire Format type.
- *
- * @see net.jxta.endpoint.Message
- * @see net.jxta.endpoint.WireFormatMessage
- * @see net.jxta.util.ClassFactory
- * @see net.jxta.document.MimeMediaType
- */
-public final class WireFormatMessageFactory extends ClassFactory {
-
- /**
- * Logger
- */
- private static final Logger LOG = Logger.getLogger(WireFormatMessageFactory.class.getName());
-
- /**
- * The mime media type of preferred/default wire format.
- */
- public static final MimeMediaType DEFAULT_WIRE_MIME = new MimeMediaType("application/x-jxta-msg").intern();
-
- /**
- * Interface for instantiators of wire format messages.
- */
- public interface Instantiator {
-
- /**
- * Returns the list of mime types supported by this serialization. All of
- * mimetypes in this list should have no mime type parameters.
- *
- * @return Returns the list of mime types supported by this serialization.
- */
- public MimeMediaType[] getSupportedMimeTypes();
-
- /**
- * Returns a list of the content encodings supported by this serialization.
- * These content encodings apply to both the overall coding of the message
- * and to the encoding of individual elements.
- *
- * @return a list of the content encodings supported by this serialization.
- */
- public MimeMediaType[] getSupportedContentEncodings();
-
- /**
- * Create a WireFormatMessage from an abstract message. It is an error
- * (though lazily enforced) to modify the abstract message during the
- * lifetime of the WireFormatMessage.
- *
- * @param msg the message for which a serialization is desired.
- * @param type the the serialization form desired. This can include
- * mime parameters to control options.
- * @param preferedContentEncoding An array of acceptable message encodings
- * in descending order of preference. any or none of these encoding options
- * may be used. May be null for unencoded messages.
- * @return a proxy object for the abstract message which is a
- * representation of the message in its serialized form.
- */
- public WireFormatMessage toWire(Message msg, MimeMediaType type, MimeMediaType[] preferedContentEncoding);
-
- /**
- * Create an abstract message from a serialization.
- *
- * @param is The message stream. Message serializations must either use
- * internal data or EOF to determine the length of the stream.
- * @param type Declared message type of the stream including any optional
- * configuration parameters.
- * @param contentEncoding Content encoding (including optional parameters)
- * which has been applied to the message. May be null for unencoded messages.
- * @return a proxy object for the abstract message which is a
- * representation of the message in its serialized form.
- * @throws java.io.IOException if an io error occurs
- */
- public Message fromWire(InputStream is, MimeMediaType type, MimeMediaType contentEncoding) throws IOException;
-
- /**
- * Create an abstract message from a serialization.
- *
- * @param buffer The byte buffer. Message serializations must either use
- * internal data or EOF to determine the length of the stream.
- * @param type Declared message type of the stream including any optional
- * configuration parameters.
- * @param contentEncoding Content encoding (including optional parameters)
- * which has been applied to the message. May be null for unencoded messages.
- * @return a proxy object for the abstract message which is a
- * representation of the message in its serialized form.
- * @throws java.io.IOException if an io error occurs
- */
- public Message fromBuffer(ByteBuffer buffer, MimeMediaType type, MimeMediaType contentEncoding) throws IOException;
- }
-
- /**
- * This is the map of mime-types and constructors used by
- * newStructuredDocument.
- */
- private Map encodings = new Hashtable