sun.security.x509

Class GeneralSubtrees

java.lang.Object

sun.security.x509.GeneralSubtrees

All Implemented Interfaces:

java.lang.Cloneable

public class GeneralSubtrees
extends java.lang.Object
implements java.lang.Cloneable

Represent the GeneralSubtrees ASN.1 object.

The ASN.1 for this is

 GeneralSubtrees ::= SEQUENCE SIZE (1..MAX) OF GeneralSubtree
 

Author:

Amit Kapoor, Hemma Prafullchandra, Andreas Sterbenz

Constructor Summary

Constructors

Constructor and Description
GeneralSubtrees() The default constructor for the class.
GeneralSubtrees(DerValue val) Create the object from the passed DER encoded form.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(GeneralSubtree tree)
java.lang.Object	clone()
boolean	contains(GeneralSubtree tree)
void	encode(DerOutputStream out) Encode the GeneralSubtrees.
boolean	equals(java.lang.Object obj) Compare two general subtrees by comparing the subtrees of each.
GeneralSubtree	get(int index)
int	hashCode()
GeneralSubtrees	intersect(GeneralSubtrees other) intersect this GeneralSubtrees with other.
java.util.Iterator<GeneralSubtree>	iterator()
void	reduce(GeneralSubtrees excluded) reduce this GeneralSubtrees by contents of another.
void	remove(int index)
int	size()
java.lang.String	toString() Return a printable string of the GeneralSubtree.
java.util.List<GeneralSubtree>	trees()
void	union(GeneralSubtrees other) construct union of this GeneralSubtrees with other.

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

GeneralSubtrees

public GeneralSubtrees()

The default constructor for the class.

GeneralSubtrees

public GeneralSubtrees(DerValue val)
                throws java.io.IOException

Create the object from the passed DER encoded form.

Parameters:

val - the DER encoded form of the same.

Throws:

java.io.IOException

Method Detail

get

public GeneralSubtree get(int index)

remove

public void remove(int index)

add

public void add(GeneralSubtree tree)

contains

public boolean contains(GeneralSubtree tree)

size

public int size()

iterator

public java.util.Iterator<GeneralSubtree> iterator()

trees

public java.util.List<GeneralSubtree> trees()

clone

public java.lang.Object clone()

Overrides:

clone in class java.lang.Object

toString

public java.lang.String toString()

Return a printable string of the GeneralSubtree.

Overrides:

toString in class java.lang.Object

encode

public void encode(DerOutputStream out)
            throws java.io.IOException

Encode the GeneralSubtrees.

Throws:

java.io.IOException

equals

public boolean equals(java.lang.Object obj)

Compare two general subtrees by comparing the subtrees of each.

Overrides:

equals in class java.lang.Object

Parameters:

other - GeneralSubtrees to compare to this

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

intersect

public GeneralSubtrees intersect(GeneralSubtrees other)

intersect this GeneralSubtrees with other. This function is used in merging permitted NameConstraints. The operation is performed as follows:

• If a name in other narrows all names of the same type in this, the result will contain the narrower name and none of the names it narrows.
• If a name in other widens all names of the same type in this, the result will not contain the wider name.
• If a name in other does not share the same subtree with any name of the same type in this, then the name is added to the list of GeneralSubtrees returned. These names should be added to the list of names that are specifically excluded. The reason is that, if the intersection is empty, then no names of that type are permitted, and the only way to express this in NameConstraints is to include the name in excludedNames.
• If a name in this has no name of the same type in other, then the result contains the name in this. No name of a given type means the name type is completely permitted.
• If a name in other has no name of the same type in this, then the result contains the name in other. This means that the name is now constrained in some way, whereas before it was completely permitted.

Parameters:

other - GeneralSubtrees to be intersected with this

union

public void union(GeneralSubtrees other)

construct union of this GeneralSubtrees with other.

Parameters:

other - GeneralSubtrees to be united with this

reduce

public void reduce(GeneralSubtrees excluded)

reduce this GeneralSubtrees by contents of another. This function is used in merging excluded NameConstraints with permitted NameConstraints to obtain a minimal form of permitted NameConstraints. It is an optimization, and does not affect correctness of the results.

Parameters:

excluded - GeneralSubtrees