CompositeName add() method in Java with Examples

The add() method of a javax.naming.CompositeName class is used to add the component to the CompositeName object.
There are two different add method.

1. add(int, String): This method is used to add a single component at a specified position posn passed as a parameter within this composite name. The other components of this composite name object present at or after the posn of the new component are shifted up by one position to accommodate the new component.

Syntax:

public Name add(int posn, String comp)
       throws InvalidNameException

Parameters: This method accepts:

• posn which is the index at which to add the new component and
• comp which is the new component to add in composite name object.

Return value: This method returns an updated CompositeName, 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 adding comp at the specified position would violate the composite name’s syntax.

Below programs illustrate the CompositeName.add() method:

Program 1:

Java

// Java program to demonstrate
// CompositeName.add()

import java.util.Properties;
import javax.naming.CompositeName;
import javax.naming.InvalidNameException;

public class GFG {
    public static void main(String[] args)
        throws InvalidNameException
    {

        // create composite name object
        CompositeName CompositeName1
            = new CompositeName(
                "1/2/3/4/5/6/7");

        // apply add() to add new component at posn 0
        CompositeName newCompositeName
            = (CompositeName)
                  CompositeName1.add(0, "000");

        // print value
        System.out.println(
            "Updated CompositeName Object: "
            + newCompositeName);
    }
}

Output:

Updated CompositeName Object: 000/1/2/3/4/5/6/7

Program 2:

Java

// Java program to demonstrate
// CompositeName.add() method

import java.util.Properties;
import javax.naming.CompositeName;
import javax.naming.InvalidNameException;

public class GFG {
    public static void main(String[] args)
        throws InvalidNameException
    {

        // create composite name object
        CompositeName CompositeName1
            = new CompositeName(
                "c/e/d/v/a/b/z/y/x/f");

        // apply add() to add new component at posn 9
        CompositeName newCompositeName
            = (CompositeName)
                  CompositeName1.add(9, "zzzzz");

        // print value
        System.out.println(
            "Updated CompositeName Object: "
            + newCompositeName);
    }
}

Output:

Updated CompositeName Object: c/e/d/v/a/b/z/y/x/zzzzz/f

2. add(String): This method is used to add a single component to the end of this composite name.

Syntax:

public Name add(String comp)
       throws InvalidNameException

Parameters: This method accepts comp which is the new component to add in the composite name object at the end.

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

Exception: This method throws InvalidNameException If adding comp at the end of the name would violate the composite name’s syntax.

Below programs illustrate the CompositeName.add() method:

Program 1:

Java

// Java program to demonstrate
// CompositeName.add()

import java.util.Properties;
import javax.naming.CompositeName;
import javax.naming.InvalidNameException;

public class GFG {
    public static void main(String[] args)
        throws InvalidNameException
    {

        // create composite name object
        CompositeName CompositeName1
            = new CompositeName(
                "a/b/c/d/e/f/g/h/i/j");

        // apply add() to add new component at end
        CompositeName newCompositeName
            = (CompositeName)
                  CompositeName1.add("k");

        // print value
        System.out.println(
            "Updated CompositeName Object: "
            + newCompositeName);
    }
}

Output:

Updated CompositeName Object: a/b/c/d/e/f/g/h/i/j/k

Program 2:

Java

// Java program to demonstrate
// CompositeName.add() method

import java.util.Properties;
import javax.naming.CompositeName;
import javax.naming.InvalidNameException;

public class GFG {
    public static void main(String[] args)
        throws InvalidNameException
    {

        // create composite name object
        CompositeName CompositeName1
            = new CompositeName(
                "c/e/d/v/a/b/z/y/x/f");

        // apply add() to add new component at end
        CompositeName newCompositeName
            = (CompositeName)
                  CompositeName1.add("ppp");

        // print value
        System.out.println(
            "Updated CompositeName Object: "
            + newCompositeName);
    }
}

Output:

Updated CompositeName Object: c/e/d/v/a/b/z/y/x/f/ppp

References: 
https://docs.oracle.com/javase/10/docs/api/javax/naming/CompositeName.html#add(int, java.lang.String)
https://docs.oracle.com/javase/10/docs/api/javax/naming/CompositeName.html#add(java.lang.String)