```
public interface JsonArrayBuilder
```
A builder for creating JsonArray models from scratch. This interface initializes an empty JSON array model and provides methods to add values to the array model and to return the resulting array. The methods in this class can be chained to add multiple values to the array.
The class Json contains methods to create the builder object. The example code below shows how to build an empty JsonArray instance.
```
 
 JsonArray array = Json.createArrayBuilder().build();
 
 
```
The class JsonBuilderFactory also contains methods to create JsonArrayBuilder instances. A factory instance can be used to create multiple builder instances with the same configuration. This the preferred way to create multiple instances. The example code below shows how to build a JsonArray object that represents the following JSON array:
```
 
 [
     { "type": "home", "number": "212 555-1234" },
     { "type": "fax", "number": "646 555-4567" }
 ]
 
 
```
The following code creates the JSON array above:
```
 
 JsonBuilderFactory factory = Json.createBuilderFactory(config);
 JsonArray value = factory.createArrayBuilder()
     .add(factory.createObjectBuilder()
         .add("type", "home")
         .add("number", "212 555-1234"))
     .add(factory.createObjectBuilder()
         .add("type", "fax")
         .add("number", "646 555-4567"))
     .build();
 
 
```
This class does not allow null to be used as a value while building the JSON array
See Also:

JsonObjectBuilder

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`JsonArrayBuilder`	`add(BigDecimal value)` Adds a value to the array as a `JsonNumber`.
`JsonArrayBuilder`	`add(BigInteger value)` Adds a value to the array as a `JsonNumber`.
`JsonArrayBuilder`	`add(boolean value)` Adds a `JsonValue.TRUE` or `JsonValue.FALSE` value to the array.
`JsonArrayBuilder`	`add(double value)` Adds a value to the array as a `JsonNumber`.
`JsonArrayBuilder`	`add(int value)` Adds a value to the array as a `JsonNumber`.
`JsonArrayBuilder`	`add(JsonArrayBuilder builder)` Adds a `JsonArray` from an array builder to the array.
`JsonArrayBuilder`	`add(JsonObjectBuilder builder)` Adds a `JsonObject` from an object builder to the array.
`JsonArrayBuilder`	`add(JsonValue value)` Adds a value to the array.
`JsonArrayBuilder`	`add(long value)` Adds a value to the array as a `JsonNumber`.
`JsonArrayBuilder`	`add(String value)` Adds a value to the array as a `JsonString`.
`JsonArrayBuilder`	`addNull()` Adds a `JsonValue.NULL` value to the array.
`JsonArray`	`build()` Returns the current array.

Retour à la première page de API Java Table des matières Haut

- Method Detail
  - add
```
JsonArrayBuilder add(JsonValue value)
```
    Adds a value to the array.
    
    Parameters:
    
    value - the JSON value
    
    Returns:
    
    this array builder
    
    Throws:
    
    NullPointerException - if the specified value is null
  - add
```
JsonArrayBuilder add(String value)
```
    Adds a value to the array as a JsonString.
    
    Parameters:
    
    value - the string value
    
    Returns:
    
    this array builder
    
    Throws:
    
    NullPointerException - if the specified value is null
  - add
```
JsonArrayBuilder add(BigDecimal value)
```
    Adds a value to the array as a JsonNumber.
    
    Parameters:
    
    value - the number value
    
    Returns:
    
    this array builder
    
    Throws:
    
    NullPointerException - if the specified value is null
    
    See Also:
    
    JsonNumber
  - add
```
JsonArrayBuilder add(BigInteger value)
```
    Adds a value to the array as a JsonNumber.
    
    Parameters:
    
    value - the number value
    
    Returns:
    
    this array builder
    
    Throws:
    
    NullPointerException - if the specified value is null
    
    See Also:
    
    JsonNumber
  - add
```
JsonArrayBuilder add(int value)
```
    Adds a value to the array as a JsonNumber.
    
    Parameters:
    
    value - the number value
    
    Returns:
    
    this array builder
    
    See Also:
    
    JsonNumber
  - add
```
JsonArrayBuilder add(long value)
```
    Adds a value to the array as a JsonNumber.
    
    Parameters:
    
    value - the number value
    
    Returns:
    
    this array builder
    
    See Also:
    
    JsonNumber
  - add
```
JsonArrayBuilder add(double value)
```
    Adds a value to the array as a JsonNumber.
    
    Parameters:
    
    value - the number value
    
    Returns:
    
    this array builder
    
    Throws:
    
    NumberFormatException - if the value is Not-a-Number(NaN) or infinity
    
    See Also:
    
    JsonNumber
  - add
```
JsonArrayBuilder add(boolean value)
```
    Adds a JsonValue.TRUE or JsonValue.FALSE value to the array.
    
    Parameters:
    
    value - the boolean value
    
    Returns:
    
    this array builder
  - addNull
```
JsonArrayBuilder addNull()
```
    Adds a JsonValue.NULL value to the array.
    
    Returns:
    
    this array builder
  - add
```
JsonArrayBuilder add(JsonObjectBuilder builder)
```
    Adds a JsonObject from an object builder to the array.
    
    Parameters:
    
    builder - the object builder
    
    Returns:
    
    this array builder
    
    Throws:
    
    NullPointerException - if the specified builder is null
  - add
```
JsonArrayBuilder add(JsonArrayBuilder builder)
```
    Adds a JsonArray from an array builder to the array.
    
    Parameters:
    
    builder - the array builder
    
    Returns:
    
    this array builder
    
    Throws:
    
    NullPointerException - if the specified builder is null
  - build
```
JsonArray build()
```
    Returns the current array.
    
    Returns:
    
    the current JSON array

Traduction non disponible

Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.

Version en cache

21/08/2025 17:18:13 Cette version de la page est en cache (à la date du 21/08/2025 17:18:13) afin d'accélérer le traitement.
Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la version plus récente de la page.

Document créé le 11/06/2005, dernière modification le 18/08/2025
Source du document imprimé : https://www.gaudry.be/java-api-javaee-rf-javax/json/JsonArrayBuilder.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : https://docs.oracle.com, JsonArrayBuilder (Java(TM) EE 7 Specification APIs)

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Interface JsonArrayBuilder

Method Summary

Method Detail

add

add

add

add

add

add

add

add

addNull

add

add

build

Références