com.entrust.toolkit.security.arithmetic.fields

Class PolynomialField

java.lang.Object

com.entrust.toolkit.security.arithmetic.fields.PolynomialField

All Implemented Interfaces:

Field

Deprecated.

since 8.0; use Entrust's new EC architecture com.entrust.toolkit.security.crypto.ec instead

public class PolynomialField
extends java.lang.Object
implements Field

Represents the field GF2m with a trinomial basis.

Constructor Summary

Constructors

Constructor and Description
PolynomialField(java.math.BigInteger basis) Deprecated. Creates a field over GF2m with the polynomial basis, basis.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj) Deprecated. Compares two polynomial fields for equality.
java.math.BigInteger	getBasis() Deprecated. Returns the generating polynomial as defined in X9.62.
int	getFieldSize() Deprecated. Returns the field size in bits.
java.lang.String	getFieldType() Deprecated. Returns a String defining the type of the calling field.
java.math.BigInteger	getNumberOfElements() Deprecated. Returns the number of elements in the calling field.
FieldElement	getOneElement() Deprecated. Returns the neutral element (or identity element) with respect to multiplication.
FieldElement	getZeroElement() Deprecated. Returns the neutral element (or identity element) with respect to addition.
ASN1Object	toASN1Object() Deprecated. Returns an ASN.1 structure representing the calling field.
java.lang.String	toString() Deprecated. Returns a String representation of the calling polynomial field.

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

PolynomialField

public PolynomialField(java.math.BigInteger basis)

Deprecated.

Creates a field over GF2m with the polynomial basis, basis.

The basis is not validated in any way (irreduceable, ...)

Parameters:

basis - the integer representation of a polynomial, according to X9.62.

Throws:

java.lang.IllegalArgumentException - if basis is negative or zero

Method Detail

getZeroElement

public FieldElement getZeroElement()

Deprecated.

Returns the neutral element (or identity element) with respect to addition.

The identity element is an element e, such that for all elements g in this field, g+e = g. There is only one such element.

Specified by:

getZeroElement in interface Field

Returns:

the zero element of the calling field

getOneElement

public FieldElement getOneElement()

Deprecated.

Returns the neutral element (or identity element) with respect to multiplication.

The identity element e such that for all elements g in this field, g*e = g. There is only one such element.

Specified by:

getOneElement in interface Field

Returns:

the one element of the calling field

getNumberOfElements

public java.math.BigInteger getNumberOfElements()

Deprecated.

Returns the number of elements in the calling field.

This method is identical to getFieldOrder.

Specified by:

getNumberOfElements in interface Field

Returns:

the number of elements in this field

getFieldType

public java.lang.String getFieldType()

Deprecated.

Returns a String defining the type of the calling field.

Specified by:

getFieldType in interface Field

Returns:

a String describing the type of this field

getBasis

public java.math.BigInteger getBasis()

Deprecated.

Returns the generating polynomial as defined in X9.62.

Returns:

the trinomial that generates the calling field

equals

public boolean equals(java.lang.Object obj)

Deprecated.

Compares two polynomial fields for equality.

Two polynomial fields are equal if their bases are equal.

Specified by:

equals in interface Field

Overrides:

equals in class java.lang.Object

Parameters:

obj - the reference polynomial field with which to compare

Returns:

true if this polynomial field is the same as the obj argument — false otherwise

toASN1Object

public ASN1Object toASN1Object()
                        throws java.lang.IllegalStateException

Deprecated.

Returns an ASN.1 structure representing the calling field.

The ASN.1 structure is built according to the definition in X9.62.

Specified by:

toASN1Object in interface Field

Returns:

the calling field as an ASN.1 structure

Throws:

java.lang.IllegalStateException - if the polynomial is neither a trinomial nor a pentanomial — no ASN.1 syntax is defined for trinomials or pentanomials

toString

public java.lang.String toString()

Deprecated.

Returns a String representation of the calling polynomial field.

Specified by:

toString in interface Field

Overrides:

toString in class java.lang.Object

Returns:

the hexadecimal value of the integer representation of the basis of this polynomial field

getFieldSize

public int getFieldSize()

Deprecated.

Returns the field size in bits.

For characteristic 2 finite fields F_2^m, m is returned.

Specified by:

getFieldSize in interface Field

Returns:

the field size in bits

Since:

7.2 SP2