Home | History | Annotate | Download | only in spec
      1 /*
      2  * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
      3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
      4  *
      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
      7  * published by the Free Software Foundation.  Oracle designates this
      8  * particular file as subject to the "Classpath" exception as provided
      9  * by Oracle in the LICENSE file that accompanied this code.
     10  *
     11  * This code is distributed in the hope that it will be useful, but WITHOUT
     12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
     13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
     14  * version 2 for more details (a copy is included in the LICENSE file that
     15  * accompanied this code).
     16  *
     17  * You should have received a copy of the GNU General Public License version
     18  * 2 along with this work; if not, write to the Free Software Foundation,
     19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
     20  *
     21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
     22  * or visit www.oracle.com if you need additional information or have any
     23  * questions.
     24  */
     25 
     26 package java.security.spec;
     27 
     28 /**
     29  * A (transparent) specification of the key material
     30  * that constitutes a cryptographic key.
     31  *
     32  * <p>If the key is stored on a hardware device, its
     33  * specification may contain information that helps identify the key on the
     34  * device.
     35  *
     36  * <P> A key may be specified in an algorithm-specific way, or in an
     37  * algorithm-independent encoding format (such as ASN.1).
     38  * For example, a DSA private key may be specified by its components
     39  * {@code x}, {@code p}, {@code q}, and {@code g}
     40  * (see {@link DSAPrivateKeySpec}), or it may be
     41  * specified using its DER encoding
     42  * (see {@link PKCS8EncodedKeySpec}).
     43  *
     44  * <P> This interface contains no methods or constants. Its only purpose
     45  * is to group (and provide type safety for) all key specifications.
     46  * All key specifications must implement this interface.
     47  *
     48  * @author Jan Luehe
     49  *
     50  *
     51  * @see java.security.Key
     52  * @see java.security.KeyFactory
     53  * @see EncodedKeySpec
     54  * @see X509EncodedKeySpec
     55  * @see PKCS8EncodedKeySpec
     56  * @see DSAPrivateKeySpec
     57  * @see DSAPublicKeySpec
     58  *
     59  * @since 1.2
     60  */
     61 
     62 public interface KeySpec { }
     63