-
public interface JsonArrayBuilder
A builder for creatingJsonArray
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 emptyJsonArray
instance.JsonArray array = Json.createArrayBuilder().build();
The class
JsonBuilderFactory
also contains methods to createJsonArrayBuilder
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 aJsonArray
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 aJsonNumber
.JsonArrayBuilder
add(BigInteger value)
Adds a value to the array as aJsonNumber
.JsonArrayBuilder
add(boolean value)
Adds aJsonValue.TRUE
orJsonValue.FALSE
value to the array.JsonArrayBuilder
add(double value)
Adds a value to the array as aJsonNumber
.JsonArrayBuilder
add(int value)
Adds a value to the array as aJsonNumber
.JsonArrayBuilder
add(JsonArrayBuilder builder)
Adds aJsonArray
from an array builder to the array.JsonArrayBuilder
add(JsonObjectBuilder builder)
Adds aJsonObject
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 aJsonNumber
.JsonArrayBuilder
add(String value)
Adds a value to the array as aJsonString
.JsonArrayBuilder
addNull()
Adds aJsonValue.NULL
value to the array.JsonArray
build()
Returns the current array.
-
-
-
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 aJsonString
.- 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 aJsonNumber
.- 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 aJsonNumber
.- 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 aJsonNumber
.- Parameters:
value
- the number value- Returns:
- this array builder
- See Also:
JsonNumber
-
add
JsonArrayBuilder add(long value)
Adds a value to the array as aJsonNumber
.- Parameters:
value
- the number value- Returns:
- this array builder
- See Also:
JsonNumber
-
add
JsonArrayBuilder add(double value)
Adds a value to the array as aJsonNumber
.- 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 aJsonValue.TRUE
orJsonValue.FALSE
value to the array.- Parameters:
value
- the boolean value- Returns:
- this array builder
-
addNull
JsonArrayBuilder addNull()
Adds aJsonValue.NULL
value to the array.- Returns:
- this array builder
-
add
JsonArrayBuilder add(JsonObjectBuilder builder)
Adds aJsonObject
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 aJsonArray
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
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 18/08/2025
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-javaee-rf-javax/json/JsonArrayBuilder.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor dieser Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.