diff --git a/1.x/retrofit/index-all.html b/1.x/retrofit/index-all.html index fceccb5010..3b706c6b8d 100644 --- a/1.x/retrofit/index-all.html +++ b/1.x/retrofit/index-all.html @@ -478,7 +478,7 @@

H

 
Header - Annotation Type in retrofit.http
-
Replaces the header with the the value of its target.
+
Replaces the header with the value of its target.
Headers - Annotation Type in retrofit.http
diff --git a/1.x/retrofit/retrofit/http/Header.html b/1.x/retrofit/retrofit/http/Header.html index 8d0bb024eb..30d351a549 100644 --- a/1.x/retrofit/retrofit/http/Header.html +++ b/1.x/retrofit/retrofit/http/Header.html @@ -98,7 +98,7 @@

Annotation Type Header

@Retention(value=RUNTIME) @Target(value=PARAMETER) public @interface Header -
Replaces the header with the the value of its target. +
Replaces the header with the value of its target. 

  @GET("/")
diff --git a/1.x/retrofit/retrofit/http/package-summary.html b/1.x/retrofit/retrofit/http/package-summary.html
index c20914e3d9..fb7b9cef85 100644
--- a/1.x/retrofit/retrofit/http/package-summary.html
+++ b/1.x/retrofit/retrofit/http/package-summary.html
@@ -152,7 +152,7 @@ 
Package retrofit.http

 
 Header
 
-
Replaces the header with the the value of its target.

+
Replaces the header with the value of its target.

 
 
 
diff --git a/2.x/retrofit/allclasses-frame.html b/2.x/retrofit/allclasses-frame.html
index 9ccc215687..a4c4d8b5d0 100644
--- a/2.x/retrofit/allclasses-frame.html
+++ b/2.x/retrofit/allclasses-frame.html
@@ -31,6 +31,7 @@ 
All Classes

 
  • HttpException
    • 
 
  • Invocation
    • 
 
  • Multipart
    • 
+
  • OptionalConverterFactory
    • 
 
  • OPTIONS
    • 
 
  • Part
    • 
 
  • PartMap
    • 
diff --git a/2.x/retrofit/allclasses-noframe.html b/2.x/retrofit/allclasses-noframe.html
index 51aec9f23d..eb3f09161a 100644
--- a/2.x/retrofit/allclasses-noframe.html
+++ b/2.x/retrofit/allclasses-noframe.html
@@ -31,6 +31,7 @@ 
    All Classes
    
 
  • HttpException
    • 
 
  • Invocation
    • 
 
  • Multipart
    • 
+
  • OptionalConverterFactory
    • 
 
  • OPTIONS
    • 
 
  • Part
    • 
 
  • PartMap
    • 
diff --git a/2.x/retrofit/index-all.html b/2.x/retrofit/index-all.html
index 0a9009a614..5ca07ab154 100644
--- a/2.x/retrofit/index-all.html
+++ b/2.x/retrofit/index-all.html
@@ -214,6 +214,8 @@ 
    C
    
 
    
 
    Returns an unmodifiable list of the factories tried when creating a request body converter, a response body converter, or a string converter.
    
 
    
+
    create() - Static method in class retrofit2.OptionalConverterFactory
    
+
     
    
 
    create(Class<T>) - Method in class retrofit2.Retrofit
    
 
    
 
    Create an implementation of the API endpoints defined by the service interface.
    
@@ -434,6 +436,11 @@ 
    O
    
 
    
 
    Invoked for a received HTTP response.
    
 
    
+
    OptionalConverterFactory - Class in retrofit2
    
+
    
+
    A Converter.Factory which supports Java's Optional to wrap null values from
+ another converter.
    
+
    
 
    OPTIONS - Annotation Type in retrofit2.http
    
 
    
 
    Make an OPTIONS request.
    
@@ -523,6 +530,8 @@ 
    R
    
 
    Returns a Converter for converting an HTTP response body to type, or null if
  type cannot be handled by this factory.
    
 
    
+
    responseBodyConverter(Type, Annotation[], Retrofit) - Method in class retrofit2.OptionalConverterFactory
    
+
     
    
 
    responseBodyConverter(Type, Annotation[]) - Method in class retrofit2.Retrofit
    
 
    
 
    Returns a Converter for ResponseBody to type from the available
diff --git a/2.x/retrofit/overview-tree.html b/2.x/retrofit/overview-tree.html
index 4707ebe4d8..40d0772d23 100644
--- a/2.x/retrofit/overview-tree.html
+++ b/2.x/retrofit/overview-tree.html
@@ -81,7 +81,11 @@ 
    Class Hierarchy
    
 
  • java.lang.Object
 
      
 
    • retrofit2.CallAdapter.Factory
      • 
-
    • retrofit2.Converter.Factory
      • 
+
    • retrofit2.Converter.Factory
+
+
      • 
 
    • retrofit2.Invocation
      • 
 
    • retrofit2.Response<T>
      • 
 
    • retrofit2.Retrofit
      • 
diff --git a/2.x/retrofit/retrofit2/Converter.Factory.html b/2.x/retrofit/retrofit2/Converter.Factory.html
index 2cde7e1d99..83b6a47454 100644
--- a/2.x/retrofit/retrofit2/Converter.Factory.html
+++ b/2.x/retrofit/retrofit2/Converter.Factory.html
@@ -106,6 +106,10 @@ 
      Class Converter.Factory
      
 
        
 
      • 
 
        
+
        Direct Known Subclasses:
        
+
        OptionalConverterFactory
        
+
        
+
        
 
        Enclosing interface:
        
 
        Converter<F,T>
        
 
        
diff --git a/2.x/retrofit/retrofit2/Invocation.html b/2.x/retrofit/retrofit2/Invocation.html
index a00d3e310f..ad05e31130 100644
--- a/2.x/retrofit/retrofit2/Invocation.html
+++ b/2.x/retrofit/retrofit2/Invocation.html
@@ -48,7 +48,7 @@
 
        
 
 
          
 
        • Frames
          • 
@@ -319,7 +319,7 @@ 
          toString
          
 
          
 
 
            
 
          • Frames
            • 
diff --git a/2.x/retrofit/retrofit2/OptionalConverterFactory.html b/2.x/retrofit/retrofit2/OptionalConverterFactory.html
new file mode 100644
index 0000000000..8629d24a75
--- /dev/null
+++ b/2.x/retrofit/retrofit2/OptionalConverterFactory.html
@@ -0,0 +1,284 @@
+
+
+
+
+
+OptionalConverterFactory (retrofit API)
+
+
+
+
+
+
+
+
            
+
+
+
            Skip navigation links
            
+
+
+
+
+
            
+
            
+
+
+
+
            
+
+
            
+
            
+
              
+
            • Summary: 
              • 
+
            • Nested | 
              • 
+
            • Field | 
              • 
+
            • Constr | 
              • 
+
            • Method
              • 
+
            
+
              
+
            • Detail: 
              • 
+
            • Field | 
              • 
+
            • Constr | 
              • 
+
            • Method
              • 
+
            
+
            
+
+
+
            
+
+
+
            
+
            retrofit2
            
+
            Class OptionalConverterFactory
            
+
            
+
            
+
+
            
+
              
+
            • 
+
              
+
              
+
              @IgnoreJRERequirement
+public final class OptionalConverterFactory
+extends Converter.Factory
              
+
              A Converter.Factory which supports Java's Optional to wrap null values from
+ another converter.
+ 
              
+ This factory is installed by default on the JVM and Android API 24+. If you are using another
+ converter which tries to serialize all types, such as Moshi or Gson, the default installation
+ of this factory never gets a chance to run. To work around this, you can explicitly install this
+ factory before your serialization library converter.
              
+
              • 
+
            
+
            
+
            
+
+
            
+
            
+
              
+
            • 
+
+
                
+
              • 
+
+
+
                Method Detail
                
+
+
+
+
+
+
+
+
                  
+
                • 
+
                  responseBodyConverter
                  
+
                  @Nullable
+public Converter<okhttp3.ResponseBody,?> responseBodyConverter(java.lang.reflect.Type type,
+                                                                         java.lang.annotation.Annotation[] annotations,
+                                                                         Retrofit retrofit)
                  
+
                  Description copied from class: Converter.Factory
                  
+
                  Returns a Converter for converting an HTTP response body to type, or null if
+ type cannot be handled by this factory. This is used to create converters for
+ response types such as SimpleResponse from a Call<SimpleResponse>
+ declaration.
                  
+
                  
+
                  Overrides:
                  
+
                  responseBodyConverter in class Converter.Factory
                  
+
                  
+
                  • 
+
                
+
                • 
+
              
+
              • 
+
            
+
            
+
            
+
+
+
            
+
+
+
            Skip navigation links
            
+
+
+
+
+
            
+
            
+
+
+
+
            
+
+
            
+
            
+
              
+
            • Summary: 
              • 
+
            • Nested | 
              • 
+
            • Field | 
              • 
+
            • Constr | 
              • 
+
            • Method
              • 
+
            
+
              
+
            • Detail: 
              • 
+
            • Field | 
              • 
+
            • Constr | 
              • 
+
            • Method
              • 
+
            
+
            
+
+
+
            
+
+
+
diff --git a/2.x/retrofit/retrofit2/Response.html b/2.x/retrofit/retrofit2/Response.html
index 1df64b8a68..f3c4802d29 100644
--- a/2.x/retrofit/retrofit2/Response.html
+++ b/2.x/retrofit/retrofit2/Response.html
@@ -47,7 +47,7 @@
 
          
 
          
 
 
            
@@ -432,7 +432,7 @@ 
            toString
            
 
          
 
          
 
 
            
diff --git a/2.x/retrofit/retrofit2/http/package-tree.html b/2.x/retrofit/retrofit2/http/package-tree.html
index 41e3a163fa..48a181032f 100644
--- a/2.x/retrofit/retrofit2/http/package-tree.html
+++ b/2.x/retrofit/retrofit2/http/package-tree.html
@@ -77,31 +77,31 @@ 
            Hierarchy For Package retrofit2.http
            
 
            
 
            Annotation Type Hierarchy
            
 
              
-
            • retrofit2.http.Field (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.HeaderMap (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.Path (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.Streaming (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.Tag (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.OPTIONS (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.QueryName (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.DELETE (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.Query (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.PartMap (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.PUT (implements java.lang.annotation.Annotation)
              • 
 
            • retrofit2.http.Part (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.FormUrlEncoded (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.Tag (implements java.lang.annotation.Annotation)
              • 
 
            • retrofit2.http.QueryMap (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.Header (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.FieldMap (implements java.lang.annotation.Annotation)
              • 
 
            • retrofit2.http.Multipart (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.Headers (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.HEAD (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.OPTIONS (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.Streaming (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.HTTP (implements java.lang.annotation.Annotation)
              • 
 
            • retrofit2.http.Body (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.PartMap (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.Field (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.GET (implements java.lang.annotation.Annotation)
              • 
 
            • retrofit2.http.POST (implements java.lang.annotation.Annotation)
              • 
 
            • retrofit2.http.PATCH (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.HTTP (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.QueryName (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.Headers (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.Query (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.FormUrlEncoded (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.PUT (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.FieldMap (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.HEAD (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.Header (implements java.lang.annotation.Annotation)
              • 
 
            • retrofit2.http.Url (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.GET (implements java.lang.annotation.Annotation)
              • 
-
            • retrofit2.http.DELETE (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.Path (implements java.lang.annotation.Annotation)
              • 
+
            • retrofit2.http.HeaderMap (implements java.lang.annotation.Annotation)
              • 
 
            
 
            
 
diff --git a/2.x/retrofit/retrofit2/package-frame.html b/2.x/retrofit/retrofit2/package-frame.html
index f45f807e4a..6f9f1a974b 100644
--- a/2.x/retrofit/retrofit2/package-frame.html
+++ b/2.x/retrofit/retrofit2/package-frame.html
@@ -22,6 +22,7 @@ 
            Classes
            
 
          • CallAdapter.Factory
            • 
 
          • Converter.Factory
            • 
 
          • Invocation
            • 
+
          • OptionalConverterFactory
            • 
 
          • Response
            • 
 
          • Retrofit
            • 
 
          • Retrofit.Builder
            • 
diff --git a/2.x/retrofit/retrofit2/package-summary.html b/2.x/retrofit/retrofit2/package-summary.html
index 2f0a37d394..3c406bd662 100644
--- a/2.x/retrofit/retrofit2/package-summary.html
+++ b/2.x/retrofit/retrofit2/package-summary.html
@@ -140,19 +140,26 @@ 
            Package retrofit2
            
 
 
 
+OptionalConverterFactory
+
+
            A Converter.Factory which supports Java's Optional to wrap null values from
+ another converter.
            
+
+
+
 Response<T>
 
 
            An HTTP response.
            
 
 
-
+
 Retrofit
 
 
            Retrofit adapts a Java interface to HTTP calls by using annotations on the declared methods to
  define how requests are made.
            
 
 
-
+
 Retrofit.Builder
 
 
            Build a new Retrofit.
            
diff --git a/2.x/retrofit/retrofit2/package-tree.html b/2.x/retrofit/retrofit2/package-tree.html
index 80f65faa13..e33f6a20be 100644
--- a/2.x/retrofit/retrofit2/package-tree.html
+++ b/2.x/retrofit/retrofit2/package-tree.html
@@ -80,7 +80,11 @@ 
            Class Hierarchy
            
 
          • java.lang.Object