Java CompositeName addAll()用法及代码示例

javax.naming.CompositeName类的addAll()方法用于将不同的复合名称对象的所有组件添加到此CompositeName对象。有两种不同的addAll()方法。

1. addAll(int，名称)：此方法用于添加另一个复合名称对象的所有组件，该复合名称对象作为参数传递到此复合名称对象中指定位置posn。在第一个新组件的位置或之后出现的此复合名称对象的其他组件将上移以容纳不同组件的所有组件。

   用法:

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

   参数：该方法接受

   
   
   
   • posn这是添加所有新组件的索引，并且
   • n这是要添加的非null组件。

   返回值：此方法返回更新的CompositeName对象，而不是新对象。返回的值不能为空。

   异常：如果posn在指定范围之外，则此方法引发ArrayIndexOutOfBoundsException;如果n不是复合名称，或者组件的添加违反了此复合名称的语法(例如超过组件数)，则抛出InvalidNameException。

   下面的程序说明CompositeName.addAll()方法：
   程序1:

   // 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 diffrenetComponent 
               = new CompositeName("9/99/999/9999"); 
     
           // apply addAll() to add All new components at posn 0 
           CompositeName newCompositeName 
               = (CompositeName) 
                     CompositeName1 
                         .addAll( 
                             0, diffrenetComponent); 
     
           // 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(名称)：Thie方法用于将经过输入的不同复合名称对象的所有组件添加到此复合名称的末尾。
   用法:

   public Name addAll(Name suffix)
               throws InvalidNameException
   

   参数：此方法接受后缀，该后缀是要添加的非null组件。

   返回值：此方法返回更新的CompositeName，而不是新的。返回的值不能为空。

   异常：如果后缀不是复合名称，或者添加的组件违反了此复合名称的语法(例如，超过组件数量)，则此方法将引发InvalidNameException。

   下面的程序说明CompositeName.addAll()方法：
   程序1:

   // 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 diffrenetComponent 
               = new CompositeName("9/99/999/9999"); 
     
           // apply addAll() to add All 
           // new components at posn 0 
           CompositeName newCompositeName 
               = (CompositeName) 
                     CompositeName1 
                         .addAll(diffrenetComponent); 
     
           // print value 
           System.out.println( 
               "Updated CompositeName Object:"
               + newCompositeName); 
       } 
   }

   输出：

   Updated CompositeName Object:1/2/3/4/5/6/7/9/99/999/9999
   

参考文献：
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)