CompoundName addAll() method in Java with Examples

The addAll() method of a javax.naming.CompoundName class is used to add all the component of a diffrent compound name object to this CompoundName object.
There are two different addAll() methods.

addAll(int, Name):This method is used to add All the component of a different Compound name object which is passed as a parameter at a specified position posn in this compound name object. The other components of this compound name object present at or after the position of the first new component are shifted up to accommodate all the components of the different component.

Syntax:

public Name addAll(int posn, Name n)
       throws InvalidNameException

Parameters: This method accepts:

posn which is the index at which to add all the new components and
n which is the non-null components to add.

Return value: This method returns updated compoundName object, not a new one. The returned value Cannot be null.

Exception: This method throws ArrayIndexOutOfBoundsException If posn is outside the specified range and InvalidNameException If n is not a compound name, or if the addition of the components violates the syntax of this compound name (e.g. exceeding the number of components).

Below programs illustrate the CompoundName.addAll() method:
Program 1:

// Java program to demonstrate 
// CompoundName.addAll() 
  
import java.util.Properties; 
import javax.naming.CompoundName; 
import javax.naming.InvalidNameException; 
  
public class GFG { 
    public static void main(String[] args) 
        throws InvalidNameException 
    { 
  
        // need properties for CompoundName 
        Properties props = new Properties(); 
        props.put("jndi.syntax.separator", "@"); 
        props.put("jndi.syntax.direction", 
                  "left_to_right"); 
  
        // create compound name object 
        CompoundName CompoundName1 
            = new CompoundName( 
                "1@2@3@4@5@6@7", 
                props); 
  
        // different component to add at position 0 
        CompoundName diffrenetComponent 
            = new CompoundName( 
                "9@99@999@9999", 
                props); 
  
        // apply addAll() to add All 
        // new components at posn 0 
        CompoundName newCompoundName 
            = (CompoundName) 
                  CompoundName1.addAll( 
                      0, diffrenetComponent); 
  
        // print value 
        System.out.println( 
            "Updated CompoundName Object: "
            + newCompoundName); 
    } 
} 

Output:

Updated CompoundName Object: 9@99@999@9999@1@2@3@4@5@6@7

addAll(String): Thie method is used to add all the components of diffrent compound name object passeed as input to the end of this compound name.
Syntax:

public Name addAll(Name suffix)
       throws InvalidNameException

Parameters: This method accepts suffix which is the non-null components to add.

Return value: This method returns updated compoundName, not a new one. The returned value Cannot be null.

Exception: This method throws InvalidNameException if the suffix is not a compound name, or if the addition of the components violates the syntax of this compound name (e.g. exceeding the number of components).

Below programs illustrate the CompoundName.addAll() method:
Program 1:

// Java program to demonstrate 
// CompoundName.addAll() 
  
import java.util.Properties; 
import javax.naming.CompoundName; 
import javax.naming.InvalidNameException; 
  
public class GFG { 
    public static void main(String[] args) 
        throws InvalidNameException 
    { 
  
        // need properties for CompoundName 
        Properties props = new Properties(); 
        props.put("jndi.syntax.separator", "@"); 
        props.put("jndi.syntax.direction", 
                  "left_to_right"); 
  
        // create compound name object 
        CompoundName CompoundName1 
            = new CompoundName( 
                "1@2@3@4@5@6@7", props); 
  
        // different component to add at position 0 
        CompoundName diffrenetComponent 
            = new CompoundName( 
                "9@99@999@9999", props); 
  
        // apply addAll() to add All 
        // new components at posn 0 
        CompoundName newCompoundName 
            = (CompoundName) 
                  CompoundName1.addAll( 
                      diffrenetComponent); 
  
        // print value 
        System.out.println( 
            "Updated CompoundName Object: "
            + newCompoundName); 
    } 
} 

Output:

Updated CompoundName Object: 1@2@3@4@5@6@7@9@99@999@9999

References:
https://docs.oracle.com/javase/10/docs/api/javax/naming/CompoundName.html#addAll(javax.naming.Name)
https://docs.oracle.com/javase/10/docs/api/javax/naming/CompoundName.html#addAll(int, javax.naming.Name)

Attention reader! Don’t stop learning now. Get hold of all the important Java and Collections concepts with the Fundamentals of Java and Java Collections Course at a student-friendly price and become industry ready.

My Personal Notes

Recommended Posts: