webuserdatapermission.html

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

<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

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

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

<A NAME="WebUserDataPermission(java.lang.String, java.lang.String)"><!-- --></A><H3>
WebUserDataPermission</H3>
<PRE>
public <B>WebUserDataPermission</B>(<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;name,
                             <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;actions)</PRE>
<DL>
<DD>Creates a new WebUserDataPermission with the specified name and actions.
 <P>
 The name contains a URLPatternSpec that identifies the web
 resources to which the permissions applies. The syntax of a URLPatternSpec
 is as follows:
 <P><Pre>

          URLPatternList ::= URLPattern | URLPatternList colon URLPattern

          URLPatternSpec ::= null | URLPattern | URLPattern colon URLPatternList

 </Pre><P>
 A null URLPatternSpec is translated to the default URLPattern, "/", by
 the permission constructor. The empty string is an exact URLPattern, and
 may occur anywhere in a URLPatternSpec that an exact URLPattern may occur.
 The first URLPattern in a URLPatternSpec may be any of the pattern 
 types, exact, path-prefix, extension, or default as defined in the
 <i>Java Servlet Specification)</i>. When a URLPatternSpec includes
 a URLPatternList, the patterns of the URLPatternList identify the
 resources to which the permission does NOT apply and depend on the
 pattern type and value of the first pattern as follows:  <p>
 <ul>
 <li> No pattern may exist in the URLPatternList that matches the
      first pattern.
 <li> If the first pattern is a path-prefix
      pattern, only exact patterns matched by the first pattern
      and path-prefix patterns matched by, but different from,
      the first pattern may occur in the URLPatternList.
 <li> If the first pattern is an extension
      pattern, only exact patterns that are matched by the first 
      pattern and path-prefix patterns may occur in the URLPatternList.
 <li> If the first pattern is the default pattern, "/", any pattern
      except the default pattern may occur in the URLPatternList.
 <li> If the first pattern is an exact pattern a URLPatternList must not
      be present in the URLPatternSpec.
 </ul>
 <P>
 The actions parameter contains a comma separated list of HTTP methods
 that may be followed by a transportType separated from the HTTP
 method by a colon.
 <P><Pre>

          ExtensionMethod ::= any token as defined by RFC 2616
                  (that is, 1*[any CHAR except CTLs or separators])

          HTTPMethod ::= "Get" | "POST" | "PUT" | "DELETE" | "HEAD" |
                  "OPTIONS" | "TRACE" | ExtensionMethod

          HTTPMethodList ::= HTTPMethod | HTTPMethodList comma HTTPMethod

          HTTPMethodExceptionList ::= exclaimationPoint HTTPMethodList

          HTTPMethodSpec ::= emptyString | HTTPMethodExceptionList |
                  HTTPMethodList

          transportType ::= "INTEGRAL" | "CONFIDENTIAL" | "NONE"

          actions ::= null | HTTPMethodSpec | 
                  HTTPMethodSpec colon transportType

 </Pre><P>
 If duplicates occur in the HTTPMethodSpec
 they must be eliminated by the permission constructor.
 <P>
 An empty string HTTPMethodSpec is a shorthand for a List
 containing all the possible HTTP methods.
 <P>
 If the HTTPMethodSpec contains an HTTPMethodExceptionList (i.e., 
 it begins with an exclaimationPoint), the permission pertains 
 to all methods except those occuring in the exception list.
 <P>
 An actions string without a transportType is a shorthand for a
 actions string with the value "NONE" as its TransportType.
 <P>
 A granted permission representing a transportType of "NONE", 
 indicates that the associated resources may be accessed
 using any conection type.
 <P>
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - the URLPatternSpec that identifies the application 
 specific web resources to which the permission pertains. 
 All URLPatterns in the URLPatternSpec are relative to the context path
 of the deployed web application module, and the same URLPattern must not
 occur more than once in a URLPatternSpec. A null URLPatternSpec is 
 translated to the default URLPattern, "/", by the permission constructor.
 <P><DD><CODE>actions</CODE> - identifies the HTTP methods and transport type to which
 the permission pertains. If the value passed through this
 parameter is null or the empty string, then the permission
 is constructed with actions corresponding to all the possible
 HTTP methods and transportType "NONE".</DL>
</DL>
<HR>

<A NAME="WebUserDataPermission(java.lang.String, java.lang.String[], java.lang.String)"><!-- --></A><H3>
WebUserDataPermission</H3>
<PRE>
public <B>WebUserDataPermission</B>(<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;urlPatternSpec,
                             <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;HTTPMethods,
                             <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;transportType)</PRE>
<DL>
<DD>Creates a new WebUserDataPermission with name corresponding to the
 URLPatternSpec, and actions composed from the array of HTTP methods 
 and the transport type.
 <P>
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>urlPatternSpec</CODE> - the URLPatternSpec that identifies the 
 application specific web resources to which the permission pertains.
 All URLPatterns in the URLPatternSpec are relative to the context path
 of the deployed web application module, and the same URLPattern must not
 occur more than once in a URLPatternSpec. A null URLPatternSpec is 
 translated to the default URLPattern, "/", by the permission constructor.
 <P><DD><CODE>HTTPMethods</CODE> - an array of strings each element of which contains
 the value of an HTTP method. If the value passed through this
 parameter is null or is an array with no elements, then the permission
 is constructed with actions corresponding to all the possible HTTP methods.
 <P><DD><CODE>transportType</CODE> - a String whose value is a transportType.
 If the value passed through this parameter is null, then the permission
 is constructed with actions corresponding to transportType "NONE".</DL>
</DL>
<HR>

<A NAME="WebUserDataPermission(javax.servlet.http.HttpServletRequest)"><!-- --></A><H3>
WebUserDataPermission</H3>
<PRE>
public <B>WebUserDataPermission</B>(<A HREF="../../../javax/servlet/http/HttpServletRequest.html" title="interface in javax.servlet.http">HttpServletRequest</A>&nbsp;request)</PRE>
<DL>
<DD>Creates a new WebUserDataPermission from the HttpServletRequest
 object.
 <P>
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>request</CODE> - the HttpServletRequest object corresponding
 to the Servlet operation to which the permission pertains.
 The permission name is the substring of the requestURI 
 (HttpServletRequest.getRequestURI()) that begins after the contextPath
 (HttpServletRequest.getContextPath()). When the substring operation
 yields the string "/", the permission is constructed with the empty
 string as its name. The HTTP method component of the permission's
 actions is as obtained from HttpServletRequest.getMethod().
 The TransportType component of the permission's
 actions is determined by calling HttpServletRequest.isSecure().</DL>
</DL>

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

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

<A NAME="equals(java.lang.Object)"><!-- --></A><H3>
equals</H3>
<PRE>
public boolean <B>equals</B>(<A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>&nbsp;o)</PRE>
<DL>
<DD>Checks two WebUserDataPermission objects for equality.
 WebUserDataPermission objects are equivalent if their 
 URLPatternSpec and (canonicalized) actions values are equivalent.
 The URLPatternSpec of a reference permission is equivalent to that
 of an argument permission if their first patterns are
 equivalent, and the patterns of the URLPatternList of the reference
 permission collectively match exactly the same set of patterns
 as are matched by the patterns of the URLPatternList of the 
 argument permission.
 <P>
 Two Permission objects, P1 and P2, are equivalent if and only if
 P1.implies(P2) && P2.implies(P1).
 <P>
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/security/Permission.html#equals(java.lang.Object)" title="class or interface in java.security">equals</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/security/Permission.html" title="class or interface in java.security">Permission</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>o</CODE> - the WebUserDataPermission object being tested for equality
 with this WebUserDataPermission.
 <P>
<DT><B>Returns:</B><DD>true if the argument WebUserDataPermission object is equivalent
 to this WebUserDataPermission.</DL>
</DD>
</DL>
<HR>

<A NAME="getActions()"><!-- --></A><H3>