identification.html

门户开发

<TD><CODE><B><A HREF="../../../../com/ibm/portal/identification/Identification.html#serializeWithDatabaseDomain(com.ibm.portal.ObjectID)">serializeWithDatabaseDomain</A></B>(<A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal">ObjectID</A>&nbsp;oid)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Serializes <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal"><CODE>ObjectID</CODE></A> instances into their
 <CODE>String</CODE> representation.<br/>
 In order to revert the resulting <CODE>String</CODE> back to
 the corresponding <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal"><CODE>ObjectID</CODE></A> instance use
 <A HREF="../../../../com/ibm/portal/identification/Identification.html#deserialize(java.lang.String)"><CODE>deserialize</CODE></A>.<br/>
 
 This method also includes information about the database domain, where the
 corresponding object is located, into the result <CODE>String</CODE>.</TD>
</TR>
</TABLE>
&nbsp;
<P>

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


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


<!-- ============ 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="serialize(com.ibm.portal.ObjectID)"><!-- --></A><H3>
serialize</H3>
<PRE>
public java.lang.String <B>serialize</B>(<A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal">ObjectID</A>&nbsp;oid)
                           throws com.ibm.portal.serialize.SerializationException</PRE>
<DL>
<DD>Serializes <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal"><CODE>ObjectID</CODE></A> instances into their
 <CODE>String</CODE> representation.<br/>
 In order to revert the resulting <CODE>String</CODE> back to
 the corresponding <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal"><CODE>ObjectID</CODE></A> instance use
 <A HREF="../../../../com/ibm/portal/identification/Identification.html#deserialize(java.lang.String)"><CODE>deserialize(java.lang.String)</CODE></A>.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>oid</CODE> - The <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal"><CODE>ObjectID</CODE></A> instance, which will be serialized
<DT><B>Returns:</B><DD>The <CODE>String</CODE> representation of the
         <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal"><CODE>ObjectID</CODE></A> instance supplied
<DT><B>Throws:</B>
<DD><CODE>com.ibm.portal.serialize.SerializationException</CODE> - The exception is thrown
         if there was an error during serialization</DL>
</DD>
</DL>
<HR>

<A NAME="serializeWithDatabaseDomain(com.ibm.portal.ObjectID)"><!-- --></A><H3>
serializeWithDatabaseDomain</H3>
<PRE>
public java.lang.String <B>serializeWithDatabaseDomain</B>(<A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal">ObjectID</A>&nbsp;oid)
                                             throws com.ibm.portal.serialize.SerializationException</PRE>
<DL>
<DD>Serializes <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal"><CODE>ObjectID</CODE></A> instances into their
 <CODE>String</CODE> representation.<br/>
 In order to revert the resulting <CODE>String</CODE> back to
 the corresponding <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal"><CODE>ObjectID</CODE></A> instance use
 <A HREF="../../../../com/ibm/portal/identification/Identification.html#deserialize(java.lang.String)"><CODE>deserialize</CODE></A>.<br/>
 
 This method also includes information about the database domain, where the
 corresponding object is located, into the result <CODE>String</CODE>.
 A database domain is a logical location. It may be a physical database or
 a subset of database objects in a shared database. Database domains are
 WebSphere Portal installation specific. Therefore, this <CODE>String</CODE> respresentation of an <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal"><CODE>ObjectID</CODE></A> instance
 cannot be used to exchange information between different installations of
 WebSphere Portal. However, it is adequate for transfering resource identifying
 information between nodes within one cluster.<br/>
 
 The given object ID is only serialized, if the database domain information
 can be determined, otherwise a SerializationException is thrown.<br/>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>oid</CODE> - Object ID to be serialized
<DT><B>Returns:</B><DD>serialized Object ID including database domain information as String
<DT><B>Throws:</B>
<DD><CODE>com.ibm.portal.serialize.SerializationException</CODE> - The exception is thrown if the database domain
                                information cannot be determined or if any other
                                error has occurred during serialization.<DT><B>Since:</B></DT>
  <DD>6.0</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="deserialize(java.lang.String)"><!-- --></A><H3>
deserialize</H3>
<PRE>
public <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal">ObjectID</A> <B>deserialize</B>(java.lang.String&nbsp;serialized)
                     throws com.ibm.portal.serialize.SerializationException</PRE>
<DL>
<DD>Deserializes <CODE>String</CODE> instances to <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal"><CODE>ObjectID</CODE></A>
 instances.<br/>
 Input of this method must be the output of
 <A HREF="../../../../com/ibm/portal/identification/Identification.html#serialize(com.ibm.portal.ObjectID)"><CODE>serialize(com.ibm.portal.ObjectID)</CODE></A>.<br/>
 Unique names are the only exception. They can be resolved to
 <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal"><CODE>ObjectID</CODE></A> instances by this method, too, if they have been
 defined in this portal before. Unknown names cause this method to throw a
 <CODE>SerializationException</CODE>.<br/>
 An exception is thrown, if a <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal"><CODE>ObjectID</CODE></A> is supposed to be
 deserialized although this object ID still can be generated in future.<br/>
 However, a successful deserialization does not give any evidence regarding the
 validity of the value that was provided as parameter. But the parameter has an
 incorrect value, if an exception was thrown.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>serialized</CODE> - A serialized <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal"><CODE>ObjectID</CODE></A> or a valid unique name, respectively
<DT><B>Returns:</B><DD>The <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal"><CODE>ObjectID</CODE></A> instance that is represented by the parameter
<DT><B>Throws:</B>
<DD><CODE>com.ibm.portal.serialize.SerializationException</CODE> - The exception is thrown if the
         parameter is neither a <A HREF="../../../../com/ibm/portal/ObjectID.html" title="interface in com.ibm.portal"><CODE>ObjectID</CODE></A> instance in its
         serialized format nor a valid unique name</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<A HREF="#main"><FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../serialized-form.html"><FONT CLASS="NavBarFont1"><B>Serialized</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;PREV CLASS&nbsp;
&nbsp;NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../../index.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="Identification.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>

</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>

</BODY>
</HTML>