JsonbProvider

java.lang.Object
- javax.json.bind.spi.JsonbProvider

```
public abstract class JsonbProvider
extends java.lang.Object
```
Service provider for JSON Binding implementations. Provider implementors must implement all abstract methods. API clients can obtain instance of default provider by calling:
```
 
 JsonbProvider provider = JsonbProvider.provider();
 }
```
Specific provider instance lookup:
```
 
 JsonbProvider provider;
 try {
   JsonbProvider.provider("foo.bar.ProviderImpl");
 } catch (JsonbException e) {
   // provider not found or could not be instantiated
 }
```
where 'foo.bar.ProviderImpl' is a vendor implementation class extending JsonbProvider and identified to service loader as specified in ServiceLoader documentation.
All the methods in this class are allowed to be called by multiple concurrent threads.
Since:

JSON Binding 1.0

See Also:

Jsonb, ServiceLoader

Constructor Summary

Constructors
Modifier Constructor and Description

protected JsonbProvider()
Protected constructor.

Constructors
Modifier	Constructor and Description
`protected`	`JsonbProvider()` Protected constructor.

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`abstract JsonbBuilder`	`create()` Returns a new instance of `JsonbBuilder` class.
`static JsonbProvider`	`provider()` Creates a JSON Binding provider object by using the `ServiceLoader.load(Class)` method.
`static JsonbProvider`	`provider(java.lang.String providerName)` Creates a JSON Binding provider object by using the `ServiceLoader.load(Class)` method, matching `providerName`.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - JsonbProvider
```
protected JsonbProvider()
```
    Protected constructor.
- Method Detail
  - provider
```
public static JsonbProvider provider()
```
    Creates a JSON Binding provider object by using the ServiceLoader.load(Class) method. The first provider of JsonbProvider class from list of providers returned by ServiceLoader.load call is returned. If there are no available service providers, this method tries to load the default service provider using Class.forName(String) method.
    
    Returns:
    
    JsonbProvider instance
    
    Throws:
    
    JsonbException - if there is no provider found, or there is a problem instantiating the provider instance.
    
    See Also:
    
    ServiceLoader
  - provider
```
public static JsonbProvider provider(java.lang.String providerName)
```
    Creates a JSON Binding provider object by using the ServiceLoader.load(Class) method, matching providerName. The first provider of JsonbProvider class from list of providers returned by ServiceLoader.load call, matching providerName is returned. If no such provider is found, JsonbException is thrown.
    
    Parameters:
    
    providerName - Class name (class.getName()) to be chosen from the list of providers returned by ServiceLoader.load(JsonbProvider.class) call.
    
    Returns:
    
    JsonbProvider instance
    
    Throws:
    
    JsonbException - if there is no provider found, or there is a problem instantiating the provider instance.
    
    java.lang.NullPointerException - if providerName is null.
    
    See Also:
    
    ServiceLoader
  - create
```
public abstract JsonbBuilder create()
```
    Returns a new instance of JsonbBuilder class. JsonbBuilder provides necessary getter methods to access required parameters.
    
    Returns:
    
    JsonbBuilder A new instance of class implementing JsonbBuilder. Always a non-null valid object.
    
    Throws:
    
    JsonbException - If an error was encountered while creating the JsonbBuilder instance.
    
    See Also:
    
    Jsonb, JsonbBuilder

Class JsonbProvider

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

JsonbProvider

Method Detail

provider

provider

create