jdk/src/share/classes/javax/security/auth/login/ConfigurationSpi.java
changeset 18830 90956ead732f
parent 5506 202f599c92aa
equal deleted inserted replaced
18829:ec84f0c313b0 18830:90956ead732f
     1 /*
     1 /*
     2  * Copyright (c) 2005, Oracle and/or its affiliates. All rights reserved.
     2  * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.  Oracle designates this
     7  * published by the Free Software Foundation.  Oracle designates this
    26 
    26 
    27 package javax.security.auth.login;
    27 package javax.security.auth.login;
    28 
    28 
    29 /**
    29 /**
    30  * This class defines the <i>Service Provider Interface</i> (<b>SPI</b>)
    30  * This class defines the <i>Service Provider Interface</i> (<b>SPI</b>)
    31  * for the <code>Configuration</code> class.
    31  * for the {@code Configuration} class.
    32  * All the abstract methods in this class must be implemented by each
    32  * All the abstract methods in this class must be implemented by each
    33  * service provider who wishes to supply a Configuration implementation.
    33  * service provider who wishes to supply a Configuration implementation.
    34  *
    34  *
    35  * <p> Subclass implementations of this abstract class must provide
    35  * <p> Subclass implementations of this abstract class must provide
    36  * a public constructor that takes a <code>Configuration.Parameters</code>
    36  * a public constructor that takes a {@code Configuration.Parameters}
    37  * object as an input parameter.  This constructor also must throw
    37  * object as an input parameter.  This constructor also must throw
    38  * an IllegalArgumentException if it does not understand the
    38  * an IllegalArgumentException if it does not understand the
    39  * <code>Configuration.Parameters</code> input.
    39  * {@code Configuration.Parameters} input.
    40  *
    40  *
    41  *
    41  *
    42  * @since 1.6
    42  * @since 1.6
    43  */
    43  */
    44 
    44 
    60      * Refresh and reload the Configuration.
    60      * Refresh and reload the Configuration.
    61      *
    61      *
    62      * <p> This method causes this Configuration object to refresh/reload its
    62      * <p> This method causes this Configuration object to refresh/reload its
    63      * contents in an implementation-dependent manner.
    63      * contents in an implementation-dependent manner.
    64      * For example, if this Configuration object stores its entries in a file,
    64      * For example, if this Configuration object stores its entries in a file,
    65      * calling <code>refresh</code> may cause the file to be re-read.
    65      * calling {@code refresh} may cause the file to be re-read.
    66      *
    66      *
    67      * <p> The default implementation of this method does nothing.
    67      * <p> The default implementation of this method does nothing.
    68      * This method should be overridden if a refresh operation is supported
    68      * This method should be overridden if a refresh operation is supported
    69      * by the implementation.
    69      * by the implementation.
    70      *
    70      *