JsonDataSource
Leave feedback
On this page
Inheritance: java.lang.Object
public class JsonDataSource
Provides access to data of a JSON file or stream to be used while assembling a document.
To access data of the corresponding file or stream while assembling a document, pass an instance of this class as a data source to one of DocumentAssembler. assembleDocument overloads.
In template documents, if a top-level JSON element is an array, a JsonDataSource instance should be treated in the same way as if it was a DataTable instance. If a top-level JSON element is an object, a JsonDataSource instance should be treated in the same way as if it was a DataRow instance. For more information, see template syntax reference(https://docs.groupdocs.com/display/assemblyjava/Template+Syntax+-+Part+1+of+2#TemplateSyntax-Part1of2-UsingDataSources).
In template documents, you can work with typed values of JSON elements. For convenience, the engine replaces the set of JSON simple types with the following one:
- java.lang.Long
- java.lang.Double
- java.lang.Boolean
- java.util.Date
- java.lang.String
The engine automatically recognizes values of the extra types upon their JSON representations.
To override default behavior of JSON data loading, initialize and pass a JsonDataLoadOptions instance to a constructor of this class.
| Constructor | Description |
|---|---|
| JsonDataSource(String jsonPath) | Creates a new data source with data from a JSON file using default options for parsing JSON data. |
| JsonDataSource(String jsonPath, JsonDataLoadOptions options) | Creates a new data source with data from a JSON file using the specified options for parsing JSON data. |
| JsonDataSource(InputStream jsonStream) | Creates a new data source with data from a JSON stream using default options for parsing JSON data. |
| JsonDataSource(InputStream jsonStream, JsonDataLoadOptions options) | Initializes a new instance of this class. |
public JsonDataSource(String jsonPath)
Creates a new data source with data from a JSON file using default options for parsing JSON data.
Parameters:
| Parameter | Type | Description |
|---|---|---|
| jsonPath | java.lang.String | The path to the JSON file to be used as the data source. |
public JsonDataSource(String jsonPath, JsonDataLoadOptions options)
Creates a new data source with data from a JSON file using the specified options for parsing JSON data.
Parameters:
| Parameter | Type | Description |
|---|---|---|
| jsonPath | java.lang.String | The path to the JSON file to be used as the data source. |
| options | JsonDataLoadOptions | Options for parsing JSON data. |
public JsonDataSource(InputStream jsonStream)
Creates a new data source with data from a JSON stream using default options for parsing JSON data.
Parameters:
| Parameter | Type | Description |
|---|---|---|
| jsonStream | java.io.InputStream | The stream of JSON data to be used as the data source. |
public JsonDataSource(InputStream jsonStream, JsonDataLoadOptions options)
Initializes a new instance of this class.
Parameters:
| Parameter | Type | Description |
|---|---|---|
| jsonStream | java.io.InputStream | |
| options | JsonDataLoadOptions |
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.