com.entrust.toolkit.security.arithmetic.fields

Class GFpElement

java.lang.Object

com.entrust.toolkit.security.arithmetic.fields.GFpElement

All Implemented Interfaces:

FieldElement

Deprecated.

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

public class GFpElement
extends java.lang.Object
implements FieldElement

This class implements the FieldElement interface for the elements over GF(p).

Constructor Summary

Constructors

Constructor and Description
GFpElement(java.math.BigInteger number, Field field) Deprecated. This is the public constructor that takes the number and the field as arguments.

Method Summary

Methods

Modifier and Type	Method and Description
FieldElement	add(FieldElement element) Deprecated. Returns the field element that is the result of adding this to the given summand element.
boolean	equals(java.lang.Object object) Deprecated. Returns true if and only if this and the given value are the same.
FieldElement	exponentiate(java.math.BigInteger a) Deprecated. Exponentiates this with the given value.
java.math.BigInteger	getBigInteger() Deprecated. Returns the field element as a BigInteger.
Field	getField() Deprecated. Returns the field which is contained in a field element.
FieldElement	multiplicativeInverse() Deprecated. Returns the multiplicative inverse element of this.
FieldElement	multiply(FieldElement element) Deprecated. Returns the field element that is the result of multiplying element to this.
FieldElement	subtract(FieldElement element) Deprecated. Returns the field element that is the result of subtracting element from this.
ASN1Object	toASN1Object() Deprecated. Returns the ASN1 encoding of this element.
java.lang.String	toString() Deprecated. Returns the string representation.

Methods inherited from class java.lang.Object

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

Constructor Detail

GFpElement

public GFpElement(java.math.BigInteger number,
          Field field)
           throws java.lang.IllegalArgumentException

Deprecated.

This is the public constructor that takes the number and the field as arguments.

Parameters:

number - a BigInteger object

field - a Field object

Precondition:
field must be an object of subclass GFp.

Throws:

java.lang.IllegalArgumentException - If the precondition is not satisfied.

Method Detail

getField

public Field getField()

Deprecated.

Returns the field which is contained in a field element.

Specified by:

getField in interface FieldElement

Returns:

Returns field as Field object of subclass GFp.

getBigInteger

public java.math.BigInteger getBigInteger()

Deprecated.

Returns the field element as a BigInteger.

Specified by:

getBigInteger in interface FieldElement

Returns:

Returns the field element as BigInteger.

add

public FieldElement add(FieldElement element)
                 throws java.lang.IllegalArgumentException

Deprecated.

Returns the field element that is the result of adding this to the given summand element.

Specified by:

add in interface FieldElement

Parameters:

element - a FieldElement of subclass GFpElement.

Precondition:
element must be of subclass GFpElement and must contain the same field as this.

Returns:

the result of the addition operation as FieldElement object of subclass GFpElement.

Throws:

java.lang.IllegalArgumentException - If the precondition is not satisfied.

subtract

public FieldElement subtract(FieldElement element)
                      throws java.lang.IllegalArgumentException

Deprecated.

Returns the field element that is the result of subtracting element from this.

Specified by:

subtract in interface FieldElement

Parameters:

element - a FieldElement of subclass GFpElement.

Precondition:
element must be of subclass GFpElement and must contain the same field as this.

Returns:

this - element as a GFpElement object.

Throws:

java.lang.IllegalArgumentException - If the precondition is not satisfied.

multiplicativeInverse

public FieldElement multiplicativeInverse()
                                   throws java.lang.ArithmeticException

Deprecated.

Returns the multiplicative inverse element of this.

Specified by:

multiplicativeInverse in interface FieldElement

Returns:

the multiplicative inverse element of this as GFpElement object.

Throws:

java.lang.ArithmeticException - if this value equals zero and thus no inverse exists.

multiply

public FieldElement multiply(FieldElement element)
                      throws java.lang.IllegalArgumentException

Deprecated.

Returns the field element that is the result of multiplying element to this.

Specified by:

multiply in interface FieldElement

Parameters:

element - a FieldElement of subclass GFpElement.

Precondition:
element must be of subclass GFpElement and must contain the same field as this.

Returns:

this times the input parameter element as a GFpElement object.

Throws:

java.lang.IllegalArgumentException - If the precondition is not satisfied.

exponentiate

public FieldElement exponentiate(java.math.BigInteger a)

Deprecated.

Exponentiates this with the given value.

Specified by:

exponentiate in interface FieldElement

Parameters:

a - the exponent

Returns:

the value this power to the element as GFpElement object.

toASN1Object

public ASN1Object toASN1Object()

Deprecated.

Returns the ASN1 encoding of this element. The element is encoded as a byte array such that the zero-th byte represents the most significant byte of the element (big endian).

Specified by:

toASN1Object in interface FieldElement

Returns:

the number wrapped as an OCTET_STRING

equals

public boolean equals(java.lang.Object object)

Deprecated.

Returns true if and only if this and the given value are the same.

Specified by:

equals in interface FieldElement

Overrides:

equals in class java.lang.Object

Parameters:

object - the reference field element with which to compare

Returns:

true if and only if this and the given value are linked to the same field and contain the same number in that field.

toString

public java.lang.String toString()

Deprecated.

Returns the string representation.

Specified by:

toString in interface FieldElement

Overrides:

toString in class java.lang.Object

Returns:

the string