policyconfiguration.html

j2ee帮助文档软件设计/软件工程 文件格式

 by the implementation class will be encapsulated (during construction)
 in the thrown PolicyContextException.</DL>
</DD>
</DL>
<HR>

<A NAME="removeExcludedPolicy()"><!-- --></A><H3>
removeExcludedPolicy</H3>
<PRE>
void <B>removeExcludedPolicy</B>()
                          throws <A HREF="../../../javax/security/jacc/PolicyContextException.html" title="class in javax.security.jacc">PolicyContextException</A></PRE>
<DL>
<DD>Used to remove any excluded policy statements from this
 PolicyConfiguration.
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang">SecurityException</A></CODE> - if called by an AccessControlContext that has not been
 granted the "setPolicy" SecurityPermission.
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/UnsupportedOperationException.html" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - if the state of the policy context whose interface is this
 PolicyConfiguration Object is "deleted" or "inService" when this
 method is called.
<DD><CODE><A HREF="../../../javax/security/jacc/PolicyContextException.html" title="class in javax.security.jacc">PolicyContextException</A></CODE> - if the implementation throws a checked exception that has not been
 accounted for by the removeExcludedPolicy method signature.
 The exception thrown
 by the implementation class will be encapsulated (during construction)
 in the thrown PolicyContextException.</DL>
</DD>
</DL>
<HR>

<A NAME="linkConfiguration(javax.security.jacc.PolicyConfiguration)"><!-- --></A><H3>
linkConfiguration</H3>
<PRE>
void <B>linkConfiguration</B>(<A HREF="../../../javax/security/jacc/PolicyConfiguration.html" title="interface in javax.security.jacc">PolicyConfiguration</A>&nbsp;link)
                       throws <A HREF="../../../javax/security/jacc/PolicyContextException.html" title="class in javax.security.jacc">PolicyContextException</A></PRE>
<DL>
<DD>Creates a relationship between this configuration and another
 such that they share the same principal-to-role mappings.
 PolicyConfigurations are linked to apply a common principal-to-role
 mapping to multiple seperately manageable PolicyConfigurations,
 as is required when an application is composed of multiple
 modules.
 <P>
 Note that the policy statements which comprise a role, or comprise
 the excluded or unchecked policy collections in a PolicyConfiguration
 are unaffected by the configuration being linked to another.
 <P>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>link</CODE> - a reference to a different PolicyConfiguration than this
 PolicyConfiguration.
 <P>
 The relationship formed by this method is symetric, transitive
 and idempotent. If the argument PolicyConfiguration does not have a
 different Policy context identifier than this PolicyConfiguration
 no relationship is formed, and an exception, as described below, is
 thrown.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang">SecurityException</A></CODE> - if called by an AccessControlContext that has not been
 granted the "setPolicy" SecurityPermission.
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/UnsupportedOperationException.html" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - if the state of the policy context whose interface is this
 PolicyConfiguration Object is "deleted" or "inService" when this
 method is called.
<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 called with an argument PolicyConfiguration whose Policy context
 is equivalent to that of this PolicyConfiguration.
<DD><CODE><A HREF="../../../javax/security/jacc/PolicyContextException.html" title="class in javax.security.jacc">PolicyContextException</A></CODE> - if the implementation throws a checked exception that has not been
 accounted for by the linkConfiguration method signature. The exception
 thrown
 by the implementation class will be encapsulated (during construction)
 in the thrown PolicyContextException.</DL>
</DD>
</DL>
<HR>

<A NAME="delete()"><!-- --></A><H3>
delete</H3>
<PRE>
void <B>delete</B>()
            throws <A HREF="../../../javax/security/jacc/PolicyContextException.html" title="class in javax.security.jacc">PolicyContextException</A></PRE>
<DL>
<DD>Causes all policy statements to be deleted from this PolicyConfiguration
 and sets its internal state such that calling any method, other than
 delete, getContextID, or inService on the PolicyConfiguration will 
 be rejected and cause an UnsupportedOperationException to be thrown.
 <P>
 This operation has no affect on any linked PolicyConfigurations
 other than removing any links involving the deleted PolicyConfiguration.
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang">SecurityException</A></CODE> - if called by an AccessControlContext that has not been
 granted the "setPolicy" SecurityPermission.
<DD><CODE><A HREF="../../../javax/security/jacc/PolicyContextException.html" title="class in javax.security.jacc">PolicyContextException</A></CODE> - if the implementation throws a checked exception that has not been
 accounted for by the delete method signature. The exception thrown
 by the implementation class will be encapsulated (during construction)
 in the thrown PolicyContextException.</DL>
</DD>
</DL>
<HR>

<A NAME="commit()"><!-- --></A><H3>
commit</H3>
<PRE>
void <B>commit</B>()
            throws <A HREF="../../../javax/security/jacc/PolicyContextException.html" title="class in javax.security.jacc">PolicyContextException</A></PRE>
<DL>
<DD>This method is used to set to "inService" the state of the policy context
 whose interface is this PolicyConfiguration Object. Only those policy
 contexts whose state is "inService" will be included in the policy
 contexts processed by the Policy.refresh method. A policy context whose
 state is "inService" may be returned to the "open" state by calling the 
 getPolicyConfiguration method of the PolicyConfiguration factory
 with the policy context identifier of the policy context.
 <P>
 When the state of a policy context is "inService", calling any method
 other than commit, delete, getContextID, or inService on its
 PolicyConfiguration Object will cause an UnsupportedOperationException
 to be thrown.
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang">SecurityException</A></CODE> - if called by an AccessControlContext that has not been
 granted the "setPolicy" SecurityPermission.
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/UnsupportedOperationException.html" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - if the state of the policy context whose interface is this
 PolicyConfiguration Object is "deleted" when this
 method is called.
<DD><CODE><A HREF="../../../javax/security/jacc/PolicyContextException.html" title="class in javax.security.jacc">PolicyContextException</A></CODE> - if the implementation throws a checked exception that has not been
 accounted for by the commit method signature. The exception thrown
 by the implementation class will be encapsulated (during construction)
 in the thrown PolicyContextException.</DL>
</DD>
</DL>
<HR>

<A NAME="inService()"><!-- --></A><H3>
inService</H3>
<PRE>
boolean <B>inService</B>()
                  throws <A HREF="../../../javax/security/jacc/PolicyContextException.html" title="class in javax.security.jacc">PolicyContextException</A></PRE>
<DL>
<DD>This method is used to determine if the policy context whose interface is
 this PolicyConfiguration Object is in the "inService" state.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>true if the state of the associated policy context is
 "inService"; false otherwise.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang">SecurityException</A></CODE> - if called by an AccessControlContext that has not been
 granted the "setPolicy" SecurityPermission.
<DD><CODE><A HREF="../../../javax/security/jacc/PolicyContextException.html" title="class in javax.security.jacc">PolicyContextException</A></CODE> - if the implementation throws a checked exception that has not been
 accounted for by the inService method signature. The exception thrown
 by the implementation class will be encapsulated (during construction)
 in the thrown PolicyContextException.</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=2 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;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&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="../../../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;<A HREF="../../../javax/security/jacc/EJBRoleRefPermission.html" title="class in javax.security.jacc"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javax/security/jacc/PolicyConfigurationFactory.html" title="class in javax.security.jacc"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html?javax/security/jacc/PolicyConfiguration.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="PolicyConfiguration.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>
<font size="-1"><a href="http://java.sun.com/webapps/bugreport">Submit a bug or feature</a> <p>Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to <a href="../legal/license.html" target="_top">license terms.</a></font>
</BODY>
</HTML>