messageelement.html

jxta的api库

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the MIME Media type of this <code>Document</code> per
 <a href="http://www.ietf.org/rfc/rfc2046.txt" target="_blank">IETF RFC 2046 <i>MIME : Media Types</i></a>.

 <p/>JXTA does not currently support the '<code>Multipart</code>' or
 '<code>Message</code>' media types.

  <p/>Will return "Application/Octet-Stream" if no type was originally
   specified.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../net/jxta/endpoint/MessageElement.html#getSequentialName()">getSequentialName</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a string containing a pseudo-random unique string and an integer
 value. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../net/jxta/endpoint/MessageElement.html" title="class in net.jxta.endpoint">MessageElement</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../net/jxta/endpoint/MessageElement.html#getSignature()">getSignature</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the element containing the digest/digital signature for
  this element</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../net/jxta/endpoint/MessageElement.html#getUniqueName()">getUniqueName</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a pseudo-random unique string which can be used as an element
 name.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../net/jxta/endpoint/MessageElement.html#hashCode()">hashCode</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../net/jxta/endpoint/MessageElement.html#sendToStream(java.io.OutputStream)">sendToStream</A></B>(java.io.OutputStream&nbsp;sendTo)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Send the contents of this <code>Document</code> to the specified stream.

 <p/>This version probably has sub-optimal performance. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;java.lang.Object</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../net/jxta/endpoint/MessageElement.html#setElementProperty(java.lang.Object, java.lang.Object)">setElementProperty</A></B>(java.lang.Object&nbsp;key,
                   java.lang.Object&nbsp;value)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;associate a transient property with this element. if there was a previous
  value for the key provided then it is returned. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../net/jxta/endpoint/MessageElement.html#toString()">toString</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;

  <p/>Returns a String representation of the element data. </TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class java.lang.Object</B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>finalize, getClass, notify, notifyAll, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_net.jxta.document.Document"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from interface net.jxta.document.<A HREF="../../../net/jxta/document/Document.html" title="interface in net.jxta.document">Document</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../net/jxta/document/Document.html#getStream()">getStream</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->

<A NAME="field_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Field Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="name"><!-- --></A><H3>
name</H3>
<PRE>
protected java.lang.String <B>name</B></PRE>
<DL>
<DD>The name of this element. May be the empty string ("") if the element is
  unnamed.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="type"><!-- --></A><H3>
type</H3>
<PRE>
protected <A HREF="../../../net/jxta/document/MimeMediaType.html" title="class in net.jxta.document">MimeMediaType</A> <B>type</B></PRE>
<DL>
<DD>The type of this element.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="sig"><!-- --></A><H3>
sig</H3>
<PRE>
protected <A HREF="../../../net/jxta/endpoint/MessageElement.html" title="class in net.jxta.endpoint">MessageElement</A> <B>sig</B></PRE>
<DL>
<DD>The optional element which digitially signs or digests this element.
  If null then the element is has no signature element. If sig == this then
  this element is a signature element.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="properties"><!-- --></A><H3>
properties</H3>
<PRE>
protected java.util.Map <B>properties</B></PRE>
<DL>
<DD>message properties hashmap
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="cachedGetByteLength"><!-- --></A><H3>
cachedGetByteLength</H3>
<PRE>
protected transient long <B>cachedGetByteLength</B></PRE>
<DL>
<DD>cached result of <A HREF="../../../net/jxta/endpoint/MessageElement.html#getByteLength()"><CODE>getByteLength()</CODE></A> operation.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="cachedGetBytes"><!-- --></A><H3>
cachedGetBytes</H3>
<PRE>
protected transient java.lang.ref.SoftReference <B>cachedGetBytes</B></PRE>
<DL>
<DD>cached result of <A HREF="../../../net/jxta/endpoint/MessageElement.html#getBytes(boolean)"><CODE>getBytes(boolean)</CODE></A> operation.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="cachedToString"><!-- --></A><H3>
cachedToString</H3>
<PRE>
protected transient java.lang.ref.SoftReference <B>cachedToString</B></PRE>
<DL>
<DD>cached result of <A HREF="../../../net/jxta/endpoint/MessageElement.html#toString()"><CODE>toString()</CODE></A> operation.
<P>
<DL>
</DL>
</DL>

<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="MessageElement()"><!-- --></A><H3>
MessageElement</H3>
<PRE>
protected <B>MessageElement</B>()</PRE>
<DL>
<DD>disabled
<P>
</DL>
<HR>

<A NAME="MessageElement(java.lang.String, net.jxta.document.MimeMediaType, net.jxta.endpoint.MessageElement)"><!-- --></A><H3>
MessageElement</H3>
<PRE>
protected <B>MessageElement</B>(java.lang.String&nbsp;name,
                         <A HREF="../../../net/jxta/document/MimeMediaType.html" title="class in net.jxta.document">MimeMediaType</A>&nbsp;type,
                         <A HREF="../../../net/jxta/endpoint/MessageElement.html" title="class in net.jxta.endpoint">MessageElement</A>&nbsp;sig)</PRE>
<DL>
<DD>Internal constructor for initializaing everything but the data.
<P>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - Name of the Element. May be the empty string ("") if
    the Element is not named.<DD><CODE>type</CODE> - Type of the Element. null is equivalent to specifying
    the type "Application/Octet-stream"<DD><CODE>sig</CODE> - optional message digest/digital signature elemnent. If
    no signature is to be specified, pass null.</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="getUniqueName()"><!-- --></A><H3>
getUniqueName</H3>
<PRE>
public static java.lang.String <B>getUniqueName</B>()</PRE>
<DL>
<DD>Returns a pseudo-random unique string which can be used as an element
 name.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>String containing a pseudo-random value</DL>
</DD>
</DL>
<HR>

<A NAME="getSequentialName()"><!-- --></A><H3>
getSequentialName</H3>
<PRE>
public static java.lang.String <B>getSequentialName</B>()</PRE>
<DL>
<DD>Returns a string containing a pseudo-random unique string and an integer
 value. The result of String.compare() will be consistent with the order in
  which results were returned from this function.
  <p/>The value for the sequential portion will be incremented for each
  call to <code>getSequentialName()</code> and a new pseudo-random value
 will be chosen every time you restart the JavaVM.

  <p/>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
  annonimity if you use the element names produced in more than one peer
  group.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>String containing a pseudo-random value and a sequence number.
  The result of String.compare() will be consistent with the order in
  which results were returned from this function.</DL>
</DD>
</DL>
<HR>

<A NAME="clone()"><!-- --></A><H3>
clone</H3>
<PRE>
public final java.lang.Object <B>clone</B>()</PRE>
<DL>
<DD>Make a clone of this element. Since elements are immutable, this
  returns the same object.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>Element the same elemement</DL>
</DD>
</DL>
<HR>

<A NAME="equals(java.lang.Object)"><!-- --></A><H3>
equals</H3>
<PRE>
public boolean <B>equals</B>(java.lang.Object&nbsp;target)</PRE>
<DL>
<DD>

  <p/>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.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>