GeneralSubtrees (kona-pkix 1.0.7.1 API)

java.lang.Object
- com.tencent.kona.sun.security.x509.GeneralSubtrees

All Implemented Interfaces:: com.tencent.kona.sun.security.util.DerEncoder, java.lang.Cloneable

public class GeneralSubtrees
extends java.lang.Object
implements java.lang.Cloneable, com.tencent.kona.sun.security.util.DerEncoder

Represent the GeneralSubtrees ASN.1 object.

The ASN.1 for this is

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

Constructor Summary

Constructors
Constructor and Description
`GeneralSubtrees()` The default constructor for the class.
`GeneralSubtrees(com.tencent.kona.sun.security.util.DerValue val)` Create the object from the passed DER encoded form.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`add(GeneralSubtree tree)`
`java.lang.Object`	`clone()`
`boolean`	`contains(GeneralSubtree tree)`
`void`	`encode(com.tencent.kona.sun.security.util.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(com.tencent.kona.sun.security.util.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(com.tencent.kona.sun.security.util.DerOutputStream out)
```
    Encode the GeneralSubtrees.
    
    Specified by:
    
    encode in interface com.tencent.kona.sun.security.util.DerEncoder
    
    Parameters:
    
    out - the DerOutputStream to encode this object to.
  - 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:
    
    obj - GeneralSubtrees to compare to this
    
    Returns:
    
    true if match
  - 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
    
    Returns:
    
    GeneralSubtrees to be merged with excluded; these are empty-valued name types corresponding to entries that were of the same type but did not share the same subtree between this and other. Returns null if no such.
  - 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

Class GeneralSubtrees

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

GeneralSubtrees

GeneralSubtrees

Method Detail

get

remove

add

contains

size

iterator

trees

clone

toString

encode

equals

hashCode

intersect

union

reduce