alsbconfigurationmbean.html

一个实用的java源程序

                      a file to a given resource type. If this is null we would
                      use a default extension map.
<DT><B>Returns:</B><DD>Map<String,Diagnostics> this map contains the file name and a diagnostics.
          This will have the entries for both succesfully imported files
          and failed ones.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if the file is not a valid zip file
<DD><CODE><A HREF="../../../../../../com/bea/wli/config/component/NotFoundException.html" title="class in com.bea.wli.config.component">NotFoundException</A></CODE> - if the location specified doesn't exist
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></CODE> - If there is any exception during import<DT><B>Since:</B></DT>
  <DD>2.6</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="exportProjects(java.util.Collection, java.lang.String)"><!-- --></A><H3>
exportProjects</H3>
<PRE>
byte[] <B>exportProjects</B>(<A HREF="http://java.sun.com/j2se/1.5/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A>&lt;<A HREF="../../../../../../com/bea/wli/config/Ref.html" title="class in com.bea.wli.config">Ref</A>&gt;&nbsp;projectrefs,
                      <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;passphrase)
                      throws <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></PRE>
<DL>
<DD>Export resources at the project level. A jar file that contains resources exported at
 the project level behaves differently from a jar file exported at the resource level
 (via <A HREF="../../../../../../com/bea/wli/sb/management/configuration/ALSBConfigurationMBean.html#export(java.util.Collection, boolean, java.lang.String)"><CODE>export(java.util.Collection<com.bea.wli.config.Ref>, boolean, java.lang.String)</CODE></A> when imported to a target domain. Resource that are in the
 target domain, but not in the jar file are deleted by default. This behavior could be
 overwritten or customized by modifying the import plan. Folders are not
 deleted even if they don't exist in the jar file.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>projectrefs</CODE> - references to projects to be exported<DD><CODE>passphrase</CODE> - 
<DT><B>Returns:</B><DD>bytes that make up an exported configuration in the form
      of a zip file. The result can be saved as a zip file and
      inspected with relevant tools.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></CODE><DT><B>Since:</B></DT>
  <DD>2.6</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="importUploaded(com.bea.wli.sb.management.importexport.ALSBImportPlan)"><!-- --></A><H3>
importUploaded</H3>
<PRE>
<A HREF="../../../../../../com/bea/wli/config/importexport/ImportResult.html" title="interface in com.bea.wli.config.importexport">ImportResult</A> <B>importUploaded</B>(<A HREF="../../../../../../com/bea/wli/sb/management/importexport/ALSBImportPlan.html" title="class in com.bea.wli.sb.management.importexport">ALSBImportPlan</A>&nbsp;importPlan)
                            throws <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></PRE>
<DL>
<DD>Import an already uploaded jar file in this session.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>importPlan</CODE> - <A HREF="../../../../../../com/bea/wli/sb/management/importexport/ALSBImportPlan.html" title="class in com.bea.wli.sb.management.importexport"><CODE>ALSBImportPlan</CODE></A>. A null value causes the default plan to be used.
<DT><B>Returns:</B><DD>ImportResult object that contains resources that are successfully imported,
         deleted and those that have failed
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></CODE><DT><B>Since:</B></DT>
  <DD>2.6</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getImportJarInfo()"><!-- --></A><H3>
getImportJarInfo</H3>
<PRE>
<A HREF="../../../../../../com/bea/wli/sb/management/importexport/ALSBJarInfo.html" title="class in com.bea.wli.sb.management.importexport">ALSBJarInfo</A> <B>getImportJarInfo</B>()
                             throws <A HREF="../../../../../../com/bea/wli/config/component/NotFoundException.html" title="class in com.bea.wli.config.component">NotFoundException</A>,
                                    <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></PRE>
<DL>
<DD>Returns detailed information about the entities in the previously staged
 configuration jar file
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../../com/bea/wli/config/component/NotFoundException.html" title="class in com.bea.wli.config.component">NotFoundException</A></CODE> - if no configuration jar has been uploaded, or a previously
      uploaded jar file has been imported
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></CODE><DT><B>Since:</B></DT>
  <DD>2.6</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="customize(java.util.List)"><!-- --></A><H3>
customize</H3>
<PRE>
void <B>customize</B>(<A HREF="http://java.sun.com/j2se/1.5/docs/api/java/util/List.html" title="class or interface in java.util">List</A>&lt;<A HREF="../../../../../../com/bea/wli/config/customization/Customization.html" title="class in com.bea.wli.config.customization">Customization</A>&gt;&nbsp;customizations)
               throws <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></PRE>
<DL>
<DD>This API supports multiple customizations at one place.
 As of now, you can do one of the following or any combinations of these:
      Assign Env Values | Find and Replace Env Values | Reference Mapping
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>customizations</CODE> - <A HREF="../../../../../../com/bea/wli/config/customization/Customization.html" title="class in com.bea.wli.config.customization"><CODE>Customization</CODE></A>
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></CODE><DT><B>Since:</B></DT>
  <DD>2.6</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="move(com.bea.wli.config.Ref, com.bea.wli.config.Ref)"><!-- --></A><H3>
move</H3>
<PRE>
void <B>move</B>(<A HREF="../../../../../../com/bea/wli/config/Ref.html" title="class in com.bea.wli.config">Ref</A>&nbsp;source,
          <A HREF="../../../../../../com/bea/wli/config/Ref.html" title="class in com.bea.wli.config">Ref</A>&nbsp;target)
          throws <A HREF="../../../../../../com/bea/wli/config/component/NotFoundException.html" title="class in com.bea.wli.config.component">NotFoundException</A>,
                 <A HREF="../../../../../../com/bea/wli/config/component/AlreadyExistsException.html" title="class in com.bea.wli.config.component">AlreadyExistsException</A>,
                 <A HREF="../../../../../../com/bea/wli/config/component/UpdateException.html" title="class in com.bea.wli.config.component">UpdateException</A></PRE>
<DL>
<DD>This method is used to change the identity of a resource or to map an existing
 project or folder to another project or folder. Both source and target should
 point to a resource or to a project/folder, else an IllegalArgumentException
 is thrown.

 This method can be used to change the identity of an existing resource so that its name,
 or its location, or both are different. It can also be used to rename and/or move
 a resource. While changing the identity of a resource, all the references to this resource
 from other resources will be updated.

 This method can be used to map an existing project or folder to another
 project or folder. Mapping  causes all subfolders and resources under the source
 to be moved to the target location. Certain mappings are simple
 renames of folders or projects, whereas others could be more
 elaborate move operation that may result in merging resources.
 A project can be mapped to a folder, or a folder can be mapped to a
 project. It is also possible to map a source location to an
 existing target location so that both are merged under the
 identity of the target location. Mapping a location to one
 of its descendants is not allowed (e.g., A/B/C cannot be mapped to
 A/B/C/D).

 However a location can be mapped to one of its ancestors
 (e.g., A/B/C can be mapped to A/B)<p>

 More precisely a mapping from <tt>A1/A2/.../An</tt> to
 <tt>B1/B2/.../Bm</tt> will change identity of all projects, folders,
 and resources under <tt>A1/A2/.../An</tt> (inclusive) to have
 a location prefix of <tt>B1/B2/.../Bm</tt>.

 For example if there is a folder <tt>A1/A2/.../An/Foo</tt>, it will
 become <tt>B1/B2/.../Bm/Foo</tt>.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>source</CODE> - reference to the source project/folder/resource<DD><CODE>target</CODE> - reference to the target project/folder/resource
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../../com/bea/wli/config/component/NotFoundException.html" title="class in com.bea.wli.config.component">NotFoundException</A></CODE> - is source or target ref is not found
<DD><CODE><A HREF="../../../../../../com/bea/wli/config/component/AlreadyExistsException.html" title="class in com.bea.wli.config.component">AlreadyExistsException</A></CODE> - while moving resources if another resource with
         the target's identity already exists.
         And while moving location if a resource in the source location conflicts
         with another resource with the same name in the target location.
<DD><CODE><A HREF="../../../../../../com/bea/wli/config/component/UpdateException.html" title="class in com.bea.wli.config.component">UpdateException</A></CODE> - any other failure is wrapped inside
      this exception.<DT><B>Since:</B></DT>
  <DD>2.6</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="delete(java.util.Collection)"><!-- --></A><H3>
delete</H3>
<PRE>
void <B>delete</B>(<A HREF="http://java.sun.com/j2se/1.5/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A>&lt;<A HREF="../../../../../../com/bea/wli/config/Ref.html" title="class in com.bea.wli.config">Ref</A>&gt;&nbsp;refs)
            throws <A HREF="../../../../../../com/bea/wli/config/component/NotFoundException.html" title="class in com.bea.wli.config.component">NotFoundException</A>,
                   <A HREF="../../../../../../com/bea/wli/config/component/DeleteException.html" title="class in com.bea.wli.config.component">DeleteException</A></PRE>
<DL>
<DD>Deletes the given collection of references. The collection
 can contains a mixture of resource references as well as
 projects or folders. All projects and folders are expanded and
 all resources within those locations are deleted as well. A Resource
 is deleted even if there are references to it.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>refs</CODE> - the collection of references to delete
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../../com/bea/wli/config/component/NotFoundException.html" title="class in com.bea.wli.config.component">NotFoundException</A></CODE> - if a reference is not found
<DD><CODE><A HREF="../../../../../../com/bea/wli/config/component/DeleteException.html" title="class in com.bea.wli.config.component">DeleteException</A></CODE> - if there is any error while deleting a resource.
                         For example, if the user tries to delete System Project<DT><B>Since:</B></DT>
  <DD>2.6</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="createProject(com.bea.wli.config.Ref, java.lang.String)"><!-- --></A><H3>
createProject</H3>
<PRE>
void <B>createProject</B>(<A HREF="../../../../../../com/bea/wli/config/Ref.html" title="class in com.bea.wli.config">Ref</A>&nbsp;projectRef,
                   <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;description)
                   throws <A HREF="../../../../../../com/bea/wli/config/component/AlreadyExistsException.html" title="class in com.bea.wli.config.component">AlreadyExistsException</A>,
                          <A HREF="../../../../../../com/bea/wli/config/component/CreateExceptio