CompositeName addAll() method in Java with Examples
The addAll() method of a javax.naming.CompositeName class is used to add all the component of a different composite name object to this CompositeName object.
There are two different addAll() methods.
1. addAll(int, Name): This method is used to add all the component of a different composite name object which is passed as a parameter at a specified position posn in this composite name object. The other components of this composite 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 InvalidNameExceptionParameters: 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 CompositeName 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 composite name, or if the addition of the components violates the syntax of this composite name (e.g. exceeding number of components).
Below programs illustrate the CompositeName.addAll() method:
Program 1:
Java
// Java program to demonstrate// CompositeName.addAll()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/8/9"); // different component to add at position 0 CompositeName differentComponent = new CompositeName("9/99/999/9999"); // apply addAll() to add All new components at posn 0 CompositeName newCompositeName = (CompositeName) CompositeName1 .addAll( 0, differentComponent); // print value System.out.println( "Updated CompositeName Object: " + newCompositeName); }} |
Updated CompositeName Object: 9/99/999/9999/1/2/3/4/5/6/7/8/9
2. addAll(Name): This method is used to add all the components of different composite name object passed as input to the end of this composite name.
Syntax:
public Name addAll(Name suffix)
throws InvalidNameExceptionParameters: This method accepts suffix which is the non-null components to add.
Return value: This method returns an updated CompositeName, not a new one. The returned value Cannot be null.
Exception: This method throws InvalidNameException if the suffix is not a composite name, or if the addition of the components violates the syntax of this composite name (e.g. exceeding number of components).
Below programs illustrate the CompositeName.addAll() method:
Program 1:
Java
// Java program to demonstrate// CompositeName.addAll()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"); // different component to add at position 0 CompositeName differentComponent = new CompositeName("9/99/999/9999"); // apply addAll() to add All // new components at posn 0 CompositeName newCompositeName = (CompositeName) CompositeName1 .addAll(differentComponent); // print value System.out.println( "Updated CompositeName Object: " + newCompositeName); }} |
Updated CompositeName Object: 1/2/3/4/5/6/7/9/99/999/9999
References:
https://docs.oracle.com/javase/10/docs/api/javax/naming/CompositeName.html#addAll(javax.naming.Name)
https://docs.oracle.com/javase/10/docs/api/javax/naming/CompositeName.html#add(int, java.lang.String)
Attention reader! Don’t stop learning now. Get hold of all the important Java Foundation and Collections concepts with the Fundamentals of Java and Java Collections Course at a student-friendly price and become industry ready. To complete your preparation from learning a language to DS Algo and many more, please refer Complete Interview Preparation Course.
