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)