com.nimbusds.jose.jwk

Class ECKey.Curve

java.lang.Object

com.nimbusds.jose.jwk.ECKey.Curve

All Implemented Interfaces:

Serializable

Enclosing class:

ECKey

@Immutable
public static class ECKey.Curve
extends Object
implements Serializable

Cryptographic curve. This class is immutable.

Includes constants for the following standard cryptographic curves:

• P_256
• P_384
• P_521

See "Digital Signature Standard (DSS)", FIPS PUB 186-3, June 2009, National Institute of Standards and Technology (NIST).

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static ECKey.Curve	P_256 P-256 curve (secp256r1, also called prime256v1, OID = 1.2.840.10045.3.1.7).
static ECKey.Curve	P_384 P-384 curve (secp384r1, OID = 1.3.132.0.34).
static ECKey.Curve	P_521 P-521 curve (secp521r1).

Constructor Summary

Constructors

Constructor and Description
Curve(String name) Creates a new cryptographic curve with the specified JOSE name.
Curve(String name, String stdName, String oid) Creates a new cryptographic curve with the specified JOSE name, standard name and object identifier (OID).

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object object)
static ECKey.Curve	forECParameterSpec(ECParameterSpec spec) Gets the cryptographic curve for the specified parameter specification.
static ECKey.Curve	forJWSAlgoritm(JWSAlgorithm alg) Gets the cryptographic curve for the specified JWS algorithm.
static ECKey.Curve	forOID(String oid) Gets the cryptographic curve for the specified object identifier (OID).
static ECKey.Curve	forStdName(String stdName) Gets the cryptographic curve for the specified standard name.
String	getName() Returns the JOSE name of this cryptographic curve.
String	getOID() Returns the standard object identifier (OID) of this cryptographic curve.
String	getStdName() Returns the standard name of this cryptographic curve.
static ECKey.Curve	parse(String s) Parses a cryptographic curve from the specified string.
ECParameterSpec	toECParameterSpec() Returns the parameter specification for this cryptographic curve.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

P_256

public static final ECKey.Curve P_256

P-256 curve (secp256r1, also called prime256v1, OID = 1.2.840.10045.3.1.7).

P_384

public static final ECKey.Curve P_384

P-384 curve (secp384r1, OID = 1.3.132.0.34).

P_521

public static final ECKey.Curve P_521

P-521 curve (secp521r1).

Constructor Detail

Curve

public Curve(String name)

Creates a new cryptographic curve with the specified JOSE name. A standard curve name and object identifier (OID) are not unspecified.

Parameters:

name - The JOSE name of the cryptographic curve. Must not be null.

Curve

public Curve(String name,
             String stdName,
             String oid)

Creates a new cryptographic curve with the specified JOSE name, standard name and object identifier (OID).

Parameters:

name - The JOSE name of the cryptographic curve. Must not be null.

stdName - The standard name of the cryptographic curve, null if not specified.

oid - The object identifier (OID) of the cryptographic curve, null if not specified.

Method Detail

getName

public String getName()

Returns the JOSE name of this cryptographic curve.

Returns:

The JOSE name.

getStdName

public String getStdName()

Returns the standard name of this cryptographic curve.

Returns:

The standard name, null if not specified.

getOID

public String getOID()

Returns the standard object identifier (OID) of this cryptographic curve.

Returns:

The OID, null if not specified.

toECParameterSpec

public ECParameterSpec toECParameterSpec()

Returns the parameter specification for this cryptographic curve.

Returns:

The EC parameter specification, null if it cannot be determined.

toString

public String toString()

Overrides:

toString in class Object

See Also:

getName()

equals

public boolean equals(Object object)

Overrides:

equals in class Object

parse

public static ECKey.Curve parse(String s)

Parses a cryptographic curve from the specified string.

Parameters:

s - The string to parse. Must not be null or empty.

Returns:

The cryptographic curve.

forStdName

public static ECKey.Curve forStdName(String stdName)

Gets the cryptographic curve for the specified standard name.

Parameters:

stdName - The standard curve name. May be null.

Returns:

The curve, null if it cannot be determined.

forOID

public static ECKey.Curve forOID(String oid)

Gets the cryptographic curve for the specified object identifier (OID).

Parameters:

oid - The object OID. May be null.

Returns:

The curve, null if it cannot be determined.

forJWSAlgoritm

public static ECKey.Curve forJWSAlgoritm(JWSAlgorithm alg)

Gets the cryptographic curve for the specified JWS algorithm.

Parameters:

alg - The JWS algorithm. May be null.

Returns:

The curve, null if the JWS algorithm is not curve based, or the JWS algorithm is not supported.

forECParameterSpec

public static ECKey.Curve forECParameterSpec(ECParameterSpec spec)

Gets the cryptographic curve for the specified parameter specification.

Parameters:

spec - The EC parameter spec. May be null.

Returns:

The curve, null if it cannot be determined.