src/share/classes/java/security/AlgorithmParametersSpi.java

*** 1,7 ****
  /*
!  * Copyright (c) 1997, 2004, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 29,39 ****
  import java.security.spec.AlgorithmParameterSpec;
  import java.security.spec.InvalidParameterSpecException;
  
  /**
   * This class defines the <i>Service Provider Interface</i> (<b>SPI</b>)
!  * for the <code>AlgorithmParameters</code> class, which is used to manage
   * algorithm parameters.
   *
   * <p> All the abstract methods in this class must be implemented by each
   * cryptographic service provider who wishes to supply parameter management
   * for a particular algorithm.
--- 29,39 ----
  import java.security.spec.AlgorithmParameterSpec;
  import java.security.spec.InvalidParameterSpecException;
  
  /**
   * This class defines the <i>Service Provider Interface</i> (<b>SPI</b>)
!  * for the {@code AlgorithmParameters} class, which is used to manage
   * algorithm parameters.
   *
   * <p> All the abstract methods in this class must be implemented by each
   * cryptographic service provider who wishes to supply parameter management
   * for a particular algorithm.
*** 50,60 ****
  
  public abstract class AlgorithmParametersSpi {
  
      /**
       * Initializes this parameters object using the parameters
!      * specified in <code>paramSpec</code>.
       *
       * @param paramSpec the parameter specification.
       *
       * @exception InvalidParameterSpecException if the given parameter
       * specification is inappropriate for the initialization of this parameter
--- 50,60 ----
  
  public abstract class AlgorithmParametersSpi {
  
      /**
       * Initializes this parameters object using the parameters
!      * specified in {@code paramSpec}.
       *
       * @param paramSpec the parameter specification.
       *
       * @exception InvalidParameterSpecException if the given parameter
       * specification is inappropriate for the initialization of this parameter
*** 75,87 ****
       */
      protected abstract void engineInit(byte[] params)
          throws IOException;
  
      /**
!      * Imports the parameters from <code>params</code> and
       * decodes them according to the specified decoding format.
!      * If <code>format</code> is null, the
       * primary decoding format for parameters is used. The primary decoding
       * format is ASN.1, if an ASN.1 specification for these parameters
       * exists.
       *
       * @param params the encoded parameters.
--- 75,87 ----
       */
      protected abstract void engineInit(byte[] params)
          throws IOException;
  
      /**
!      * Imports the parameters from {@code params} and
       * decodes them according to the specified decoding format.
!      * If {@code format} is null, the
       * primary decoding format for parameters is used. The primary decoding
       * format is ASN.1, if an ASN.1 specification for these parameters
       * exists.
       *
       * @param params the encoded parameters.
*** 94,108 ****
          throws IOException;
  
      /**
       * Returns a (transparent) specification of this parameters
       * object.
!      * <code>paramSpec</code> identifies the specification class in which
       * the parameters should be returned. It could, for example, be
!      * <code>DSAParameterSpec.class</code>, to indicate that the
       * parameters should be returned in an instance of the
!      * <code>DSAParameterSpec</code> class.
       *
       * @param paramSpec the specification class in which
       * the parameters should be returned.
       *
       * @return the parameter specification.
--- 94,108 ----
          throws IOException;
  
      /**
       * Returns a (transparent) specification of this parameters
       * object.
!      * {@code paramSpec} identifies the specification class in which
       * the parameters should be returned. It could, for example, be
!      * {@code DSAParameterSpec.class}, to indicate that the
       * parameters should be returned in an instance of the
!      * {@code DSAParameterSpec} class.
       *
       * @param paramSpec the specification class in which
       * the parameters should be returned.
       *
       * @return the parameter specification.
*** 126,136 ****
       */
      protected abstract byte[] engineGetEncoded() throws IOException;
  
      /**
       * Returns the parameters encoded in the specified format.
!      * If <code>format</code> is null, the
       * primary encoding format for parameters is used. The primary encoding
       * format is ASN.1, if an ASN.1 specification for these parameters
       * exists.
       *
       * @param format the name of the encoding format.
--- 126,136 ----
       */
      protected abstract byte[] engineGetEncoded() throws IOException;
  
      /**
       * Returns the parameters encoded in the specified format.
!      * If {@code format} is null, the
       * primary encoding format for parameters is used. The primary encoding
       * format is ASN.1, if an ASN.1 specification for these parameters
       * exists.
       *
       * @param format the name of the encoding format.