ECParameters ("Entrust Authority Security Toolkit for the Java Platform")

java.lang.Object
- com.entrust.toolkit.security.provider.ECParameters

All Implemented Interfaces:: java.security.spec.AlgorithmParameterSpec

Deprecated.

since 7.2 SP2; use EcParameterSpecWithName instead

public class ECParameters
extends java.lang.Object
implements java.security.spec.AlgorithmParameterSpec

The ECParameters class provides a representation of elliptic curve parameters as defined in ANSI X9.62, sections 7.3 and 7.4.

The ASN1 structure is as follows:

 Parameters ::= CHOICE {
       ecParameters    ECParameters,
       namedCurve  CURVES.&id({CurveNames}),
       implicitlyCA    NULL
       }

where namedCurve is given as an OBJECT IDENTIFIER, and ECParameters is given by

 ECParameters ::= SEQUENCE {
    version    INTEGER { ecpVer1(1) } (ecpVer1),
    fieldID    FieldID {{FieldTypes}},
    curve  Curve,
    base   ECPoint,
    order  INTEGER,
    cofactor   INTEGER OPTIONAL,
    ...
    }

and

  Curve ::= SEQUENCE {
      a    FieldElement,
      b    FieldElement,
      seed BIT STRING  OPTIONAL
      }

ECPoint and FieldElement are fixed as OCTET STRINGs.

The fieldID is given as an OBJECT IDENTIFIER, either as a prime-field OID or as a characteristic-two-field OID, where

   ansi-X9-62 OBJECT IDENTIFIER ::= { iso(1) member-body(2) us(840) 10045 }
   id-fieldType OBJECT IDENTIFIER ::= { ansi-X9-62 fieldType(1) }
   prime-field OBJECT IDENTIFIER ::= { id-fieldType 1 }
   characteristic-two-field OBJECT IDENTIFIER ::= { id-fieldType 2 }

See Also:: NamedCurveFactory

Constructor Summary

Constructors
Constructor and Description
`ECParameters(ASN1Object object)` Deprecated. Constructor that requires a suitable ASN1 structure as an argument.
`ECParameters(ECPoint base, java.math.BigInteger order, java.math.BigInteger cofactor)` Deprecated. Constructor that requires an elliptic curve point, the order of the curve, and the co-factor (can be `null`) as arguments.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`ECPoint`	`getBase()` Deprecated. Returns the base point.
`java.math.BigInteger`	`getCofactor()` Deprecated. Returns the cofactor of the curve, if known — otherwise returns `null`.
`EllipticCurve`	`getCurve()` Deprecated. Returns the elliptic curve.
`Field`	`getField()` Deprecated. Returns the field.
`ObjectID`	`getNamedCurve()` Deprecated. Returns the named curve OID, if known — otherwise returns `null`.
`java.math.BigInteger`	`getOrder()` Deprecated. Returns the order of the curve.
`int`	`getVersion()` Deprecated. Returns the version number.
`void`	`setNamedCurve(ObjectID namedCurve)` Deprecated. Sets the named curve OID.
`ASN1Object`	`toASN1Object()` Deprecated. Returns an ASN.1 structure representing the calling `ECParamater` object.
`java.lang.String`	`toString()` Deprecated. Returns the calling object represented as a `String`.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - ECParameters
```
public ECParameters(ECPoint base,
                    java.math.BigInteger order,
                    java.math.BigInteger cofactor)
             throws java.lang.IllegalArgumentException
```
    Deprecated.
    
    Constructor that requires an elliptic curve point, the order of the curve, and the co-factor (can be null) as arguments.
    
    Parameters:
    
    base - an ECPoint object that contains an elliptic curve
    
    order - a BigInteger object that is the order of the base point on the curve
    
    cofactor - a BigInteger object that equals the number of points on the curve divided by the order (can be null, if this value is not known)
    Note
    
    Precondition: the cofactor, if not null, must be equal to the number of points on the curve divided by the order.
    
    Throws:
    
    java.lang.IllegalArgumentException - if base power raised to the order is not equal to the point at infinity on the given curve contained in base
  - ECParameters
```
public ECParameters(ASN1Object object)
             throws CodingException
```
    Deprecated.
    
    Constructor that requires a suitable ASN1 structure as an argument.
    Parameters:
    
    object - an ASN1Object object that must be formed as described in X9.62
    Note
    
    Precondition: if the ASN1object contains a non-null cofactor, the cofactor must be equal to the number of points on the curve divided by the order.
    
    Throws:
    CodingException - if any of the following conditions is satisfied:
    
    The ASN1Object is not in the expected format
    
    The named curve is not known or is not registered
    
    The parsed base point power raised to the parsed order is not equal to the point at infinity on the given curve contained in base point
- Method Detail
  - toASN1Object
```
public ASN1Object toASN1Object()
```
    Deprecated.
    
    Returns an ASN.1 structure representing the calling ECParamater object.
    If a named curve OID is known, it is used for encoding, otherwise the values are encoded explicitly. In other words, the Parameters structure as defined in ANSI X9.62, section 7.4 is returned.
    
    Returns:
    
    this element as an ASN.1 structure
  - getVersion
```
public int getVersion()
```
    Deprecated.
    
    Returns the version number.
    
    Returns:
    
    version number as integer (always 1)
  - getField
```
public Field getField()
```
    Deprecated.
    
    Returns the field.
    
    Returns:
    
    the field as a Field object
  - getCurve
```
public EllipticCurve getCurve()
```
    Deprecated.
    
    Returns the elliptic curve.
    
    Returns:
    
    the curve as an EllipticCurve object.
  - setNamedCurve
```
public void setNamedCurve(ObjectID namedCurve)
```
    Deprecated.
    
    Sets the named curve OID.
    Enables the encoding of the calling ECParameter object in ASN1 notation by wrapping the OID.
    
    Parameters:
    
    namedCurve - the named curve OID as an ObjectID object
    Note
    
    Precondition: namedCurve MUST be a valid OID of the calling ECParameter object.
  - getNamedCurve
```
public ObjectID getNamedCurve()
```
    Deprecated.
    
    Returns the named curve OID, if known — otherwise returns null.
    
    Returns:
    
    the named curve OID as an ObjectID object.
  - getBase
```
public ECPoint getBase()
```
    Deprecated.
    
    Returns the base point.
    
    Returns:
    
    the base point as an ECPoint object.
  - getOrder
```
public java.math.BigInteger getOrder()
```
    Deprecated.
    
    Returns the order of the curve.
    
    Returns:
    
    the order as a BigInteger object.
  - getCofactor
```
public java.math.BigInteger getCofactor()
```
    Deprecated.
    
    Returns the cofactor of the curve, if known — otherwise returns null.
    
    Returns:
    
    the cofactor as a BigInteger object.
  - toString
```
public java.lang.String toString()
```
    Deprecated.
    
    Returns the calling object represented as a String.
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    the string

Class ECParameters

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ECParameters

ECParameters

Method Detail

toASN1Object

getVersion

getField

getCurve

setNamedCurve

getNamedCurve

getBase

getOrder

getCofactor

toString