CompoundName add() method in Java with Examples

Last Updated : 28 Nov, 2022

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

add(int, String): This method is used to add a single component at a specified position posn passed as a parameter within this compound name. The other components of this compound name object present at or after the position 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 compound name object.

Return value: This method returns updated compoundName, 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 compound name's syntax. Below programs illustrate the CompoundName.add() method: Program 1:

Java

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

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);

        // apply add() to add
        // new component at posn 0
        CompoundName newCompoundName
            = (CompoundName)
                  CompoundName1.add(0, "000");

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

Output:

Updated CompoundName Object: 000@1@2@3@4@5@6@7

Program 2:

Java

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

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(
                "c/e/d/v/a/b/z/y/x/f",
                props);

        // apply add() to add
        // new component at posn 9
        CompoundName newCompoundName
            = (CompoundName)
                  CompoundName1.add(
                      9, "zzzzz");

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

Output:

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

add(String): The method is used to add a single component to the end of this compound name. Syntax:

public Name add(String comp)
       throws InvalidNameException

Parameters: This method accepts comp which is the new component to add in compound name object at the end. Return value: This method returns updated compoundName, 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 compound name's syntax. Below programs illustrate the CompoundName.add() method: Program 1:

Java

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

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);

        // apply add() to add
        // new component at end
        CompoundName newCompoundName
            = (CompoundName)
                  CompoundName1.add("9");

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

Output:

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

Program 2:

Java

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

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(
                "c/e/d/v/a/b/z/y/x/f",
                props);

        // apply add() to add
        // new component at end
        CompoundName newCompoundName
            = (CompoundName)
                  CompoundName1.add("ppp");

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

Output:

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

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

CompositeName addAll() method in Java with Examples

AmanSingh2210

Improve

Article Tags :

Practice Tags :

Java

CompoundName add() method in Java with Examples

Similar Reads

Thank You!

What kind of Experience do you want to share?