Java Doc for RealmBase.java in  » Sevlet-Container » tomcat-catalina » org » apache » catalina » realm » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » Sevlet Container » tomcat catalina » org.apache.catalina.realm 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   org.apache.catalina.realm.RealmBase

All known Subclasses:   org.apache.catalina.realm.JNDIRealm,  org.apache.catalina.realm.JAASRealm,  org.apache.catalina.realm.DataSourceRealm,  org.apache.catalina.realm.UserDatabaseRealm,  org.apache.catalina.realm.MemoryRealm,  org.apache.catalina.realm.JDBCRealm,
RealmBase
abstract public class RealmBase implements Lifecycle,Realm,MBeanRegistration(Code)
Simple implementation of Realm that reads an XML file to configure the valid users, passwords, and roles. The file format (and default file location) are identical to those currently supported by Tomcat 3.X.
author:
   Craig R. McClanahan
version:
   $Revision: 1.33 $ $Date: 2004/05/26 15:51:25 $


Field Summary
protected  Containercontainer
     The Container with which this Realm is associated.
protected  ObjectNamecontroller
    
protected  intdebug
     The debugging detail level for this component.
protected  Stringdigest
     Digest algorithm used in storing passwords in a non-plaintext format.
protected  Stringdomain
    
protected  Stringhost
    
final protected static  Stringinfo
     Descriptive information about this Realm implementation.
protected  booleaninitialized
    
protected  LifecycleSupportlifecycle
     The lifecycle event support for this component.
protected  MessageDigestmd
     The MessageDigest object for digesting user credentials (passwords).
final protected static  MD5Encodermd5Encoder
     The MD5 helper object for this class.
protected static  MessageDigestmd5Helper
     MD5 message digest provider.
protected  MBeanServermserver
    
protected  ObjectNameoname
    
protected  Stringpath
    
protected static  StringManagersm
     The string manager for this package.
protected  booleanstarted
    
protected  PropertyChangeSupportsupport
     The property change support for this component.
protected  Stringtype
    
protected  booleanvalidate
    


Method Summary
final public static  StringDigest(String credentials, String algorithm)
     Digest password using the algorithm especificied and convert the result to a corresponding hex string.
public  voidaddLifecycleListener(LifecycleListener listener)
     Add a lifecycle event listener to this component.
public  voidaddPropertyChangeListener(PropertyChangeListener listener)
     Add a property change listener to this component.
public  Principalauthenticate(String username, String credentials)
     Return the Principal associated with the specified username and credentials, if there is one; otherwise return null.
public  Principalauthenticate(String username, byte[] credentials)
     Return the Principal associated with the specified username and credentials, if there is one; otherwise return null.
public  Principalauthenticate(String username, String clientDigest, String nOnce, String nc, String cnonce, String qop, String realm, String md5a2)
     Return the Principal associated with the specified username, which matches the digest calculated using the given parameters using the method described in RFC 2069; otherwise return null.
public  Principalauthenticate(X509Certificate certs)
     Return the Principal associated with the specified chain of X509 client certificates.
public  voiddestroy()
    
protected  Stringdigest(String credentials)
     Digest the password using the specified algorithm and convert the result to a corresponding hexadecimal string.
public  LifecycleListener[]findLifecycleListeners()
     Get the lifecycle listeners associated with this lifecycle.
public  SecurityConstraint[]findSecurityConstraints(HttpRequest request, Context context)
     Return the SecurityConstraints configured to guard the request URI for this request, or null if there is no such constraint.
public  ContainergetContainer()
     Return the Container with which this Realm has been associated.
public  ObjectNamegetController()
    
public  intgetDebug()
     Return the debugging detail level for this component.
public  StringgetDigest()
     Return the digest algorithm used for storing credentials.
protected  StringgetDigest(String username, String realmName)
     Return the digest associated with given principal's user name.
public  StringgetDomain()
    
public  StringgetInfo()
     Return descriptive information about this Realm implementation and the corresponding version number, in the format <description>/<version>.
abstract protected  StringgetName()
     Return a short name for this Realm implementation, for use in log messages.
public  ObjectNamegetObjectName()
    
abstract protected  StringgetPassword(String username)
     Return the password associated with the given principal's user name.
abstract protected  PrincipalgetPrincipal(String username)
     Return the Principal associated with the given user name.
public  StringgetType()
    
public  booleangetValidate()
     Return the "validate certificate chains" flag.
protected  booleanhasMessageDigest()
    
public  booleanhasResourcePermission(HttpRequest request, HttpResponse response, SecurityConstraint[] constraints, Context context)
     Perform access control based on the specified authorization constraint.
public  booleanhasRole(Principal principal, String role)
     Return true if the specified Principal has the specified security role, within the context of this Realm; otherwise return false.
public  booleanhasUserDataPermission(HttpRequest request, HttpResponse response, SecurityConstraint[] constraints)
     Enforce any user data constraint required by the security constraint guarding this request URI.
public  voidinit()
    
protected  voidlog(String message)
    
protected  voidlog(String message, Throwable throwable)
    
public static  voidmain(String args)
     Digest password using the algorithm especificied and convert the result to a corresponding hex string.
public  voidpostDeregister()
    
public  voidpostRegister(Boolean registrationDone)
    
public  voidpreDeregister()
    
public  ObjectNamepreRegister(MBeanServer server, ObjectName name)
    
public  voidremoveLifecycleListener(LifecycleListener listener)
     Remove a lifecycle event listener from this component.
public  voidremovePropertyChangeListener(PropertyChangeListener listener)
     Remove a property change listener from this component.
public  voidsetContainer(Container container)
     Set the Container with which this Realm has been associated.
public  voidsetController(ObjectName controller)
    
public  voidsetDebug(int debug)
     Set the debugging detail level for this component.
public  voidsetDigest(String digest)
     Set the digest algorithm used for storing credentials.
public  voidsetValidate(boolean validate)
     Set the "validate certificate chains" flag.
public  voidstart()
     Prepare for the beginning of active use of the public methods of this component.
public  voidstop()
     Gracefully terminate the active use of the public methods of this component.

Field Detail
container
protected Container container(Code)
The Container with which this Realm is associated.



controller
protected ObjectName controller(Code)



debug
protected int debug(Code)
The debugging detail level for this component.



digest
protected String digest(Code)
Digest algorithm used in storing passwords in a non-plaintext format. Valid values are those accepted for the algorithm name by the MessageDigest class, or null if no digesting should be performed.



domain
protected String domain(Code)



host
protected String host(Code)



info
final protected static String info(Code)
Descriptive information about this Realm implementation.



initialized
protected boolean initialized(Code)



lifecycle
protected LifecycleSupport lifecycle(Code)
The lifecycle event support for this component.



md
protected MessageDigest md(Code)
The MessageDigest object for digesting user credentials (passwords).



md5Encoder
final protected static MD5Encoder md5Encoder(Code)
The MD5 helper object for this class.



md5Helper
protected static MessageDigest md5Helper(Code)
MD5 message digest provider.



mserver
protected MBeanServer mserver(Code)



oname
protected ObjectName oname(Code)



path
protected String path(Code)



sm
protected static StringManager sm(Code)
The string manager for this package.



started
protected boolean started(Code)
Has this component been started?



support
protected PropertyChangeSupport support(Code)
The property change support for this component.



type
protected String type(Code)



validate
protected boolean validate(Code)
Should we validate client certificate chains when they are presented?





Method Detail
Digest
final public static String Digest(String credentials, String algorithm)(Code)
Digest password using the algorithm especificied and convert the result to a corresponding hex string. If exception, the plain credentials string is returned
Parameters:
  credentials - Password or other credentials to use inauthenticating this username
Parameters:
  algorithm - Algorithm used to do th digest



addLifecycleListener
public void addLifecycleListener(LifecycleListener listener)(Code)
Add a lifecycle event listener to this component.
Parameters:
  listener - The listener to add



addPropertyChangeListener
public void addPropertyChangeListener(PropertyChangeListener listener)(Code)
Add a property change listener to this component.
Parameters:
  listener - The listener to add



authenticate
public Principal authenticate(String username, String credentials)(Code)
Return the Principal associated with the specified username and credentials, if there is one; otherwise return null.
Parameters:
  username - Username of the Principal to look up
Parameters:
  credentials - Password or other credentials to use inauthenticating this username



authenticate
public Principal authenticate(String username, byte[] credentials)(Code)
Return the Principal associated with the specified username and credentials, if there is one; otherwise return null.
Parameters:
  username - Username of the Principal to look up
Parameters:
  credentials - Password or other credentials to use inauthenticating this username



authenticate
public Principal authenticate(String username, String clientDigest, String nOnce, String nc, String cnonce, String qop, String realm, String md5a2)(Code)
Return the Principal associated with the specified username, which matches the digest calculated using the given parameters using the method described in RFC 2069; otherwise return null.
Parameters:
  username - Username of the Principal to look up
Parameters:
  clientDigest - Digest which has been submitted by the client
Parameters:
  nOnce - Unique (or supposedly unique) token which has been usedfor this request
Parameters:
  realm - Realm name
Parameters:
  md5a2 - Second MD5 digest used to calculate the digest :MD5(Method + ":" + uri)



authenticate
public Principal authenticate(X509Certificate certs)(Code)
Return the Principal associated with the specified chain of X509 client certificates. If there is none, return null.
Parameters:
  certs - Array of client certificates, with the first one inthe array being the certificate of the client itself.



destroy
public void destroy()(Code)



digest
protected String digest(String credentials)(Code)
Digest the password using the specified algorithm and convert the result to a corresponding hexadecimal string. If exception, the plain credentials string is returned. IMPLEMENTATION NOTE - This implementation is synchronized because it reuses the MessageDigest instance. This should be faster than cloning the instance on every request.
Parameters:
  credentials - Password or other credentials to use inauthenticating this username



findLifecycleListeners
public LifecycleListener[] findLifecycleListeners()(Code)
Get the lifecycle listeners associated with this lifecycle. If this Lifecycle has no listeners registered, a zero-length array is returned.



findSecurityConstraints
public SecurityConstraint[] findSecurityConstraints(HttpRequest request, Context context)(Code)
Return the SecurityConstraints configured to guard the request URI for this request, or null if there is no such constraint.
Parameters:
  request - Request we are processing
Parameters:
  context - Context the Request is mapped to



getContainer
public Container getContainer()(Code)
Return the Container with which this Realm has been associated.



getController
public ObjectName getController()(Code)



getDebug
public int getDebug()(Code)
Return the debugging detail level for this component.



getDigest
public String getDigest()(Code)
Return the digest algorithm used for storing credentials.



getDigest
protected String getDigest(String username, String realmName)(Code)
Return the digest associated with given principal's user name.



getDomain
public String getDomain()(Code)



getInfo
public String getInfo()(Code)
Return descriptive information about this Realm implementation and the corresponding version number, in the format <description>/<version>.



getName
abstract protected String getName()(Code)
Return a short name for this Realm implementation, for use in log messages.



getObjectName
public ObjectName getObjectName()(Code)



getPassword
abstract protected String getPassword(String username)(Code)
Return the password associated with the given principal's user name.



getPrincipal
abstract protected Principal getPrincipal(String username)(Code)
Return the Principal associated with the given user name.



getType
public String getType()(Code)



getValidate
public boolean getValidate()(Code)
Return the "validate certificate chains" flag.



hasMessageDigest
protected boolean hasMessageDigest()(Code)



hasResourcePermission
public boolean hasResourcePermission(HttpRequest request, HttpResponse response, SecurityConstraint[] constraints, Context context) throws IOException(Code)
Perform access control based on the specified authorization constraint. Return true if this constraint is satisfied and processing should continue, or false otherwise.
Parameters:
  request - Request we are processing
Parameters:
  response - Response we are creating
Parameters:
  constraints - Security constraint we are enforcing
Parameters:
  context - The Context to which client of this class is attached.
exception:
  IOException - if an input/output error occurs



hasRole
public boolean hasRole(Principal principal, String role)(Code)
Return true if the specified Principal has the specified security role, within the context of this Realm; otherwise return false. This method can be overridden by Realm implementations, but the default is adequate when an instance of GenericPrincipal is used to represent authenticated Principals from this Realm.
Parameters:
  principal - Principal for whom the role is to be checked
Parameters:
  role - Security role to be checked



hasUserDataPermission
public boolean hasUserDataPermission(HttpRequest request, HttpResponse response, SecurityConstraint[] constraints) throws IOException(Code)
Enforce any user data constraint required by the security constraint guarding this request URI. Return true if this constraint was not violated and processing should continue, or false if we have created a response already.
Parameters:
  request - Request we are processing
Parameters:
  response - Response we are creating
Parameters:
  constraints - Security constraint being checked
exception:
  IOException - if an input/output error occurs



init
public void init()(Code)



log
protected void log(String message)(Code)
Log a message on the Logger associated with our Container (if any)
Parameters:
  message - Message to be logged



log
protected void log(String message, Throwable throwable)(Code)
Log a message on the Logger associated with our Container (if any)
Parameters:
  message - Message to be logged
Parameters:
  throwable - Associated exception



main
public static void main(String args)(Code)
Digest password using the algorithm especificied and convert the result to a corresponding hex string. If exception, the plain credentials string is returned



postDeregister
public void postDeregister()(Code)



postRegister
public void postRegister(Boolean registrationDone)(Code)



preDeregister
public void preDeregister() throws Exception(Code)



preRegister
public ObjectName preRegister(MBeanServer server, ObjectName name) throws Exception(Code)



removeLifecycleListener
public void removeLifecycleListener(LifecycleListener listener)(Code)
Remove a lifecycle event listener from this component.
Parameters:
  listener - The listener to remove



removePropertyChangeListener
public void removePropertyChangeListener(PropertyChangeListener listener)(Code)
Remove a property change listener from this component.
Parameters:
  listener - The listener to remove



setContainer
public void setContainer(Container container)(Code)
Set the Container with which this Realm has been associated.
Parameters:
  container - The associated Container



setController
public void setController(ObjectName controller)(Code)



setDebug
public void setDebug(int debug)(Code)
Set the debugging detail level for this component.
Parameters:
  debug - The new debugging detail level



setDigest
public void setDigest(String digest)(Code)
Set the digest algorithm used for storing credentials.
Parameters:
  digest - The new digest algorithm



setValidate
public void setValidate(boolean validate)(Code)
Set the "validate certificate chains" flag.
Parameters:
  validate - The new validate certificate chains flag



start
public void start() throws LifecycleException(Code)
Prepare for the beginning of active use of the public methods of this component. This method should be called before any of the public methods of this component are utilized. It should also send a LifecycleEvent of type START_EVENT to any registered listeners.
exception:
  LifecycleException - if this component detects a fatal errorthat prevents this component from being used



stop
public void stop() throws LifecycleException(Code)
Gracefully terminate the active use of the public methods of this component. This method should be the last one called on a given instance of this component. It should also send a LifecycleEvent of type STOP_EVENT to any registered listeners.
exception:
  LifecycleException - if this component detects a fatal errorthat needs to be reported



Methods inherited from java.lang.Object
native protected Object clone() throws CloneNotSupportedException(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
protected void finalize() throws Throwable(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.