Retrofit Moshi Converter

implementation 'com.squareup.retrofit2:converter-moshi:3.0.0'

<dependency>
  <groupId>com.squareup.retrofit2</groupId>
  <artifactId>converter-moshi</artifactId>
  <version>3.0.0</version>
</dependency>

import retrofit2.converter.moshi.MoshiConverterFactory;
import com.squareup.moshi.Moshi;
import retrofit2.Retrofit;

import retrofit2.converter.moshi.MoshiConverterFactory;
import retrofit2.Retrofit;
import com.squareup.moshi.Moshi;

// Basic setup with default Moshi configuration
Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("https://api.example.com/")
    .addConverterFactory(MoshiConverterFactory.create())
    .build();

// Advanced setup with custom Moshi instance
Moshi moshi = new Moshi.Builder()
    .add(new DateAdapter())
    .build();

Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("https://api.example.com/")
    .addConverterFactory(MoshiConverterFactory.create(moshi))
    .build();

// Configuration options
Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("https://api.example.com/")
    .addConverterFactory(
        MoshiConverterFactory.create(moshi)
            .asLenient()
            .failOnUnknown()
            .withNullSerialization()
            .withStreaming()
    )
    .build();

/**
 * Create an instance using a default Moshi instance for conversion.
 */
public static MoshiConverterFactory create();

/**
 * Create an instance using the provided Moshi instance for conversion.
 * @param moshi The Moshi instance to use for JSON processing
 * @throws NullPointerException if moshi is null
 */
public static MoshiConverterFactory create(Moshi moshi);

/**
 * Return a new factory which uses lenient adapters that are tolerant of malformed JSON.
 */
public MoshiConverterFactory asLenient();

/**
 * Return a new factory which uses adapters that fail when encountering unknown JSON properties.
 */
public MoshiConverterFactory failOnUnknown();

/**
 * Return a new factory which includes null values in the serialized JSON output.
 */
public MoshiConverterFactory withNullSerialization();

/**
 * Return a new factory which streams serialization of request messages to bytes on the HTTP thread.
 * This is either the calling thread for Call.execute(), or one of OkHttp's background threads 
 * for Call.enqueue(). Response bytes are always converted on OkHttp's background threads.
 */
public MoshiConverterFactory withStreaming();

/**
 * Creates a converter for response bodies of the specified type.
 * @param type The type to convert to
 * @param annotations Annotations on the method
 * @param retrofit The Retrofit instance
 * @return A converter for ResponseBody to the specified type, or null if not handled
 */
public Converter<ResponseBody, ?> responseBodyConverter(
    Type type, 
    Annotation[] annotations, 
    Retrofit retrofit
);

/**
 * Creates a converter for request bodies of the specified type.
 * @param type The type to convert from
 * @param parameterAnnotations Annotations on the parameter
 * @param methodAnnotations Annotations on the method
 * @param retrofit The Retrofit instance
 * @return A converter from the specified type to RequestBody, or null if not handled
 */
public Converter<?, RequestBody> requestBodyConverter(
    Type type,
    Annotation[] parameterAnnotations,
    Annotation[] methodAnnotations,
    Retrofit retrofit
);

/**
 * The main converter factory class that extends Retrofit's Converter.Factory.
 * Instances are immutable and thread-safe.
 */
public final class MoshiConverterFactory extends Converter.Factory {
    // Factory methods and configuration methods as documented above
}

// Example error handling
try {
    MyObject obj = apiService.getData().execute().body();
} catch (JsonDataException e) {
    // Handle malformed JSON or unknown properties
    System.err.println("JSON parsing error: " + e.getMessage());
} catch (IOException e) {
    // Handle network or I/O errors
    System.err.println("Network error: " + e.getMessage());
}