[ { "path": ".editorconfig", "content": "root = true\n\n[*]\nindent_size = 2\ncharset = utf-8\ntrim_trailing_whitespace = true\ninsert_final_newline = true\n\n[*.{kt,kts}]\nij_kotlin_allow_trailing_comma = true\nij_kotlin_allow_trailing_comma_on_call_site = true\nij_kotlin_imports_layout = *\n\n[*.mjs]\nindent_style = tab\n\n[*.ts]\nindent_style = tab\n\n[*.css]\nindent_style = tab\n" }, { "path": ".gitattributes", "content": "* text=auto eol=lf\n\n*.bat text eol=crlf\n*.jar binary\n" }, { "path": ".github/CONTRIBUTING.md", "content": "Contributing\n============\n\nIf you would like to contribute code to Retrofit you can do so through GitHub by\nforking the repository and sending a pull request.\n\nWhen submitting code, please make every effort to follow existing conventions\nand style in order to keep the code as readable as possible. Please also make\nsure your code compiles by running `./gradlew build` (or `gradlew.bat build` on Windows).\n\nBefore your code can be accepted into the project you must also sign the\n[Individual Contributor License Agreement (CLA)][1].\n\n\n [1]: https://spreadsheets.google.com/spreadsheet/viewform?formkey=dDViT2xzUHAwRkI3X3k5Z0lQM091OGc6MQ&ndplr=1\n" }, { "path": ".github/ISSUE_TEMPLATE.md", "content": "What kind of issue is this?\n\n - [ ] Question. This issue tracker is not the place for questions. If you want to ask how to do\n something, or to understand why something isn't working the way you expect it to, use Stack\n Overflow. https://stackoverflow.com/questions/tagged/retrofit\n\n - [ ] Bug report. If you’ve found a bug, spend the time to write a failing test. Bugs with tests\n get fixed. Here’s an example: https://gist.github.com/swankjesse/6608b4713ad80988cdc9\n\n - [ ] Feature Request. Start by telling us what problem you’re trying to solve. Often a solution\n already exists! Don’t send pull requests to implement new features without first getting our\n support. Sometimes we leave features out on purpose to keep the project small.\n" }, { "path": ".github/pull_request_template.md", "content": "---\n\n- [ ] `CHANGELOG.md`'s \"Unreleased\" section has been updated, if applicable.\n" }, { "path": ".github/renovate.json5", "content": "{\n $schema: 'https://docs.renovatebot.com/renovate-schema.json',\n extends: [\n 'config:recommended',\n ],\n ignorePresets: [\n // Ensure we get the latest version and are not pinned to old versions.\n 'workarounds:javaLTSVersions',\n ],\n customManagers: [\n // Update .java-version file with the latest JDK version.\n {\n customType: 'regex',\n fileMatch: [\n '\\\\.java-version$',\n ],\n matchStrings: [\n '(?.*)\\\\n',\n ],\n datasourceTemplate: 'java-version',\n depNameTemplate: 'java',\n // Only write the major version.\n extractVersionTemplate: '^(?\\\\d+)',\n },\n ]\n}\n" }, { "path": ".github/workflows/.java-version", "content": "25\n" }, { "path": ".github/workflows/build.yml", "content": "name: build\n\non:\n pull_request: {}\n workflow_dispatch: {}\n push:\n branches:\n - 'trunk'\n tags-ignore:\n - '**'\n\nenv:\n GRADLE_OPTS: \"-Dorg.gradle.jvmargs=-Xmx4g -Dorg.gradle.daemon=false -Dkotlin.incremental=false -Dorg.gradle.logging.stacktrace=full\"\n\njobs:\n jvm:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - uses: actions/setup-java@v5\n with:\n distribution: 'zulu'\n java-version-file: .github/workflows/.java-version\n - uses: gradle/actions/setup-gradle@v5\n - run: ./gradlew build\n\n android:\n runs-on: ubuntu-latest\n\n strategy:\n fail-fast: false\n matrix:\n api-level:\n - 21\n - 24\n - 26\n - 29\n\n steps:\n - name: Enable KVM group perms\n run: |\n echo 'KERNEL==\"kvm\", GROUP=\"kvm\", MODE=\"0666\", OPTIONS+=\"static_node=kvm\"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules\n sudo udevadm control --reload-rules\n sudo udevadm trigger --name-match=kvm\n ls /dev/kvm\n\n - uses: actions/checkout@v6\n - uses: actions/setup-java@v5\n with:\n distribution: 'zulu'\n java-version-file: .github/workflows/.java-version\n\n - uses: gradle/actions/setup-gradle@v5\n\n - name: Run Tests\n uses: reactivecircus/android-emulator-runner@v2\n with:\n api-level: ${{ matrix.api-level }}\n script: ./gradlew connectedCheck\n env:\n API_LEVEL: ${{ matrix.api-level }}\n\n robovm:\n runs-on: macos-15-intel\n\n steps:\n - uses: actions/checkout@v6\n - uses: actions/setup-java@v5\n with:\n distribution: 'zulu'\n java-version-file: .github/workflows/.java-version\n\n - uses: gradle/actions/setup-gradle@v5\n\n - name: Run Tests\n run: ./gradlew retrofit:robovm-test:robovmTest\n\n website:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - uses: actions/setup-java@v5\n with:\n distribution: 'zulu'\n java-version-file: .github/workflows/.java-version\n - uses: gradle/actions/setup-gradle@v5\n\n - name: Build snapshot website\n run: |\n ./gradlew copyWebsiteDocs\n cd website\n npm install && npm run build -- --mode snapshot\n\n - uses: actions/upload-artifact@v7\n with:\n name: website\n path: website/dist\n if-no-files-found: error\n\n final-status:\n runs-on: ubuntu-latest\n if: ${{ !cancelled() }}\n needs:\n - jvm\n - android\n - robovm\n - website\n steps:\n - name: Check\n run: |\n results=$(tr -d '\\n' <<< '${{ toJSON(needs.*.result) }}')\n if ! grep -q -v -E '(failure|cancelled)' <<< \"$results\"; then\n echo \"One or more required jobs failed\"\n exit 1\n fi\n\n publish:\n runs-on: ubuntu-latest\n if: github.repository == 'square/retrofit' && github.ref == 'refs/heads/trunk'\n needs:\n - final-status\n\n steps:\n - uses: actions/checkout@v6\n - uses: actions/setup-java@v5\n with:\n distribution: 'zulu'\n java-version-file: .github/workflows/.java-version\n - uses: gradle/actions/setup-gradle@v5\n\n - run: ./gradlew publish\n env:\n ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.SONATYPE_CENTRAL_USERNAME }}\n ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.SONATYPE_CENTRAL_PASSWORD }}\n ORG_GRADLE_PROJECT_signingInMemoryKey: ${{ secrets.GPG_SECRET_KEY }}\n ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{ secrets.GPG_SECRET_PASSPHRASE }}\n\n - uses: actions/download-artifact@v8\n with:\n name: website\n path: website/dist\n\n - name: Deploy snapshot website\n uses: JamesIves/github-pages-deploy-action@releases/v3\n with:\n branch: site\n folder: website/dist\n target_folder: latest\n clean: true\n" }, { "path": ".github/workflows/release.yaml", "content": "name: release\n\non:\n push:\n tags:\n - '**'\n\nenv:\n GRADLE_OPTS: \"-Dorg.gradle.jvmargs=-Xmx4g -Dorg.gradle.daemon=false -Dkotlin.incremental=false -Dorg.gradle.logging.stacktrace=full\"\n\njobs:\n publish:\n runs-on: ubuntu-latest\n\n steps:\n - uses: actions/checkout@v6\n - uses: actions/setup-java@v5\n with:\n distribution: 'zulu'\n java-version-file: .github/workflows/.java-version\n\n - run: ./gradlew publish\n env:\n ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.SONATYPE_CENTRAL_USERNAME }}\n ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.SONATYPE_CENTRAL_PASSWORD }}\n ORG_GRADLE_PROJECT_signingInMemoryKey: ${{ secrets.GPG_SECRET_KEY }}\n ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{ secrets.GPG_SECRET_PASSPHRASE }}\n\n - name: Extract release notes\n id: release_notes\n uses: ffurrer2/extract-release-notes@v3\n\n - name: Create release\n uses: ncipollo/release-action@v1\n with:\n body: ${{ steps.release_notes.outputs.release_notes }}\n discussionCategory: Announcements\n\n - name: Build release website\n run: |\n ./gradlew copyWebsiteDocs\n cd website\n npm install && npm run build -- --mode release\n\n - name: Deploy release website\n uses: JamesIves/github-pages-deploy-action@releases/v3\n with:\n branch: site\n folder: website/dist\n clean: true\n clean-exclude: |\n .nojekyll\n latest/**\n" }, { "path": ".gitignore", "content": "# Gradle\n.gradle\nbuild\n/reports\nlocal.properties\n\n# Idea\n.idea\n*.iml\n" }, { "path": "BUG-BOUNTY.md", "content": "Serious about security\n======================\n\nSquare recognizes the important contributions the security research community\ncan make. We therefore encourage reporting security issues with the code\ncontained in this repository.\n\nIf you believe you have discovered a security vulnerability, please follow the\nguidelines at https://bugcrowd.com/squareopensource\n\n" }, { "path": "CHANGELOG.md", "content": "# Change Log\n\n## [Unreleased]\n[Unreleased]: https://github.com/square/retrofit/compare/3.0.0...HEAD\n\n**New**\n\n - Add explicit keep rules for RxJava `Result` types to prevent their generic information from being removed.\n - Add `allowoptimization` flags for most kept types.\n - Add `Invocation.annotationUrl` which returns the original URL from the method annotation.\n\n**Changed**\n\n - In-development snapshots are now published to the Central Portal Snapshots repository at https://central.sonatype.com/repository/maven-snapshots/.\n\n**Fixed**\n\n - Nothing yet!\n\n\n## [3.0.0] - 2025-05-15\n[3.0.0]: https://github.com/square/retrofit/releases/tag/3.0.0\n\n**Changed**\n\n - Upgrade to OkHttp 4.12 (from 3.14).\n\n This is the version of OkHttp that is written in Kotlin, and as a result Retrofit now has a transitive Kotlin dependency. However, this is also the _supported_ version of OkHttp whereas the previous version was out of support for nearly 4 years.\n\n\nNote: The 3.x versions of Retrofit maintain forward binary-compatibility with the 2.x versions.\nThis means libraries compiled against 2.x can still be used with the 3.x versions.\n\n\n## [2.12.0] - 2025-05-15\n[2.12.0]: https://github.com/square/retrofit/releases/tag/2.12.0\n\n**New**\n\n - First-party converters now support deferring serialization to happen when the request body is written (i.e., during HTTP execution) rather than when the HTTP request is created. In some cases this moves conversion from a calling thread to a background thread, such as in the case when using `Call.enqueue` directly.\n\n The following converters support this feature through a new `withStreaming()` factory method:\n - Gson\n - Jackson\n - Moshi\n - Protobuf\n - Wire\n\n**Fixed**\n\n - Primitive types used with `@Tag` now work by storing the value boxed with the boxed class as the key.\n\n\n## [2.11.0] - 2024-03-28\n\n**New**\n\n - The built-in `OptionalConverterFactory` is now public to allow installing it before other converters which consume all types (e.g., Moshi, Gson, Jackson, etc.).\n\n**Fixed**\n\n - Ensure that exceptions thrown from failure to parse method annotations can be observed by multiple threads/callers. Previously only the first caller would see the actual parsing exception and other callers would get a cryptic `ClassCastException`.\n\n\n## [2.10.0] - 2024-03-18\n\n**New**\n\n - Support using `Unit` as a response type. This can be used for non-body HTTP methods like `HEAD` or body-containing HTTP methods like `GET` where the body will be discarded without deserialization.\n - kotlinx.serialization converter!\n\n This was imported from [github.com/JakeWharton/retrofit2-kotlinx-serialization-converter/](https://github.com/JakeWharton/retrofit2-kotlinx-serialization-converter/) and remains unchanged from its 1.0.0 release.\n\n The Maven coordinates are `com.squareup.retrofit2:converter-kotlinx-serialization`.\n - JAXB 3 converter!\n\n The Maven coordinates are `com.squareup.retrofit2:converter-jaxb3`.\n - `@Header`, `@Headers`, and `@HeaderMap` can now set non-ASCII values through the `allowUnsafeNonAsciiValues` annotation property. These are not technically compliant with the HTTP specification, but are often supported or required by services.\n - Publish a BOM of all modules. The Maven coordinates are `com.squareup.retrofit2:retrofit-bom`.\n - `Invocation` now exposes the service `Class` and the instance on which the method was invoked. This disambiguates the source when service inheritence is used.\n - A response type keeper annotation processor is now available for generating shrinker rules for all referenced types in your service interface. In some cases, it's impossible for static shrinker rules to keep the entirety of what Retrofit needs at runtime. This annotation processor generates those additional rules. For more info see [its README](https://github.com/square/retrofit/tree/trunk/retrofit-response-type-keeper#readme).\n\n**Changed**\n- Add shrinker rules to retain the generic signatures of built-in types (`Call`, `Response`, etc.) which are used via reflection at runtime.\n- Remove backpressure support from RxJava 2 and 3 adapters. Since we only deliver a single value and the Reactive Streams specification states that callers must request a non-zero subscription value, we never need to honor backpressure.\n- Kotlin `Retrofit.create` function now has a non-null lower bound. Even if you specified a nullable type before this function would never return null.\n- Suspend functions now capture and defer all `Throwable` subtypes (not just `Exception` subtypes) to avoid Java's `UndeclaredThrowableException` when thrown synchronously.\n- Eagerly reject `suspend fun` functions that return `Call`. These are never correct, and should declare a return type of `Body` directly.\n- Support for Java 14-specific and Java 16-specific reflection needed to invoke default methods on interfaces have been moved to separate versions of a class through a multi-release jar. This should have no observable impact other than the jar now contains classes which target Java 14 and Java 16 bytecode that might trip up some static analysis tools which are not aware of multi-release jars.\n- Parameter names are now displayed in exception messages when available in the underlying Java bytecode.\n- Jackson converter now supports binary formats by using byte streams rather than character streams in its implementation. Use the `create(ObjectMapper, MediaType)` overload to supply the value of the `Content-Type` header for your format.\n\n**Fixed**\n- Do not include synthetic methods when doing eager validation.\n- Use per-method rather than per-class locking when parsing annotations. This eliminates contention when multiple calls are made in quick succession at the beginning of the process lifetime.\n\n\n## [2.9.0] - 2020-05-20\n\n * New: RxJava 3 adapter!\n\n The Maven coordinates are `com.squareup.retrofit2:adapter-rxjava3`.\n\n Unlike the RxJava 1 and RxJava 2 adapters, the RxJava 3 adapter's `create()` method will produce asynchronous HTTP requests by default. For synchronous requests use `createSynchronous()` and for synchronous on a scheduler use `createWithScheduler(..)`.\n\n\n## [2.8.2] - 2020-05-18\n\n * Fix: Detect running on the Android platform by using system property rather than the presence of classes.\n This ensures that even when you're running on the JVM with Android classes present on the classpath you\n get JVM semantics.\n * Fix: Update to OkHttp 3.14.9 which contains an associated Android platform detection fix.\n\n\n## [2.8.1] - 2020-03-25\n\n * Fix: Do not access `MethodHandles.Lookup` on Android API 24 and 25. The class is only available\n on Android API 26 and higher.\n\n\n## [2.8.0] - 2020-03-23\n\n * New: Add `Call.timeout()` which returns the `okio.Timeout` of the full call.\n * Fix: Change `Call.awaitResponse()` to accept a nullable response type.\n * Fix: Support default methods on Java 14+. We had been working around a bug in earlier versions of\n Java. That bug was fixed in Java 14, and the fix broke our workaround.\n\n\n## [2.7.2] - 2020-02-24\n\n * Fix: Update to OkHttp 3.14.7 for compatibility with Android R (API 30).\n\n\n## [2.7.1] - 2020-01-02\n\n * Fix: Support 'suspend' functions in services interfaces when using 'retrofit-mock' artifact.\n\n\n## [2.7.0] - 2019-12-09\n\n**This release changes the minimum requirements to Java 8+ or Android 5+.**\nSee [this blog post](https://cashapp.github.io/2019-02-05/okhttp-3-13-requires-android-5) for more information on the change.\n\n * New: Upgrade to OkHttp 3.14.4. Please see [its changelog for 3.x](https://square.github.io/okhttp/changelog_3x/).\n * Fix: Allow service interfaces to extend other interfaces.\n * Fix: Ensure a non-null body is returned by `Response.error`.\n\n\n## [2.6.4] - 2020-01-02\n\n * Fix: Support 'suspend' functions in services interfaces when using 'retrofit-mock' artifact.\n\n\n## [2.6.3] - 2019-12-09\n\n * Fix: Change mechanism for avoiding `UndeclaredThrowableException` in rare cases from using `yield`\n an explicit dispatch which ensures that it will work even on dispatchers which do not support yielding.\n\n\n## [2.6.2] - 2019-09-23\n\n * Fix: Avoid `IOException`s being wrapped in `UndeclaredThrowableException` in rare cases when using\n `Response<..>` as a return type for Kotlin 'suspend' functions.\n\n\n## [2.6.1] - 2019-07-31\n\n * Fix: Avoid `IOException`s being wrapped in `UndeclaredThrowableException` in rare cases.\n * Fix: Include no-content `ResponseBody` for responses created by `Response.error`.\n * Fix: Update embedded R8/ProGuard rules to not warn about nested classes used for Kotlin extensions.\n\n\n## [2.6.0] - 2019-06-05\n\n * New: Support `suspend` modifier on functions for Kotlin! This allows you to express the asynchrony of HTTP requests\n in an idiomatic fashion for the language.\n\n ```kotlin\n @GET(\"users/{id}\")\n suspend fun user(@Path(\"id\") id: Long): User\n ```\n\n Behind the scenes this behaves as if defined as `fun user(...): Call` and then invoked with `Call.enqueue`.\n You can also return `Response` for access to the response metadata.\n\n Currently this integration only supports non-null response body types. Follow\n [issue 3075](https://github.com/square/retrofit/issues/3075) for nullable type support.\n\n * New: **`@Tag`** parameter annotation for setting tags on the underlying OkHttp `Request` object. These can be read\n in `CallAdapter`s or OkHttp `Interceptor`s for tracing, analytics, varying behavior, and more.\n\n * New: **`@SkipCallbackExecutor`** method annotation will result in your `Call` invoking its `Callback` on the\n background thread on which the HTTP call was made.\n\n * New: Support OkHttp's `Headers` type for `@HeaderMap` parameters.\n\n * New: Add `Retrofit.Builder.baseUrl(URL)` overload.\n\n * Fix: Add embedded R8/ProGuard rule which retains Retrofit interfaces (while still allowing obfuscation). This\n is needed because R8 running in 'full mode' (i.e., not in ProGuard-compatibility mode) will see that there are\n no subtypes of these interfaces and rewrite any code which references instances to null.\n * Fix: Mark `HttpException.response()` as `@Nullable` as serializing the exception does not retain this instance.\n * Fix: Fatal errors (such as stack overflows, out of memory, etc.) now propagate to the OkHttp `Dispatcher` thread\n on which they are running.\n * Fix: Ensure JAX-B converter closes the response body when an exception is thrown during deserialization.\n * Fix: Ignore static methods when performing eager validation of interface methods.\n * Fix: Ensure that calling `source()` twice on the `ResponseBody` passed to a `Converter` always returns the same\n instance. Prior to the fix, intermediate buffering would cause response data to be lost.\n\n\n## [2.5.0] - 2018-11-18\n\n * New: Built-in support for Kotlin's `Unit` type. This behaves the same as Java's `Void` where the body\n content is ignored and immediately discarded.\n * New: Built-in support for Java 8's `Optional` and `CompletableFuture` types. Previously the 'converter-java8'\n and 'adapter-java8' dependencies were needed and explicitly adding `Java8OptionalConverterFactory` and/or\n `Java8CallAdapterFactory` to your `Retrofit.Builder` in order to use these types. Support is now built-in and\n those types and their artifacts are marked as deprecated.\n * New: `Invocation` class provides a reference to the invoked method and argument list as a tag on the\n underlying OkHttp `Call`. This can be accessed from an OkHttp interceptor for things like logging, analytics,\n or metrics aggregation.\n * New: Kotlin extension for `Retrofit` which allows you call `create` passing the interface type only as\n a generic parameter (e.g., `retrofit.create()`).\n * New: Added `Response.success` overload which allows specifying a custom 2xx status code.\n * New: Added `Calls.failure` overload which allows passing any `Throwable` subtype.\n * New: Minimal R8 rules now ship inside the jar requiring no client configuration in the common case.\n * Fix: Do not propagate fatal errors to the callback. They are sent to the thread's uncaught\n exception handler.\n * Fix: Do not enqueue/execute an otherwise useless call when the RxJava type is disposed by `onSubscribe`.\n * Fix: Call `RxJavaPlugins` assembly hook when creating an RxJava 2 type.\n * Fix: Ensure both the Guava and Java 8 `Optional` converters delegate properly. This ensures that converters\n registered prior to the optional converter can be used for deserializing the body type.\n * Fix: Prevent `@Path` values from participating in path-traversal. This ensures untrusted input passed as\n a path value cannot cause you to make a request to an un-intended relative URL.\n * Fix: Simple XML converter (which is deprecated) no longer wraps subtypes of `RuntimeException`\n or `IOException` when it fails.\n * Fix: Prevent JAXB converter from loading remote entities and DTDs.\n * Fix: Correctly detect default methods in interfaces on Android (API 24+). These still do not work, but\n now a correct exception will be thrown when detected.\n * Fix: Report more accurate exceptions when a `@QueryName` or `@QueryMap` precedes a `@Url` parameter.\n * Update OkHttp dependency to 3.12.\n\n\n## [2.4.0] - 2018-03-14\n\n * New: `Retrofit.Builder` exposes mutable lists of the added converter and call adapter factories.\n * New: Call adapter added for Scala's `Future`.\n * New: Converter for JAXB replaces the now-deprecated converter for Simple XML Framework.\n * New: Add Java 9 automatic module names for each artifact corresponding to their root package.\n * Fix: Do not swallow `Error`s from callbacks (usually `OutOfMemoryError`).\n * Fix: Moshi and Gson converters now assert that the full response was consumed. This prevents\n hiding bugs in faulty adapters which might not have consumed the full JSON input which would\n then cause failures on the next request over that connection.\n * Fix: Do not conflate OkHttp `Call` cancelation with RxJava unsubscription/disposal. Prior to\n this change, canceling of a `Call` would prevent a cancelation exception from propagating down\n the Rx stream.\n\n\n## [2.3.0] - 2017-05-13\n\n * **Retrofit now uses `@Nullable` to annotate all possibly-null values.** We've\n added a compile-time dependency on the JSR 305 annotations. This is a\n [provided][maven_provided] dependency and does not need to be included in\n your build configuration, `.jar` file, or `.apk`. We use\n `@ParametersAreNonnullByDefault` and all parameters and return types are\n never null unless explicitly annotated `@Nullable`.\n\n **Warning: this release is source-incompatible for Kotlin users.**\n Nullability was previously ambiguous and lenient but now the compiler will\n enforce strict null checks.\n\n * New: Converters added for Java 8's and Guava's `Optional` which wrap a potentially-nullable\n response body. These converters still rely on normal serialization library converters for parsing\n the response bytes into an object.\n * New: String converters that return `null` for an `@Query` or `@Field` parameter are now skipped.\n * New: The mock module's `NetworkBehavior` now throws a custom subclass of `IOException` to more\n clearly indicate the exception's source.\n * RxJava 1.x converter updated to 1.3.0 which stabilizes the use of `Completable`.\n * Fix: Add explicit handling for `OnCompleteFailedException`, `OnErrorFailedException`, and\n `OnErrorNotImplementedException` for RxJava 1.x to ensure they're correct delivered to the\n plugins/hooks for handling.\n * Fix: `NoSuchElementException` thrown when unsubscribing from an RxJava 1.x `Single`.\n\n\n## [2.2.0] - 2017-02-21\n\n * RxJava 2.x is now supported with a first-party 'adapter-rxjava2' artifact.\n * New: `@QueryName` annotation allows creating a query parameter with no '=' separator or value.\n * New: Support for messages generated by Protobuf 3.0 or newer when using the converter for Google's\n protobuf.\n * New: RxJava 1.x call adapter now correctly handles broken subscribers whose methods throw exceptions.\n * New: Add `toString()` implementations for `Response` and `Result`.\n * New: The Moshi converter factory now offers methods for enabling null serialization and lenient\n parsing.\n * New: Add `createAsync()` to RxJava 1.x call adapter factory which executes requests using\n `Call.enqueue()` using the underlying HTTP client's asynchronous support.\n * New: `NetworkBehavior` now allows setting an error percentage and returns HTTP errors when triggered.\n * `HttpException` has been moved into the main artifact and should be used instead of the versions\n embedded in each adapter (which have been deprecated).\n * Promote the response body generic type on `CallAdapter` from the `adapt` method to the enclosing\n class. This is a source-incompatible but binary-compatible change which is only relevant if you are\n implementing your own `CallAdapter`s.\n * Remove explicit handling of the now-defunct RoboVM platform.\n * Fix: Close response on HTTP 204 and 205 to avoid resource leak.\n * Fix: Reflect the canceled state of the HTTP client's `Call` in Retrofit's `Call`.\n * Fix: Use supplied string converters for the `String` type on non-body parameters. This allows user\n converters to handle cases such as when annotating string parameters instead of them always using\n the raw string.\n * Fix: Skip a UTF-8 BOM (if present) when using the converter for Moshi.\n\n\n## [2.1.0] - 2016-06-15\n\n * New: `@HeaderMap` annotation and support for supplying an arbitrary number of headers to an endpoint.\n * New: `@JsonAdapter` annotations on the `@Body` parameter and on the method will be propagated to Moshi\n for creating the request and response adapters, respectively.\n * Fix: Honor the `Content-Type` encoding of XML responses when deserializing response bodies.\n * Fix: Remove the stacktrace from fake network exceptions created from retrofit-mock's `NetworkBehavior`.\n They had the potential to be misleading and look like a library issue.\n * Fix: Eagerly catch malformed `Content-Type` headers supplied via `@Header` or `@Headers`.\n\n\n## [2.0.2] - 2016-04-14\n\n * New: `ProtoConverterFactory.createWithRegistry()` method accepts an extension registry to be used\n when deserializing protos.\n * Fix: Pass the correct `Call` instance to `Callback`'s `onResponse` and `onFailure` methods such\n that calling `clone()` retains the correct threading behavior.\n * Fix: Reduce the per-request allocation overhead for the RxJava call adapter.\n\n\n## [2.0.1] - 2016-03-30\n\n * New: Support OkHttp's `HttpUrl` as a `@Url` parameter type.\n * New: Support iterable and array `@Part` parameters using OkHttp's `MultipartBody.Part`.\n * Fix: Honor backpressure in `Observable`s created from the RxJavaCallAdapterFactory.\n\n\n## [2.0.0] - 2016-03-11\n\nRetrofit 2 is a major release focused on extensibility. The API changes are numerous but solve\nshortcomings of the previous version and provide a path for future enhancement.\n\nBecause the release includes breaking API changes, we're changing the project's package name from\n`retrofit` to `retrofit2`. This should make it possible for large applications and libraries to\nmigrate incrementally. The Maven group ID is now `com.squareup.retrofit2`. For an explanation of\nthis strategy, see Jake Wharton's post, [Java Interoperability Policy for Major Version\nUpdates](http://jakewharton.com/java-interoperability-policy-for-major-version-updates/).\n\n * **Service methods return `Call`.** This allows them to be executed synchronously or\n asynchronously using the same method definition. A `Call` instance represents a single\n request/response pair so it can only be used once, but you can `clone()` it for re-use.\n Invoking `cancel()` will cancel in-flight requests or prevent the request from even being\n performed if it has not already.\n\n * **Multiple converters for multiple serialization formats.** API calls returning different\n formats (like JSON, protocol buffers, and plain text) no longer need to be separated into\n separate service interfaces. Combine them together and add multiple converters. Converters are\n chosen based on the response type you declare. Gson is no longer included by default, so you will\n always need to add a converter for any serialization support. OkHttp's `RequestBody` and\n `ResponseBody` types can always be used without adding one, however.\n\n * **Call adapters allow different execution mechanisms.** While `Call` is the built-in mechanism,\n support for additional ones can be added similar to how different converters can be added.\n RxJava's `Observable` support has moved into a separate artifact as a result, and support for\n Java 8's `CompletableFuture` and Guava's `ListenableFuture` are also provided as additional\n artifacts.\n\n * **Generic response type includes HTTP information and deserialized body.** You no longer have to\n choose between the deserialized body and reading HTTP information. Every `Call` automatically\n receives both via the `Response` type and the RxJava, Guava, and Java 8 call adapters also\n support it.\n\n * **@Url for hypermedia-like APIs.** When your API returns links for pagination, additional\n resources, or updated content they can now be used with a service method whose first parameter\n is annotated with `@Url`.\n\nChanges from beta 4:\n\n * New: `RxJavaCallAdapterFactory` now supports service methods which return `Completable` which\n ignores and discards response bodies, if any.\n * New: `RxJavaCallAdapterFactory` supports supplying a default `Scheduler` which will be used\n for `subscribeOn` on returned `Observable`, `Single`, and `Completable` instances.\n * New: `MoshiConverterFactory` supports creating an instance which uses lenient parsing.\n * New: `@Part` can omit the part name and use OkHttp's `MultipartBody.Part` type for supplying\n parts. This lets you customize the headers, name, and filename and provide the part body in a\n single argument.\n * The `BaseUrl` interface and support for changeable base URLs was removed. This functionality\n can be done using an OkHttp interceptor and a sample showcasing it was added.\n * `Response.isSuccess()` was renamed to `Response.isSuccessful()` for parity with the name of\n OkHttp's version of that method.\n * Fix: Throw a more appropriate exception with a message when a resolved url (base URL + relative\n URL) is malformed.\n * Fix: `GsonConverterFactory` now honors settings on the `Gson` instance (like leniency).\n * Fix: `ScalarsConverterFactory` now supports primitive scalar types in addition to boxed for\n response body parsing.\n * Fix: `Retrofit.callbackExecutor()` may now return an executor even when one was not explicitly\n provided. This allows custom `CallAdapter.Factory` implementations to use it when triggering\n callbacks to ensure they happen on the appropriate thread for the platform (e.g., Android).\n\n\n## [2.0.0-beta4] - 2016-02-04\n\n * New: `Call` instance is now passed to both `onResponse` and `onFailure` methods of `Callback`. This aids\n in detecting when `onFailure` is called as a result of `Call.cancel()` by checking `Call.isCanceled()`.\n * New: `Call.request()` returns (optionally creating) the `Request` object for the call. Note: If this is\n called before `Call.execute()` or `Call.enqueue()` this will do relatively expensive work synchronously.\n Doing so in performance-critical sections (like on the Android main thread) should be avoided.\n * New: Support for the release version of OkHttp 3.0 and newer.\n * New: `adapter-guava` module provides a `CallAdapter.Factory` for Guava's `ListenableFuture`.\n * New: `adapter-java8` module provides a `CallAdapter.Factory` for Java 8's `CompleteableFuture`.\n * New: `ScalarsConverterFactory` (from `converter-scalars` module) now supports parsing response bodies\n into either `String`, the 8 primitive types, or the 8 boxed primitive types.\n * New: Automatic support for sending callbacks to the iOS main thread when running via RoboVM.\n * New: Method annotations are now passed to the factory for request body converters. This allows converters\n to alter the structure of both request bodies and response bodies with a single method-level annotation.\n * Each converter has been moved to its own package under `retrofit2.converter.`. This prevents type\n collisions when many converters are simultaneously in use.\n * Fix: Exceptions thrown when unable to locate a `CallAdapter.Factory` for a method return type now\n correctly list the `CallAdapter.Factory` instances checked.\n * Fix: Ensure default methods on service interfaces can be invoked.\n * Fix: Correctly resolve the generic parameter types of collection interfaces when subclasses of those\n collections are used as method parameters.\n * Fix: Do not encode `/` characters in `@Path` replacements when `encoded = true`.\n\n\n## [2.0.0-beta3] - 2016-01-05\n\n * New: All classes have been migrated to the `retrofit2.*` package name. The Maven groupId is now\n `com.squareup.retrofit2`. This is in accordance with the\n [Java Interoperability Policy for Major Version Updates](http://jakewharton.com/java-interoperability-policy-for-major-version-updates/).\n With this change Retrofit 2.x can coexiest with Retrofit 1.x in the same project.\n * New: Update to use the OkHttp 3 API and OkHttp 3.0.0-RC1 or newer is now required. Similar to the previous\n point, OkHttp has a new package name (`okhttp3.*`) and Maven groupId (`com.squareup.okhttp3`) which allow\n it to coexist with OkHttp 2.x in the same project.\n * New: String converters allow for custom serialization of parameters that end up as strings (such as `@Path`,\n `@Query`, `@Header`, etc.). `Converter.Factory` has a new `stringConverter` method which receives the\n parameter type and annotations and can return a converter for that type. This allows providing custom\n rendering of types like `Date`, `User`, etc. to a string before being used for its purpose. A default\n converter will call `toString()` for any type which retains the mimics the previous behavior.\n * New: OkHttp's `Call.Factory` type is now used as the HTTP client rather than using the `OkHttpClient` type\n directly (`OkHttpClient` does implement `Call.Factory`). A `callFactory` method has been added to both\n `Retrofit.Builder` and `Retrofit` to allow supplying alternate implementations of an HTTP client. The\n `client(OkHttpClient)` method on `Retrofit.Builder` still exists as a convenience.\n * New: `isExecuted()` method returns whether a `Call` has been synchronously or asynchronously executed.\n * New: `isCanceled()` method returns whether a `Call` has been canceled. Use this in `onFailure` to determine\n whether the callback was invoked from cancellation or actual transport failure.\n * New: `converter-scalars` module provides a `Converter.Factory` for converting `String`, the 8 primitive\n types, and the 8 boxed primitive types as `text/plain` bodies. Install this before your normal converter\n to avoid passing these simple scalars through, for example, a JSON converter.\n * New: `Converter.Factory` methods now receive a `Retrofit` instance which also now has methods for querying\n the next converter for a given type. This allows implementations to delegate to others and provide\n additional behavior without complete reimplementation.\n * New: `@OPTIONS` annotation more easily allows for making OPTIONS requests.\n * New: `@Part` annotation now supports `List` and array types.\n * New: The `@Url` annotation now allows using `java.net.URI` or `android.net.Uri` (in addition to `String`)\n as parameter types for providing relative or absolute endpoint URLs dynamically.\n * New: The `retrofit-mock` module has been rewritten with a new `BehaviorDelegate` class for implementing\n fake network behavior in a local mock implementation of your service endpoints. Documentation and more\n tests are forthcoming, but the `SimpleMockService` demonstrates its use for now.\n * Fix: Forbid Retrofit's `Response` type and OkHttp's `Response` type as the response body type given to\n a `Call` (i.e., `Call`). OkHttp's `ResponseBody` type is the correct one to use when the raw\n body contents are desired.\n * Fix: The Gson converter now respects settings on the supplied `Gson` instance (such as `serializeNulls`).\n This requires Gson 2.4 or newer.\n * The Wire converter has been updated to the Wire 2.0 API.\n * The change in 2.0.0-beta2 which provided the `Retrofit` instance to the `onResponse` callback of `Callback`\n has been reverted. There are too many edge cases around providing the `Retrofit` object in order to allow\n deserialization of the error body. To accommodate this use case, pass around the `Retrofit` response\n manually or implement a custom `CallAdapter.Factory` does so automatically.\n\n\n## [2.0.0-beta2] - 2015-09-28\n\n * New: Using a response type of `Void` (e.g., `Call`) will ignore and discard the response body. This\n can be used when there will be no response body (such as in a 201 response) or whenever the body is not\n needed. `@Head` requests are now forced to use this as their response type.\n * New: `validateEagerly()` method on `Retrofit.Builder` will verify the correctness of all service methods\n on calls to `create()` instead of lazily validating on first use.\n * New: `Converter` is now parameterized over both 'from' and 'to' types with a single `convert` method.\n `Converter.Factory` is now an abstract class and has factory methods for both request body and response\n body.\n * New: `Converter.Factory` and `CallAdapter.Factory` now receive the method annotations when being created\n for a return/response type and the parameter annotations when being created for a parameter type.\n * New: `callAdapter()` method on `Retrofit` allows querying a `CallAdapter` for a given type. The\n `nextCallAdapter()` method allows delegating to another `CallAdapter` from within a `CallAdapter.Factory`.\n This is useful for composing call adapters to incrementally build up behavior.\n * New: `requestConverter()` and `responseConverter()` methods on `Retrofit` allow querying a `Converter` for\n a given type.\n * New: `onResponse` method in `Callback` now receives the `Retrofit` instance. Combined with the\n `responseConverter()` method on `Retrofit`, this provides a way of deserializing an error body on `Response`.\n See the `DeserializeErrorBody` sample for an example.\n * New: The `MoshiConverterFactory` has been updated for its v1.0.0.\n * Fix: Using `ResponseBody` for the response type or `RequestBody` for a parameter type is now correctly\n identified. Previously these types would erroneously be passed to the supplied converter.\n * Fix: The encoding of `@Path` values has been corrected to conform to OkHttp's `HttpUrl`.\n * Fix: Use form-data content disposition subtype for `@Multipart`.\n * Fix: `Observable` and `Single`-based execution of requests now behave synchronously (and thus requires\n `subscribeOn()` for running in the background).\n * Fix: Correct `GsonConverterFactory` to honor the configuration of the `Gson` instances (such as not\n serializing null values, the default).\n\n\n## [2.0.0-beta1] - 2015-08-27\n\n * New: `Call` encapsulates a single request/response HTTP call. A call can by run synchronously\n via `execute()` or asynchronously via `enqueue()` and can be canceled with `cancel()`.\n * New: `Response` is now parameterized and includes the deserialized body object.\n * New: `@Url` parameter annotation allows passing a complete URL for an endpoint.\n * New: OkHttp is now required as a dependency. Types like `TypedInput` and `TypedOutput` (and its\n implementations), `Request`, and `Header` have been replaced with OkHttp types like `RequestBody`,\n `ResponseBody`, and `Headers`.\n * New: `CallAdapter` (and `Factory`) provides extension point for supporting multiple execution\n mechanisms. An RxJava implementation is provided by a sibling module.\n * New: `Converter` (and `Factory`) provides extension point for supporting multiple serialization\n mechanisms. Gson, Jackson, Moshi, Protobuf, Wire, and SimpleXml implementations are provided by sibling\n modules.\n * Fix: A lot of things.\n * Hello Droidcon NYC 2015!\n\n\n## [1.9.0] - 2015-01-07\n\n * Update to OkHttp 2.x's native API. If you are using OkHttp you must use version 2.0 or newer (the latest\n is 2.2 at time of writing) and you no longer need to use the `okhttp-urlconnection` shim.\n * New: Allow disabling Simple XML Framework's strict parsing.\n * New: `@Header` now accepts a `List` or array for a type.\n * New: `@Field` and `@FieldMap` now have options for enabling or disabling URL encoding of names and values.\n * Fix: Remove query parameters from thread name when running background requests for asynchronous use.\n\n\n## [1.8.0] - 2014-11-18\n\n * Update to RxJava 1.0. This comes with the project's 'groupId' change from `com.netflix.rxjava` to\n `io.reactivex` which is why the minor version was bumped.\n\n\n## [1.7.1] - 2014-10-23\n\n * Fix: Correctly log `null` request arguments for `HEADERS_AND_ARGS` log level.\n\n\n## [1.7.0] - 2014-10-08\n\n * New: `RetrofitError`'s `getKind()` now disambiguates the type of error represented.\n * New: `HEADERS_AND_ARGS` log level displays parameters passed to method invocation along with normal\n header list.\n * New: `@Part` and `@PartMap` now support specifying the `Content-Transfer-Encoding` of their respective\n values.\n * New: `@Path`, `@Query`, and `@QueryMap` now have options for enabling or disabling URL encoding on\n names (where appropriate) and values.\n * `@Header` now accepts all object types, invoking `String.valueOf` when neccesary.\n * Attempting to use a `@Path` replacement block (`{name}`) in a query parameter now suggested `@Query` in\n the exception message.\n * Fix: Correct NPE when `Content-Type` override is specified on requests without a body.\n * Fix: `WireConverter` now correctly throws `ConversionException` on incorrect MIME types for parity with\n `ProtoConverter`.\n * Fix: Include `Content-Type` on AppEngine requests.\n * Fix: Account for NPE on AppEngine when the response URL was not automatically populated in certain cases.\n * Fix: `MockRestAdapter`'s RxJava support now correctly schedules work on the HTTP executor, specifically\n when chaining multiple requests together.\n * Experimental RxJava support updated for v0.20.\n\n\n## [1.6.1] - 2014-07-02\n\n * Fix: Add any explicitly-specified 'Content-Type' header (via annotation or param) to the request even\n if there is no request body (e.g., DELETE).\n * Fix: Include trailing CRLF in multi-part uploads to work around a bug in .NET MVC 4 parsing.\n * Fix: Allow `null` mock exception bodies and use the success type from the declared service interface.\n\n\n## [1.6.0] - 2014-06-06\n\n * New: `@Streaming` on a `Response` type will skip buffering the body to a `byte[]` before delivering.\n * When using OkHttp, version 1.6.0 or newer (including 2.0.0+) is now required.\n * The absence of a response body and an empty body are now differentiated in the log messages.\n * Fix: If set, the `RequestInterceptor` is now applied at the time of `Observable` subscription rather\n than at the time of its creation.\n * Fix: `Callback` subtypes are now supported when using `MockRestAdapter`.\n * Fix: `RetrofitError` now contains a useful message indicating the reason for the failure.\n * Fix: Exceptions thrown when parsing the response type of the interface are now properly propagated.\n * Fix: Calling `Response#getBody` when `null` body now correctly returns instead of throwing an NPE.\n * Experimental RxJava support updated for v0.19.\n * The `Content-Type` and `Content-Length` headers are no longer automatically added to the header list\n on the `Request` object. This reverts erroneous behavior added in v1.5.0. Custom `Client` implementations\n should revert to adding these headers based on the `TypedInput` body of the `Request`.\n\n\n## [1.5.1] - 2014-05-08\n\n * New: `@PartMap` annotation accepts a `Map` of key/value pairs for multi-part.\n * Fix: `MockRestAdpater` uses the `ErrorHandler` from its parent `RestAdapter`.\n * Experimental RxJava support updated for v0.18 and is now lazily initialized.\n\n\n## [1.5.0] - 2014-03-20\n\n * New: Support for AppEngine's [URL Fetch](https://developers.google.com/appengine/docs/java/urlfetch/)\n HTTP client.\n * New: Multipart requests of unknown length are now supported.\n * New: HTTP `Content-Type` can be overridden with a method-level or paramter header annotation.\n * New: Exceptions from malformed interface methods now include detailed information.\n * Fix: Support empty HTTP response status reason.\n * If an `ErrorHandler` is supplied it will be invoked for `Callback` and `Observable` methods.\n * HTTP `PATCH` method using `HttpUrlConnection` is no longer supported. Add the\n [OkHttp](https://square.github.io/okhttp) jar to your project if you need this behavior.\n * Custom `Client` implementations should no longer set `Content-Type` or `Content-Length` headers\n based on the `TypedInput` body of the `Request`. These headers will now be added automatically\n as part of the standard `Request` header list.\n\n\n## [1.4.1] - 2014-02-01\n\n * Fix: `@QueryMap`, `@EncodedFieldMap`, and `@FieldMap` now correctly detect `Map`-based parameter\n types.\n\n\n## [1.4.0] - 2014-01-31\n\n * New: `@Query` and `@EncodedQuery` now accept `List` or arrays for multiple values.\n * New: `@QueryMap` and `@EncodedQueryMap` accept a `Map` of key/value pairs for query parameters.\n * New: `@Field` now accepts `List` or arrays for multiple values.\n * New: `@FieldMap` accepts a `Map` of name/value pairs for form URL-encoded request bodies.\n * New: `Endpoint` replaces `Server` as the representation of the remote API root. The `Endpoints`\n utility class contains factories methods for creating instances. `Server` and `ChangeableServer`\n are now deprecated.\n * `SimpleXmlConverter` and `JacksonConverter` now have a default constructor.\n * `Response` now includes the URL.\n * Fix: Hide references to optional classes to prevent over-eager class verifiers from\n complaining (e.g., Dalvik).\n * Fix: Properly detect and reject interfaces which extend from other interfaces.\n\n\n## [1.3.0] - 2013-11-25\n\n * New: Converter module for SimpleXML.\n * New: Mock module which allows simulating real network behavior for local service interface\n implementations. See 'mock-github-client' example for a demo.\n * New: RxJava `Observable` support! Declare a return type of `Observable` on your service\n interfaces to automatically get an observable for that request. (Experimental API)\n * Fix: Use `ObjectMapper`'s type factory when deserializing (Jackson converter).\n * Multipart POST requests now stream their individual part bodies.\n * Log chunking to 4000 characters now only happens on the Android platform.\n\n\n## [1.2.2] - 2013-09-12\n\n * Fix: Respect connection and read timeouts on supplied `OkHttpClient` instances.\n * Fix: Ensure connection is closed on non-200 responses.\n\n\n## [1.2.1] - 2013-08-30\n\n * New: Converter for [Wire protocol buffers](https://github.com/square/wire)!\n\n\n## [1.2.0] - 2013-08-23\n\n * New: Additional first-party converters for Jackson and Protocol Buffers! These are provided\n as separate modules that you can include and pass to `RestAdapter.Builder`'s `setConverter`.\n * New: `@EncodedPath` and `@EncodedQuery` annotations allow provided path and query params that\n are already URL-encoded.\n * New: `@PATCH` HTTP method annotation.\n * Fix: Properly support custom HTTP method annotations in `UrlConnectionClient`.\n * Fix: Apply `RequestInterceptor` during method invocation rather than at request execution time.\n * Change `setDebug` to `setLogLevel` on `RestAdapter` and `RestAdapter.Builder` and provide\n two levels of logging via `LogLevel`.\n * Query parameters can now be added in a request interceptor.\n\n\n## [1.1.1] - 2013-06-25\n\n * Fix: Ensure `@Headers`-defined headers are correctly added to requests.\n * Fix: Supply reasonable connection and read timeouts for default clients.\n * Fix: Allow passing `null` for a `@Part`-annotated argument to remove it from the multipart\n request body.\n\n\n## [1.1.0] - 2013-06-20\n\n * Introduce `RequestInterceptor` to replace `RequestHeaders`. An interceptor provided to the\n `RestAdapter.Builder` will be called for every request and allow setting both headers and\n additional path parameter replacements.\n * Add `ErrorHandler` for customizing the exceptions which are thrown when synchronous methods\n return non-200 error codes.\n * Properly parse responses which erroneously omit the \"Content-Type\" header.\n\n\n## [1.0.2] - 2013-05-23\n\n * Allow uppercase letters in path replacement identifiers.\n * Fix: Static query parameters in the URL are now correctly appended with a separating '?'.\n * Fix: Explicitly allow or forbid `null` as a value for method parameters.\n * `@Path` - Forbidden\n * `@Query` - Allowed\n * `@Field` - Allowed\n * `@Part` - Forbidden\n * `@Body` - Forbidden\n * `@Header` - Allowed\n\n\n## [1.0.1] - 2013-05-13\n\n * Fix: Correct bad regex behavior on Android.\n\n\n## [1.0.0] - 2013-05-13\n\nInitial release.\n\n\n\n[2.11.0]: https://github.com/square/retrofit/releases/tag/2.11.0\n[2.10.0]: https://github.com/square/retrofit/releases/tag/2.10.0\n[2.9.0]: https://github.com/square/retrofit/releases/tag/2.9.0\n[2.8.2]: https://github.com/square/retrofit/releases/tag/2.8.2\n[2.8.1]: https://github.com/square/retrofit/releases/tag/parent-2.8.1\n[2.8.0]: https://github.com/square/retrofit/releases/tag/parent-2.8.0\n[2.7.2]: https://github.com/square/retrofit/releases/tag/parent-2.7.2\n[2.7.1]: https://github.com/square/retrofit/releases/tag/parent-2.7.1\n[2.7.0]: https://github.com/square/retrofit/releases/tag/parent-2.7.0\n[2.6.4]: https://github.com/square/retrofit/releases/tag/parent-2.6.4\n[2.6.3]: https://github.com/square/retrofit/releases/tag/parent-2.6.3\n[2.6.2]: https://github.com/square/retrofit/releases/tag/parent-2.6.2\n[2.6.1]: https://github.com/square/retrofit/releases/tag/parent-2.6.1\n[2.6.0]: https://github.com/square/retrofit/releases/tag/parent-2.6.0\n[2.5.0]: https://github.com/square/retrofit/releases/tag/parent-2.5.0\n[2.4.0]: https://github.com/square/retrofit/releases/tag/parent-2.4.0\n[2.3.0]: https://github.com/square/retrofit/releases/tag/parent-2.3.0\n[2.2.0]: https://github.com/square/retrofit/releases/tag/parent-2.2.0\n[2.1.0]: https://github.com/square/retrofit/releases/tag/parent-2.1.0\n[2.0.2]: https://github.com/square/retrofit/releases/tag/parent-2.0.2\n[2.0.1]: https://github.com/square/retrofit/releases/tag/parent-2.0.1\n[2.0.0]: https://github.com/square/retrofit/releases/tag/parent-2.0.0\n[2.0.0-beta4]: https://github.com/square/retrofit/releases/tag/parent-2.0.0-beta4\n[2.0.0-beta3]: https://github.com/square/retrofit/releases/tag/parent-2.0.0-beta3\n[2.0.0-beta2]: https://github.com/square/retrofit/releases/tag/parent-2.0.0-beta2\n[2.0.0-beta1]: https://github.com/square/retrofit/releases/tag/parent-2.0.0-beta1\n[1.9.0]: https://github.com/square/retrofit/releases/tag/parent-1.9.0\n[1.8.0]: https://github.com/square/retrofit/releases/tag/parent-1.8.0\n[1.7.1]: https://github.com/square/retrofit/releases/tag/parent-1.7.1\n[1.7.0]: https://github.com/square/retrofit/releases/tag/parent-1.7.0\n[1.6.1]: https://github.com/square/retrofit/releases/tag/parent-1.6.1\n[1.6.0]: https://github.com/square/retrofit/releases/tag/parent-1.6.0\n[1.5.1]: https://github.com/square/retrofit/releases/tag/parent-1.5.1\n[1.5.0]: https://github.com/square/retrofit/releases/tag/parent-1.5.0\n[1.4.1]: https://github.com/square/retrofit/releases/tag/parent-1.4.1\n[1.4.0]: https://github.com/square/retrofit/releases/tag/parent-1.4.0\n[1.3.0]: https://github.com/square/retrofit/releases/tag/parent-1.3.0\n[1.2.2]: https://github.com/square/retrofit/releases/tag/parent-1.2.2\n[1.2.1]: https://github.com/square/retrofit/releases/tag/parent-1.2.1\n[1.2.0]: https://github.com/square/retrofit/releases/tag/parent-1.2.0\n[1.1.1]: https://github.com/square/retrofit/releases/tag/parent-1.1.1\n[1.1.0]: https://github.com/square/retrofit/releases/tag/parent-1.1.0\n[1.0.2]: https://github.com/square/retrofit/releases/tag/parent-1.0.2\n[1.0.1]: https://github.com/square/retrofit/releases/tag/parent-1.0.1\n[1.0.0]: https://github.com/square/retrofit/releases/tag/parent-1.0.0\n[maven_provided]: https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html\n" }, { "path": "LICENSE.txt", "content": "\n Apache License\n Version 2.0, January 2004\n http://www.apache.org/licenses/\n\n TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n 1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n 2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n 3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n 4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n 5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n 6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n 7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n 8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n 9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\n END OF TERMS AND CONDITIONS\n\n APPENDIX: How to apply the Apache License to your work.\n\n To apply the Apache License to your work, attach the following\n boilerplate notice, with the fields enclosed by brackets \"[]\"\n replaced with your own identifying information. (Don't include\n the brackets!) The text should be enclosed in the appropriate\n comment syntax for the file format. We also recommend that a\n file or class name and description of purpose be included on the\n same \"printed page\" as the copyright notice for easier\n identification within third-party archives.\n\n Copyright [yyyy] [name of copyright owner]\n\n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License.\n" }, { "path": "README.md", "content": "Retrofit\n========\n\nA type-safe HTTP client for Android and Java.\n\nFor more information please see [the website][1].\n\n\nDownload\n--------\n\nDownload [the latest JAR][2] or grab from Maven central at the coordinates `com.squareup.retrofit2:retrofit:3.0.0`.\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\nRetrofit requires at minimum Java 8+ or Android API 21+.\n\n\nR8 / ProGuard\n-------------\n\nIf you are using R8 the shrinking and obfuscation rules are included automatically.\n\nProGuard users must manually add the options from\n[retrofit2.pro][proguard file].\nYou might also need [rules for OkHttp][okhttp proguard] which is a dependency of this library.\n\n\nLicense\n=======\n\n Copyright 2013 Square, Inc.\n\n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License.\n\n\n [1]: https://square.github.io/retrofit/\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=retrofit&v=LATEST\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n [proguard file]: https://github.com/square/retrofit/blob/master/retrofit/src/main/resources/META-INF/proguard/retrofit2.pro\n [okhttp proguard]: https://square.github.io/okhttp/r8_proguard/\n [okio proguard]: https://square.github.io/okio/#r8-proguard\n" }, { "path": "RELEASING.md", "content": "# Releasing\n\n1. Update the `VERSION_NAME` in `gradle.properties` to the release version.\n\n2. Update the `CHANGELOG.md`:\n 1. Change the `Unreleased` header to the release version.\n 2. Add a link URL to ensure the header link works.\n 3. Add a new `Unreleased` section to the top.\n\n3. Update the `README.md` so the \"Download\" section reflects the new release version.\n\n4. Commit\n\n ```\n $ git commit -am \"Prepare version X.Y.Z\"\n ```\n\n5. Tag\n\n ```\n $ git tag -am \"Version X.Y.Z\" X.Y.Z\n ```\n\n6. Update the `VERSION_NAME` in `gradle.properties` to the next \"SNAPSHOT\" version.\n\n7. Commit\n\n ```\n $ git commit -am \"Prepare next development version\"\n ```\n\n8. Push!\n\n ```\n $ git push && git push --tags\n ```\n\n This will trigger a GitHub Action workflow which will create a GitHub release and upload the\n release artifacts to Maven Central.\n" }, { "path": "build.gradle", "content": "import net.ltgt.gradle.errorprone.CheckSeverity\n\nbuildscript {\n dependencies {\n classpath libs.androidPlugin\n classpath libs.kotlin.gradlePlugin\n classpath libs.kotlin.serializationPlugin\n classpath libs.dokkaPlugin\n classpath libs.gradleMavenPublishPlugin\n classpath libs.spotlessPlugin\n classpath libs.errorpronePlugin\n classpath libs.animalSnifferPlugin\n classpath libs.protobufPlugin\n }\n repositories {\n mavenCentral()\n google()\n gradlePluginPortal()\n }\n}\n\nsubprojects {\n tasks.withType(JavaCompile).configureEach { task ->\n task.options.encoding = 'UTF-8'\n }\n\n plugins.withType(JavaBasePlugin).configureEach {\n java.toolchain {\n languageVersion.set(JavaLanguageVersion.of(8))\n }\n }\n\n tasks.withType(Test).configureEach {\n testLogging {\n if (System.getenv(\"CI\") == \"true\") {\n events = [\"failed\", \"skipped\", \"passed\"]\n }\n exceptionFormat \"full\"\n }\n }\n\n apply plugin: 'net.ltgt.errorprone'\n\n dependencies {\n errorproneJavac libs.errorproneJavac\n errorprone libs.errorproneCore\n }\n\n tasks.withType(JavaCompile).configureEach { task ->\n task.options.errorprone {\n excludedPaths = '.*/build/generated/sources/proto/.*'\n check('MissingFail', CheckSeverity.ERROR)\n check('MissingOverride', CheckSeverity.ERROR)\n check('UnusedException', CheckSeverity.ERROR)\n check('UnusedMethod', CheckSeverity.ERROR)\n check('UnusedNestedClass', CheckSeverity.ERROR)\n check('UnusedVariable', CheckSeverity.ERROR)\n check('WildcardImport', CheckSeverity.ERROR)\n }\n }\n\n plugins.withId('java-library') {\n project.apply plugin: 'ru.vyarus.animalsniffer'\n animalsniffer {\n sourceSets = [sourceSets.main] // Only check main sources, ignore test code.\n }\n dependencies {\n signature 'org.codehaus.mojo.signature:java18:1.0@signature'\n\n if (project.path != ':retrofit-converters:java8' &&\n project.path != ':retrofit-converters:jaxb' &&\n project.path != ':retrofit-converters:jaxb3' &&\n project.path != ':retrofit-adapters:java8') {\n signature 'net.sf.androidscents.signature:android-api-level-21:5.0.1_r2@signature'\n }\n }\n\n plugins.apply('com.diffplug.spotless')\n spotless {\n java {\n googleJavaFormat(libs.googleJavaFormat.get().version)\n .formatJavadoc(false)\n removeUnusedImports()\n target 'src/*/java*/**/*.java'\n }\n kotlin {\n ktfmt(libs.ktfmt.get().version).googleStyle()\n target 'src/**/*.kt'\n }\n }\n }\n}\n\ntasks.register('clean', Delete) {\n delete = layout.buildDirectory\n}\n\ntasks.register('copyWebsiteDocs', Copy) {\n description = 'Copies generated documentation to the website'\n group = JavaBasePlugin.DOCUMENTATION_GROUP\n\n into layout.projectDirectory.dir('website/public/3.x')\n\n subprojects { subproject ->\n if (subproject.name == 'retrofit-bom') return\n if (!subproject.plugins.hasPlugin('com.vanniktech.maven.publish')) return\n\n into(subproject.POM_ARTIFACT_ID) {\n if (subproject.plugins.hasPlugin('org.jetbrains.dokka')) {\n from subproject.tasks.named('dokkaGeneratePublicationHtml').flatMap { it.outputDirectory }\n } else {\n from subproject.tasks.named('javadoc').map { it.destinationDir }\n }\n }\n }\n}\n" }, { "path": "gradle/libs.versions.toml", "content": "# Copyright (C) 2021 Square, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# https://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n[versions]\nkotlin = \"2.3.10\"\nokhttp = \"5.3.2\"\nprotobuf = \"3.25.8\"\nrobovm = \"2.3.14\"\nkotlinx-serialization = \"1.10.0\"\nautoService = \"1.1.1\"\nincap = \"1.0.0\"\njackson = \"2.21.1\"\n\n[libraries]\nandroidPlugin = \"com.android.tools.build:gradle:9.1.0\"\nrobovmPlugin = { module = \"com.mobidevelop.robovm:robovm-gradle-plugin\", version.ref = \"robovm\" }\ndokkaPlugin = \"org.jetbrains.dokka:dokka-gradle-plugin:2.1.0\"\ngradleMavenPublishPlugin = \"com.vanniktech:gradle-maven-publish-plugin:0.36.0\"\nspotlessPlugin = \"com.diffplug.spotless:spotless-plugin-gradle:8.3.0\"\n\nkotlin-stdLib = { module = \"org.jetbrains.kotlin:kotlin-stdlib\", version.ref = \"kotlin\" }\nkotlin-gradlePlugin = { module = \"org.jetbrains.kotlin:kotlin-gradle-plugin\", version.ref = \"kotlin\" }\nkotlin-serializationPlugin = { module = \"org.jetbrains.kotlin:kotlin-serialization\", version.ref = \"kotlin\" }\n\nerrorpronePlugin = \"net.ltgt.gradle:gradle-errorprone-plugin:4.4.0\"\nerrorproneCore = { module = \"com.google.errorprone:error_prone_core\", version = \"2.10.0\" }\nerrorproneJavac = { module = \"com.google.errorprone:javac\", version = \"9+181-r4173-1\" }\n\nanimalSnifferPlugin = \"ru.vyarus:gradle-animalsniffer-plugin:2.0.1\"\nanimalSnifferAnnotations = { module = \"org.codehaus.mojo:animal-sniffer-annotations\", version = \"1.27\" }\n\nprotobufPlugin = \"com.google.protobuf:protobuf-gradle-plugin:0.9.6\"\nprotobuf = { module = \"com.google.protobuf:protobuf-java\", version.ref = \"protobuf\" }\nprotoc = { module = \"com.google.protobuf:protoc\", version.ref = \"protobuf\" }\n\nkotlinx-coroutines = { module = \"org.jetbrains.kotlinx:kotlinx-coroutines-core\", version = \"1.10.2\" }\nkotlinx-serialization-core = { module = \"org.jetbrains.kotlinx:kotlinx-serialization-core\", version.ref = \"kotlinx-serialization\" }\nkotlinx-serialization-json = { module = \"org.jetbrains.kotlinx:kotlinx-serialization-json\", version.ref = \"kotlinx-serialization\" }\nkotlinx-serialization-proto = { module = \"org.jetbrains.kotlinx:kotlinx-serialization-protobuf\", version.ref = \"kotlinx-serialization\" }\nokhttp-client = { module = \"com.squareup.okhttp3:okhttp\", version.ref = \"okhttp\" }\nokhttp-loggingInterceptor = { module = \"com.squareup.okhttp3:logging-interceptor\", version.ref = \"okhttp\" }\nokhttp-mockwebserver = { module = \"com.squareup.okhttp3:mockwebserver\", version.ref = \"okhttp\" }\njunit = { module = \"junit:junit\", version = \"4.13.2\" }\ntruth = \"com.google.truth:truth:1.4.5\"\nguava = { module = \"com.google.guava:guava\", version = \"33.5.0-jre\" }\nandroid = { module = \"com.google.android:android\", version = \"4.1.1.4\" }\nfindBugsAnnotations = { module = \"com.google.code.findbugs:jsr305\", version = \"3.0.2\" }\nandroidxTestRunner = { module = \"androidx.test:runner\", version = \"1.4.0\" }\nrxjava = { module = \"io.reactivex:rxjava\", version = \"1.3.8\" }\nrxjava2 = { module = \"io.reactivex.rxjava2:rxjava\", version = \"2.2.21\" }\nrxjava3 = { module = \"io.reactivex.rxjava3:rxjava\", version = \"3.1.12\" }\nreactiveStreams = { module = \"org.reactivestreams:reactive-streams\", version = \"1.0.4\" }\nscalaLibrary = { module = \"org.scala-lang:scala-library\", version = \"2.13.18\" }\ngson = { module = \"com.google.code.gson:gson\", version = \"2.13.2\" }\njacksonDatabind = { module = \"com.fasterxml.jackson.core:jackson-databind\", version.ref = \"jackson\" }\njacksonDataformatCbor = { module = \"com.fasterxml.jackson.dataformat:jackson-dataformat-cbor\", version.ref = \"jackson\" }\njaxbApi = { module = \"javax.xml.bind:jaxb-api\", version = \"2.3.1\" }\njaxbImpl = { module = \"org.glassfish.jaxb:jaxb-runtime\", version = \"4.0.7\" }\njaxb3Api = { module = \"jakarta.xml.bind:jakarta.xml.bind-api\", version = \"3.0.1\" }\njaxb3Impl = { module = \"com.sun.xml.bind:jaxb-impl\", version = \"3.0.2\" }\nmoshi = { module = \"com.squareup.moshi:moshi\", version = \"1.15.2\" }\nsimpleXml = { module = \"org.simpleframework:simple-xml\", version = \"2.7.1\" }\nwireRuntime = { module = \"com.squareup.wire:wire-runtime\", version = \"5.5.1\" }\njsoup = { module = \"org.jsoup:jsoup\", version = \"1.22.1\" }\nrobovm = { module = \"com.mobidevelop.robovm:robovm-rt\", version.ref = \"robovm\" }\ngoogleJavaFormat = \"com.google.googlejavaformat:google-java-format:1.35.0\"\nktfmt = \"com.facebook:ktfmt:0.61\"\ncompileTesting = \"com.google.testing.compile:compile-testing:0.23.0\"\ntestParameterInjector = \"com.google.testparameterinjector:test-parameter-injector:1.21\"\n" }, { "path": "gradle/wrapper/gradle-wrapper.properties", "content": "distributionBase=GRADLE_USER_HOME\ndistributionPath=wrapper/dists\ndistributionUrl=https\\://services.gradle.org/distributions/gradle-9.4.0-bin.zip\nnetworkTimeout=10000\nvalidateDistributionUrl=true\nzipStoreBase=GRADLE_USER_HOME\nzipStorePath=wrapper/dists\n" }, { "path": "gradle.properties", "content": "GROUP=com.squareup.retrofit2\nVERSION_NAME=3.1.0-SNAPSHOT\n\nPOM_URL=https://github.com/square/retrofit\nPOM_SCM_URL=https://github.com/square/retrofit/\nPOM_SCM_CONNECTION=scm:git:git://github.com/square/retrofit.git\nPOM_SCM_DEV_CONNECTION=scm:git:ssh://git@github.com/square/retrofit.git\n\nPOM_LICENCE_NAME=The Apache Software License, Version 2.0\nPOM_LICENCE_URL=https://www.apache.org/licenses/LICENSE-2.0.txt\nPOM_LICENCE_DIST=repo\n\nPOM_DEVELOPER_ID=square\nPOM_DEVELOPER_NAME=Square, Inc.\n\n# Publishing SHA 256 and 512 hashes of maven-metadata is not supported by Sonatype and Nexus.\n# See https://github.com/gradle/gradle/issues/11308 and https://issues.sonatype.org/browse/NEXUS-21802\nsystemProp.org.gradle.internal.publish.checksums.insecure=true\n\nandroid.useAndroidX=true\n\nmavenCentralPublishing=true\nmavenCentralAutomaticPublishing=true\nsignAllPublications=true\n" }, { "path": "gradlew", "content": "#!/bin/sh\n\n#\n# Copyright © 2015-2021 the original authors.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# https://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n#\n# SPDX-License-Identifier: Apache-2.0\n#\n\n##############################################################################\n#\n# Gradle start up script for POSIX generated by Gradle.\n#\n# Important for running:\n#\n# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is\n# noncompliant, but you have some other compliant shell such as ksh or\n# bash, then to run this script, type that shell name before the whole\n# command line, like:\n#\n# ksh Gradle\n#\n# Busybox and similar reduced shells will NOT work, because this script\n# requires all of these POSIX shell features:\n# * functions;\n# * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,\n# «${var#prefix}», «${var%suffix}», and «$( cmd )»;\n# * compound commands having a testable exit status, especially «case»;\n# * various built-in commands including «command», «set», and «ulimit».\n#\n# Important for patching:\n#\n# (2) This script targets any POSIX shell, so it avoids extensions provided\n# by Bash, Ksh, etc; in particular arrays are avoided.\n#\n# The \"traditional\" practice of packing multiple parameters into a\n# space-separated string is a well documented source of bugs and security\n# problems, so this is (mostly) avoided, by progressively accumulating\n# options in \"$@\", and eventually passing that to Java.\n#\n# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,\n# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;\n# see the in-line comments for details.\n#\n# There are tweaks for specific operating systems such as AIX, CygWin,\n# Darwin, MinGW, and NonStop.\n#\n# (3) This script is generated from the Groovy template\n# https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt\n# within the Gradle project.\n#\n# You can find Gradle at https://github.com/gradle/gradle/.\n#\n##############################################################################\n\n# Attempt to set APP_HOME\n\n# Resolve links: $0 may be a link\napp_path=$0\n\n# Need this for daisy-chained symlinks.\nwhile\n APP_HOME=${app_path%\"${app_path##*/}\"} # leaves a trailing /; empty if no leading path\n [ -h \"$app_path\" ]\ndo\n ls=$( ls -ld \"$app_path\" )\n link=${ls#*' -> '}\n case $link in #(\n /*) app_path=$link ;; #(\n *) app_path=$APP_HOME$link ;;\n esac\ndone\n\n# This is normally unused\n# shellcheck disable=SC2034\nAPP_BASE_NAME=${0##*/}\n# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)\nAPP_HOME=$( cd -P \"${APP_HOME:-./}\" > /dev/null && printf '%s\n' \"$PWD\" ) || exit\n\n# Use the maximum available, or set MAX_FD != -1 to use that value.\nMAX_FD=maximum\n\nwarn () {\n echo \"$*\"\n} >&2\n\ndie () {\n echo\n echo \"$*\"\n echo\n exit 1\n} >&2\n\n# OS specific support (must be 'true' or 'false').\ncygwin=false\nmsys=false\ndarwin=false\nnonstop=false\ncase \"$( uname )\" in #(\n CYGWIN* ) cygwin=true ;; #(\n Darwin* ) darwin=true ;; #(\n MSYS* | MINGW* ) msys=true ;; #(\n NONSTOP* ) nonstop=true ;;\nesac\n\nCLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar\n\n\n# Determine the Java command to use to start the JVM.\nif [ -n \"$JAVA_HOME\" ] ; then\n if [ -x \"$JAVA_HOME/jre/sh/java\" ] ; then\n # IBM's JDK on AIX uses strange locations for the executables\n JAVACMD=$JAVA_HOME/jre/sh/java\n else\n JAVACMD=$JAVA_HOME/bin/java\n fi\n if [ ! -x \"$JAVACMD\" ] ; then\n die \"ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME\n\nPlease set the JAVA_HOME variable in your environment to match the\nlocation of your Java installation.\"\n fi\nelse\n JAVACMD=java\n if ! command -v java >/dev/null 2>&1\n then\n die \"ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.\n\nPlease set the JAVA_HOME variable in your environment to match the\nlocation of your Java installation.\"\n fi\nfi\n\n# Increase the maximum file descriptors if we can.\nif ! \"$cygwin\" && ! \"$darwin\" && ! \"$nonstop\" ; then\n case $MAX_FD in #(\n max*)\n # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.\n # shellcheck disable=SC2039,SC3045\n MAX_FD=$( ulimit -H -n ) ||\n warn \"Could not query maximum file descriptor limit\"\n esac\n case $MAX_FD in #(\n '' | soft) :;; #(\n *)\n # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.\n # shellcheck disable=SC2039,SC3045\n ulimit -n \"$MAX_FD\" ||\n warn \"Could not set maximum file descriptor limit to $MAX_FD\"\n esac\nfi\n\n# Collect all arguments for the java command, stacking in reverse order:\n# * args from the command line\n# * the main class name\n# * -classpath\n# * -D...appname settings\n# * --module-path (only if needed)\n# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.\n\n# For Cygwin or MSYS, switch paths to Windows format before running java\nif \"$cygwin\" || \"$msys\" ; then\n APP_HOME=$( cygpath --path --mixed \"$APP_HOME\" )\n CLASSPATH=$( cygpath --path --mixed \"$CLASSPATH\" )\n\n JAVACMD=$( cygpath --unix \"$JAVACMD\" )\n\n # Now convert the arguments - kludge to limit ourselves to /bin/sh\n for arg do\n if\n case $arg in #(\n -*) false ;; # don't mess with options #(\n /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath\n [ -e \"$t\" ] ;; #(\n *) false ;;\n esac\n then\n arg=$( cygpath --path --ignore --mixed \"$arg\" )\n fi\n # Roll the args list around exactly as many times as the number of\n # args, so each arg winds up back in the position where it started, but\n # possibly modified.\n #\n # NB: a `for` loop captures its iteration list before it begins, so\n # changing the positional parameters here affects neither the number of\n # iterations, nor the values presented in `arg`.\n shift # remove old arg\n set -- \"$@\" \"$arg\" # push replacement arg\n done\nfi\n\n\n# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.\nDEFAULT_JVM_OPTS='\"-Xmx64m\" \"-Xms64m\"'\n\n# Collect all arguments for the java command:\n# * DEFAULT_JVM_OPTS, JAVA_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,\n# and any embedded shellness will be escaped.\n# * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be\n# treated as '${Hostname}' itself on the command line.\n\nset -- \\\n \"-Dorg.gradle.appname=$APP_BASE_NAME\" \\\n -classpath \"$CLASSPATH\" \\\n org.gradle.wrapper.GradleWrapperMain \\\n \"$@\"\n\n# Stop when \"xargs\" is not available.\nif ! command -v xargs >/dev/null 2>&1\nthen\n die \"xargs is not available\"\nfi\n\n# Use \"xargs\" to parse quoted args.\n#\n# With -n1 it outputs one arg per line, with the quotes and backslashes removed.\n#\n# In Bash we could simply go:\n#\n# readarray ARGS < <( xargs -n1 <<<\"$var\" ) &&\n# set -- \"${ARGS[@]}\" \"$@\"\n#\n# but POSIX shell has neither arrays nor command substitution, so instead we\n# post-process each arg (as a line of input to sed) to backslash-escape any\n# character that might be a shell metacharacter, then use eval to reverse\n# that process (while maintaining the separation between arguments), and wrap\n# the whole thing up as a single \"set\" statement.\n#\n# This will of course break if any of these variables contains a newline or\n# an unmatched quote.\n#\n\neval \"set -- $(\n printf '%s\\n' \"$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS\" |\n xargs -n1 |\n sed ' s~[^-[:alnum:]+,./:=@_]~\\\\&~g; ' |\n tr '\\n' ' '\n )\" '\"$@\"'\n\nexec \"$JAVACMD\" \"$@\"\n" }, { "path": "gradlew.bat", "content": "@rem\r\n@rem Copyright 2015 the original author or authors.\r\n@rem\r\n@rem Licensed under the Apache License, Version 2.0 (the \"License\");\r\n@rem you may not use this file except in compliance with the License.\r\n@rem You may obtain a copy of the License at\r\n@rem\r\n@rem https://www.apache.org/licenses/LICENSE-2.0\r\n@rem\r\n@rem Unless required by applicable law or agreed to in writing, software\r\n@rem distributed under the License is distributed on an \"AS IS\" BASIS,\r\n@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r\n@rem See the License for the specific language governing permissions and\r\n@rem limitations under the License.\r\n@rem\r\n@rem SPDX-License-Identifier: Apache-2.0\r\n@rem\r\n\r\n@if \"%DEBUG%\"==\"\" @echo off\r\n@rem ##########################################################################\r\n@rem\r\n@rem Gradle startup script for Windows\r\n@rem\r\n@rem ##########################################################################\r\n\r\n@rem Set local scope for the variables with windows NT shell\r\nif \"%OS%\"==\"Windows_NT\" setlocal\r\n\r\nset DIRNAME=%~dp0\r\nif \"%DIRNAME%\"==\"\" set DIRNAME=.\r\n@rem This is normally unused\r\nset APP_BASE_NAME=%~n0\r\nset APP_HOME=%DIRNAME%\r\n\r\n@rem Resolve any \".\" and \"..\" in APP_HOME to make it shorter.\r\nfor %%i in (\"%APP_HOME%\") do set APP_HOME=%%~fi\r\n\r\n@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.\r\nset DEFAULT_JVM_OPTS=\"-Xmx64m\" \"-Xms64m\"\r\n\r\n@rem Find java.exe\r\nif defined JAVA_HOME goto findJavaFromJavaHome\r\n\r\nset JAVA_EXE=java.exe\r\n%JAVA_EXE% -version >NUL 2>&1\r\nif %ERRORLEVEL% equ 0 goto execute\r\n\r\necho. 1>&2\r\necho ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2\r\necho. 1>&2\r\necho Please set the JAVA_HOME variable in your environment to match the 1>&2\r\necho location of your Java installation. 1>&2\r\n\r\ngoto fail\r\n\r\n:findJavaFromJavaHome\r\nset JAVA_HOME=%JAVA_HOME:\"=%\r\nset JAVA_EXE=%JAVA_HOME%/bin/java.exe\r\n\r\nif exist \"%JAVA_EXE%\" goto execute\r\n\r\necho. 1>&2\r\necho ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2\r\necho. 1>&2\r\necho Please set the JAVA_HOME variable in your environment to match the 1>&2\r\necho location of your Java installation. 1>&2\r\n\r\ngoto fail\r\n\r\n:execute\r\n@rem Setup the command line\r\n\r\nset CLASSPATH=%APP_HOME%\\gradle\\wrapper\\gradle-wrapper.jar\r\n\r\n\r\n@rem Execute Gradle\r\n\"%JAVA_EXE%\" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% \"-Dorg.gradle.appname=%APP_BASE_NAME%\" -classpath \"%CLASSPATH%\" org.gradle.wrapper.GradleWrapperMain %*\r\n\r\n:end\r\n@rem End local scope for the variables with windows NT shell\r\nif %ERRORLEVEL% equ 0 goto mainEnd\r\n\r\n:fail\r\nrem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of\r\nrem the _cmd.exe /c_ return code!\r\nset EXIT_CODE=%ERRORLEVEL%\r\nif %EXIT_CODE% equ 0 set EXIT_CODE=1\r\nif not \"\"==\"%GRADLE_EXIT_CONSOLE%\" exit %EXIT_CODE%\r\nexit /b %EXIT_CODE%\r\n\r\n:mainEnd\r\nif \"%OS%\"==\"Windows_NT\" endlocal\r\n\r\n:omega\r\n" }, { "path": "retrofit/android-test/build.gradle", "content": "apply plugin: 'com.android.library'\n\nandroid {\n compileSdk = 36\n namespace 'retrofit2.android'\n\n defaultConfig {\n minSdk = 21\n\n // We need to disable D8 desugaring of default methods for the default method tests to work\n // correctly. This works in Android Studio because it sets the minSdk automatically based on\n // your deployment target. This environment variable is set by the GitHub Action.\n def emulatorApiLevel = System.getenv(\"API_LEVEL\")\n if (emulatorApiLevel != null) {\n try {\n minSdk = Integer.parseInt(emulatorApiLevel)\n } catch (NumberFormatException ignored) {\n }\n }\n\n testInstrumentationRunner 'androidx.test.runner.AndroidJUnitRunner'\n }\n\n signingConfigs {\n debug {\n storeFile file('debug.keystore')\n storePassword 'retrofit'\n keyAlias 'retrofit'\n keyPassword 'retrofit'\n }\n }\n\n buildTypes {\n debug {\n signingConfig signingConfigs.debug\n }\n }\n}\n\ndependencies {\n androidTestImplementation projects.retrofit\n androidTestImplementation projects.retrofit.testHelpers\n androidTestImplementation libs.junit\n androidTestImplementation libs.truth\n androidTestImplementation libs.okhttp.mockwebserver\n androidTestImplementation libs.androidxTestRunner\n}\n" }, { "path": "retrofit/android-test/src/androidTest/java/retrofit2/BasicCallTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.io.IOException;\nimport okhttp3.ResponseBody;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.http.GET;\n\nimport static org.junit.Assert.assertEquals;\n\npublic final class BasicCallTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\") Call getBody();\n }\n\n @Test public void responseBody() throws IOException {\n Retrofit retrofit = new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(\"1234\"));\n\n Response response = example.getBody().execute();\n assertEquals(\"1234\", response.body().string());\n }\n}\n" }, { "path": "retrofit/android-test/src/androidTest/java/retrofit2/CompletableFutureAndroidTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport androidx.test.filters.SdkSuppress;\nimport java.util.concurrent.CompletableFuture;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.helpers.ToStringConverterFactory;\nimport retrofit2.http.GET;\n\nimport static com.google.common.truth.Truth.assertThat;\n\n@SdkSuppress(minSdkVersion = 24)\npublic final class CompletableFutureAndroidTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\")\n CompletableFuture endpoint();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void completableFutureApi24() throws Exception {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n CompletableFuture future = service.endpoint();\n assertThat(future.get()).isEqualTo(\"Hi\");\n }\n}\n" }, { "path": "retrofit/android-test/src/androidTest/java/retrofit2/DefaultMethodsAndroidTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport androidx.test.filters.SdkSuppress;\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.helpers.ToStringConverterFactory;\nimport retrofit2.http.GET;\nimport retrofit2.http.Query;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\npublic final class DefaultMethodsAndroidTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Example {\n @GET(\"/\")\n Call user(@Query(\"name\") String name);\n\n default Call user() {\n return user(\"hey\");\n }\n }\n\n @Test\n @SdkSuppress(minSdkVersion = 24, maxSdkVersion = 25)\n public void failsOnApi24And25() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Example example = retrofit.create(Example.class);\n\n try {\n example.user();\n fail();\n } catch (UnsupportedOperationException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Calling default methods on API 24 and 25 is not supported\");\n }\n }\n\n @Test\n @SdkSuppress(minSdkVersion = 26)\n public void doesNotFailOnApi26() throws IOException, InterruptedException {\n server.enqueue(new MockResponse());\n server.enqueue(new MockResponse());\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Example example = retrofit.create(Example.class);\n\n example.user().execute();\n assertThat(server.takeRequest().getRequestUrl().queryParameter(\"name\")).isEqualTo(\"hey\");\n\n example.user(\"hi\").execute();\n assertThat(server.takeRequest().getRequestUrl().queryParameter(\"name\")).isEqualTo(\"hi\");\n }\n}\n" }, { "path": "retrofit/android-test/src/androidTest/java/retrofit2/OptionalConverterFactoryAndroidTest.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport androidx.test.filters.SdkSuppress;\nimport java.io.IOException;\nimport java.util.Optional;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.helpers.ObjectInstanceConverterFactory;\nimport retrofit2.http.GET;\n\nimport static com.google.common.truth.Truth.assertThat;\n\n@SdkSuppress(minSdkVersion = 24)\npublic final class OptionalConverterFactoryAndroidTest {\n interface Service {\n @GET(\"/\")\n Call> optional();\n\n @GET(\"/\")\n Call object();\n }\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ObjectInstanceConverterFactory())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void optionalApi24() throws IOException {\n server.enqueue(new MockResponse());\n\n Optional optional = service.optional().execute().body();\n assertThat(optional.get()).isSameInstanceAs(ObjectInstanceConverterFactory.VALUE);\n }\n\n @Test\n public void onlyMatchesOptional() throws IOException {\n server.enqueue(new MockResponse());\n\n Object body = service.object().execute().body();\n assertThat(body).isSameInstanceAs(ObjectInstanceConverterFactory.VALUE);\n }\n}\n" }, { "path": "retrofit/android-test/src/androidTest/java/retrofit2/UriAndroidTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport android.net.Uri;\nimport java.io.IOException;\nimport okhttp3.HttpUrl;\nimport okhttp3.ResponseBody;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.http.GET;\nimport retrofit2.http.Url;\n\nimport static com.google.common.truth.Truth.assertThat;\n\npublic final class UriAndroidTest {\n @Rule public final MockWebServer server1 = new MockWebServer();\n @Rule public final MockWebServer server2 = new MockWebServer();\n\n interface Service {\n @GET\n Call method(@Url Uri url);\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server1.url(\"/\"))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void getWithAndroidUriUrl() throws IOException, InterruptedException {\n server1.enqueue(new MockResponse().setBody(\"Hi\"));\n\n service.method(Uri.parse(\"foo/bar/\")).execute();\n assertThat(server1.takeRequest().getRequestUrl()).isEqualTo(server1.url(\"foo/bar/\"));\n }\n\n @Test\n public void getWithAndroidUriUrlAbsolute() throws IOException, InterruptedException {\n server2.enqueue(new MockResponse().setBody(\"Hi\"));\n\n HttpUrl url = server2.url(\"/\");\n service.method(Uri.parse(url.toString())).execute();\n assertThat(server2.takeRequest().getRequestUrl()).isEqualTo(url);\n }\n}\n" }, { "path": "retrofit/android-test/src/main/AndroidManifest.xml", "content": "\n \n \n\n" }, { "path": "retrofit/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'org.jetbrains.kotlin.jvm'\napply plugin: 'com.vanniktech.maven.publish'\n\ndef addMultiReleaseSourceSet(int version) {\n def sourceSet = sourceSets.create(\"java$version\")\n sourceSet.java.srcDir(\"src/main/java$version\")\n\n // Propagate dependencies to be visible to this version's source set.\n configurations.getByName(\"java${version}Implementation\").extendsFrom(configurations.getByName('implementation'))\n configurations.getByName(\"java${version}Api\").extendsFrom(configurations.getByName('api'))\n configurations.getByName(\"java${version}CompileOnly\").extendsFrom(configurations.getByName('compileOnly'))\n\n // Allow types in the main source set to be visible to this version's source set.\n dependencies.add(\"java${version}Implementation\", sourceSets.getByName(\"main\").output)\n\n tasks.named(\"compileJava${version}Java\", JavaCompile) {\n javaCompiler = javaToolchains.compilerFor {\n languageVersion = JavaLanguageVersion.of(version)\n vendor = JvmVendorSpec.AZUL\n }\n }\n\n tasks.named('jar', Jar) {\n from(sourceSet.output) {\n into(\"META-INF/versions/$version\")\n }\n }\n}\n\naddMultiReleaseSourceSet(14)\naddMultiReleaseSourceSet(16)\n\ndependencies {\n api libs.okhttp.client\n\n compileOnly libs.android\n compileOnly libs.kotlinx.coroutines\n\n compileOnly libs.animalSnifferAnnotations\n compileOnly libs.findBugsAnnotations\n}\n\njavadoc {\n exclude('retrofit2/internal/**')\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2'\n attributes 'Multi-Release': 'true'\n }\n}\n" }, { "path": "retrofit/gradle.properties", "content": "POM_ARTIFACT_ID=retrofit\nPOM_NAME=Retrofit\nPOM_DESCRIPTION=A type-safe HTTP client for Android and Java.\n" }, { "path": "retrofit/java-test/README.md", "content": "# Retrofit Java Tests\n\nThese are in a separate module for two reasons:\n\n- It ensures optional dependencies (Kotlin stuff) are completely absent.\n- It uses the multi-release jar on the classpath rather than only the classes folder.\n" }, { "path": "retrofit/java-test/build.gradle", "content": "apply plugin: 'java-library'\n\ndependencies {\n testImplementation projects.retrofit\n testImplementation projects.retrofit.testHelpers\n testImplementation libs.findBugsAnnotations\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.guava\n testImplementation libs.okhttp.mockwebserver\n}\n\ntasks.withType(JavaCompile).configureEach {\n options.compilerArgs << '-parameters'\n}\n\n// Create a test task for each supported JDK.\n(8..24).each { majorVersion ->\n def jdkTest = tasks.register(\"testJdk$majorVersion\", Test) {\n javaLauncher = javaToolchains.launcherFor {\n languageVersion = JavaLanguageVersion.of(majorVersion)\n vendor = JvmVendorSpec.AZUL\n }\n\n description = \"Runs the test suite on JDK $majorVersion\"\n group = LifecycleBasePlugin.VERIFICATION_GROUP\n\n // Wire directly to the test source set outputs for proper task dependencies.\n testClassesDirs = sourceSets.test.output.classesDirs\n classpath = sourceSets.test.runtimeClasspath\n }\n tasks.named(\"check\").configure {\n dependsOn(jdkTest)\n }\n}\n\n// We don't need the built-in task which uses Gradle's JVM given the above variants.\ntasks.getByName('test').enabled = false\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/AnnotationArraySubject.java", "content": "package retrofit2;\n\nimport static com.google.common.truth.Fact.simpleFact;\nimport static com.google.common.truth.Truth.assertAbout;\n\nimport com.google.common.truth.FailureMetadata;\nimport com.google.common.truth.Subject;\nimport java.lang.annotation.Annotation;\nimport java.util.ArrayList;\nimport java.util.Collections;\nimport java.util.List;\n\npublic final class AnnotationArraySubject extends Subject {\n public static Factory annotationArrays() {\n return AnnotationArraySubject::new;\n }\n\n public static AnnotationArraySubject assertThat(Annotation[] actual) {\n return assertAbout(annotationArrays()).that(actual);\n }\n\n private final List actual;\n\n private AnnotationArraySubject(FailureMetadata metadata, Annotation[] actual) {\n super(metadata, actual);\n this.actual = new ArrayList<>(actual.length);\n Collections.addAll(this.actual, actual);\n }\n\n public void hasAtLeastOneElementOfType(Class cls) {\n for (Annotation annotation : actual) {\n if (cls.isAssignableFrom(annotation.annotationType())) {\n return;\n }\n }\n failWithActual(simpleFact(\"No annotations of instance \" + cls));\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/CallAdapterTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\nimport static retrofit2.CallAdapter.Factory.getParameterUpperBound;\nimport static retrofit2.CallAdapter.Factory.getRawType;\n\nimport com.google.common.reflect.TypeToken;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport java.util.List;\nimport java.util.Map;\nimport org.junit.Test;\n\npublic final class CallAdapterTest {\n @Test\n public void parameterizedTypeInvalidIndex() {\n ParameterizedType listOfString = (ParameterizedType) new TypeToken>() {}.getType();\n try {\n getParameterUpperBound(-1, listOfString);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Index -1 not in range [0,1) for java.util.List\");\n }\n try {\n getParameterUpperBound(1, listOfString);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Index 1 not in range [0,1) for java.util.List\");\n }\n }\n\n @Test\n public void parameterizedTypes() {\n ParameterizedType one = (ParameterizedType) new TypeToken>() {}.getType();\n assertThat(getParameterUpperBound(0, one)).isSameInstanceAs(String.class);\n\n ParameterizedType two = (ParameterizedType) new TypeToken>() {}.getType();\n assertThat(getParameterUpperBound(0, two)).isSameInstanceAs(String.class);\n assertThat(getParameterUpperBound(1, two)).isSameInstanceAs(String.class);\n\n ParameterizedType wild =\n (ParameterizedType) new TypeToken>() {}.getType();\n assertThat(getParameterUpperBound(0, wild)).isSameInstanceAs(CharSequence.class);\n }\n\n @Test\n public void rawTypeThrowsOnNull() {\n try {\n getRawType(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"type == null\");\n }\n }\n\n @Test\n public void rawTypes() throws NoSuchMethodException {\n assertThat(getRawType(String.class)).isSameInstanceAs(String.class);\n\n Type listOfString = new TypeToken>() {}.getType();\n assertThat(getRawType(listOfString)).isSameInstanceAs(List.class);\n\n Type stringArray = new TypeToken() {}.getType();\n assertThat(getRawType(stringArray)).isSameInstanceAs(String[].class);\n\n Type wild =\n ((ParameterizedType) new TypeToken>() {}.getType())\n .getActualTypeArguments()[0];\n assertThat(getRawType(wild)).isSameInstanceAs(CharSequence.class);\n\n Type wildParam =\n ((ParameterizedType) new TypeToken>>() {}.getType())\n .getActualTypeArguments()[0];\n assertThat(getRawType(wildParam)).isSameInstanceAs(List.class);\n\n Type typeVar = A.class.getDeclaredMethod(\"method\").getGenericReturnType();\n assertThat(getRawType(typeVar)).isSameInstanceAs(Object.class);\n }\n\n @SuppressWarnings(\"unused\") // Used reflectively.\n static class A {\n T method() {\n return null;\n }\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/CallTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static java.util.concurrent.TimeUnit.SECONDS;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_DURING_RESPONSE_BODY;\nimport static org.junit.Assert.assertTrue;\nimport static org.junit.Assert.fail;\nimport static retrofit2.TestingUtils.repeat;\n\nimport java.io.IOException;\nimport java.io.InterruptedIOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport java.util.concurrent.CountDownLatch;\nimport java.util.concurrent.TimeUnit;\nimport java.util.concurrent.atomic.AtomicBoolean;\nimport java.util.concurrent.atomic.AtomicInteger;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.OkHttpClient;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport okhttp3.mockwebserver.SocketPolicy;\nimport okio.Buffer;\nimport okio.BufferedSource;\nimport okio.ForwardingSource;\nimport okio.Okio;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.helpers.ToStringConverterFactory;\nimport retrofit2.http.Body;\nimport retrofit2.http.GET;\nimport retrofit2.http.POST;\nimport retrofit2.http.Path;\nimport retrofit2.http.Streaming;\n\npublic final class CallTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\")\n Call getString();\n\n @GET(\"/\")\n Call getBody();\n\n @GET(\"/\")\n @Streaming\n Call getStreamingBody();\n\n @POST(\"/\")\n Call postString(@Body String body);\n\n @POST(\"/{a}\")\n Call postRequestBody(@Path(\"a\") Object a);\n }\n\n @Test\n public void http200Sync() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n Response response = example.getString().execute();\n assertThat(response.isSuccessful()).isTrue();\n assertThat(response.body()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void http200Async() throws InterruptedException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n final AtomicReference> responseRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n example\n .getString()\n .enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n responseRef.set(response);\n latch.countDown();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n t.printStackTrace();\n }\n });\n assertTrue(latch.await(10, SECONDS));\n\n Response response = responseRef.get();\n assertThat(response.isSuccessful()).isTrue();\n assertThat(response.body()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void http404Sync() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setResponseCode(404).setBody(\"Hi\"));\n\n Response response = example.getString().execute();\n assertThat(response.isSuccessful()).isFalse();\n assertThat(response.code()).isEqualTo(404);\n assertThat(response.errorBody().string()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void http404Async() throws InterruptedException, IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setResponseCode(404).setBody(\"Hi\"));\n\n final AtomicReference> responseRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n example\n .getString()\n .enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n responseRef.set(response);\n latch.countDown();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n t.printStackTrace();\n }\n });\n assertTrue(latch.await(10, SECONDS));\n\n Response response = responseRef.get();\n assertThat(response.isSuccessful()).isFalse();\n assertThat(response.code()).isEqualTo(404);\n assertThat(response.errorBody().string()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void transportProblemSync() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setSocketPolicy(SocketPolicy.DISCONNECT_AT_START));\n\n Call call = example.getString();\n try {\n call.execute();\n fail();\n } catch (IOException ignored) {\n }\n }\n\n @Test\n public void transportProblemAsync() throws InterruptedException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setSocketPolicy(SocketPolicy.DISCONNECT_AT_START));\n\n final AtomicReference failureRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n example\n .getString()\n .enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n throw new AssertionError();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n failureRef.set(t);\n latch.countDown();\n }\n });\n assertTrue(latch.await(10, SECONDS));\n\n Throwable failure = failureRef.get();\n assertThat(failure).isInstanceOf(IOException.class);\n }\n\n @Test\n public void conversionProblemOutgoingSync() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(\n new ToStringConverterFactory() {\n @Override\n public Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n return value -> {\n throw new UnsupportedOperationException(\"I am broken!\");\n };\n }\n })\n .build();\n Service example = retrofit.create(Service.class);\n\n Call call = example.postString(\"Hi\");\n try {\n call.execute();\n fail();\n } catch (UnsupportedOperationException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"I am broken!\");\n }\n }\n\n @Test\n public void conversionProblemOutgoingAsync() throws InterruptedException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(\n new ToStringConverterFactory() {\n @Override\n public Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n return value -> {\n throw new UnsupportedOperationException(\"I am broken!\");\n };\n }\n })\n .build();\n Service example = retrofit.create(Service.class);\n\n final AtomicReference failureRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n example\n .postString(\"Hi\")\n .enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n throw new AssertionError();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n failureRef.set(t);\n latch.countDown();\n }\n });\n assertTrue(latch.await(10, SECONDS));\n\n Throwable failure = failureRef.get();\n assertThat(failure).isInstanceOf(UnsupportedOperationException.class);\n assertThat(failure).hasMessageThat().isEqualTo(\"I am broken!\");\n }\n\n @Test\n public void conversionProblemIncomingSync() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(\n new ToStringConverterFactory() {\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return value -> {\n throw new UnsupportedOperationException(\"I am broken!\");\n };\n }\n })\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n Call call = example.postString(\"Hi\");\n try {\n call.execute();\n fail();\n } catch (UnsupportedOperationException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"I am broken!\");\n }\n }\n\n @Test\n public void conversionProblemIncomingMaskedByConverterIsUnwrapped() throws IOException {\n // MWS has no way to trigger IOExceptions during the response body so use an interceptor.\n OkHttpClient client =\n new OkHttpClient.Builder() //\n .addInterceptor(\n chain -> {\n okhttp3.Response response = chain.proceed(chain.request());\n ResponseBody body = response.body();\n BufferedSource source =\n Okio.buffer(\n new ForwardingSource(body.source()) {\n @Override\n public long read(Buffer sink, long byteCount) throws IOException {\n throw new IOException(\"cause\");\n }\n });\n body = ResponseBody.create(body.contentType(), body.contentLength(), source);\n return response.newBuilder().body(body).build();\n })\n .build();\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .client(client)\n .addConverterFactory(\n new ToStringConverterFactory() {\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return value -> {\n try {\n return value.string();\n } catch (IOException e) {\n // Some serialization libraries mask transport problems in runtime\n // exceptions. Bad!\n throw new RuntimeException(\"wrapper\", e);\n }\n };\n }\n })\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n Call call = example.getString();\n try {\n call.execute();\n fail();\n } catch (IOException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"cause\");\n }\n }\n\n @Test\n public void conversionProblemIncomingAsync() throws InterruptedException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(\n new ToStringConverterFactory() {\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return value -> {\n throw new UnsupportedOperationException(\"I am broken!\");\n };\n }\n })\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n final AtomicReference failureRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n example\n .postString(\"Hi\")\n .enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n throw new AssertionError();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n failureRef.set(t);\n latch.countDown();\n }\n });\n assertTrue(latch.await(10, SECONDS));\n\n Throwable failure = failureRef.get();\n assertThat(failure).isInstanceOf(UnsupportedOperationException.class);\n assertThat(failure).hasMessageThat().isEqualTo(\"I am broken!\");\n }\n\n @Test\n public void http204SkipsConverter() throws IOException {\n final Converter converter =\n value -> {\n throw new AssertionError();\n };\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(\n new ToStringConverterFactory() {\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return converter;\n }\n })\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setStatus(\"HTTP/1.1 204 Nothin\"));\n\n Response response = example.getString().execute();\n assertThat(response.code()).isEqualTo(204);\n assertThat(response.body()).isNull();\n }\n\n @Test\n public void http205SkipsConverter() throws IOException {\n final Converter converter =\n value -> {\n throw new AssertionError();\n };\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(\n new ToStringConverterFactory() {\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return converter;\n }\n })\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setStatus(\"HTTP/1.1 205 Nothin\"));\n\n Response response = example.getString().execute();\n assertThat(response.code()).isEqualTo(205);\n assertThat(response.body()).isNull();\n }\n\n @Test\n public void converterBodyDoesNotLeakContentInIntermediateBuffers() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(\n new Converter.Factory() {\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return value -> {\n String prefix = value.source().readUtf8(2);\n value.source().skip(20_000 - 4);\n String suffix = value.source().readUtf8();\n return prefix + suffix;\n };\n }\n })\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(repeat('a', 10_000) + repeat('b', 10_000)));\n\n Response response = example.getString().execute();\n assertThat(response.body()).isEqualTo(\"aabb\");\n }\n\n @Test\n public void executeCallOnce() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n server.enqueue(new MockResponse());\n Call call = example.getString();\n call.execute();\n try {\n call.execute();\n fail();\n } catch (IllegalStateException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Already executed.\");\n }\n }\n\n @Test\n public void successfulRequestResponseWhenMimeTypeMissing() throws Exception {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\").removeHeader(\"Content-Type\"));\n\n Response response = example.getString().execute();\n assertThat(response.body()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void responseBody() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(\"1234\"));\n\n Response response = example.getBody().execute();\n assertThat(response.body().string()).isEqualTo(\"1234\");\n }\n\n @Test\n public void responseBodyBuffers() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(\n new MockResponse().setBody(\"1234\").setSocketPolicy(DISCONNECT_DURING_RESPONSE_BODY));\n\n Call buffered = example.getBody();\n // When buffering we will detect all socket problems before returning the Response.\n try {\n buffered.execute();\n fail();\n } catch (IOException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"unexpected end of stream\");\n }\n }\n\n @Test\n public void responseBodyStreams() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(\n new MockResponse().setBody(\"1234\").setSocketPolicy(DISCONNECT_DURING_RESPONSE_BODY));\n\n Response response = example.getStreamingBody().execute();\n\n ResponseBody streamedBody = response.body();\n // When streaming we only detect socket problems as the ResponseBody is read.\n try {\n streamedBody.string();\n fail();\n } catch (IOException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"unexpected end of stream\");\n }\n }\n\n @Test\n public void rawResponseContentTypeAndLengthButNoSource() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\").addHeader(\"Content-Type\", \"text/greeting\"));\n\n Response response = example.getString().execute();\n assertThat(response.body()).isEqualTo(\"Hi\");\n ResponseBody rawBody = response.raw().body();\n assertThat(rawBody.contentLength()).isEqualTo(2);\n assertThat(rawBody.contentType().toString()).isEqualTo(\"text/greeting\");\n try {\n rawBody.source();\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Cannot read raw response body of a converted body.\");\n }\n }\n\n @Test\n public void emptyResponse() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(\"\").addHeader(\"Content-Type\", \"text/stringy\"));\n\n Response response = example.getString().execute();\n assertThat(response.body()).isEqualTo(\"\");\n ResponseBody rawBody = response.raw().body();\n assertThat(rawBody.contentLength()).isEqualTo(0);\n assertThat(rawBody.contentType().toString()).isEqualTo(\"text/stringy\");\n }\n\n @Test\n public void reportsExecutedSync() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n Call call = example.getString();\n assertThat(call.isExecuted()).isFalse();\n\n call.execute();\n assertThat(call.isExecuted()).isTrue();\n }\n\n @Test\n public void reportsExecutedAsync() throws InterruptedException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n Call call = example.getString();\n assertThat(call.isExecuted()).isFalse();\n\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {}\n\n @Override\n public void onFailure(Call call, Throwable t) {}\n });\n assertThat(call.isExecuted()).isTrue();\n }\n\n @Test\n public void cancelBeforeExecute() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n Call call = service.getString();\n\n call.cancel();\n assertThat(call.isCanceled()).isTrue();\n\n try {\n call.execute();\n fail();\n } catch (IOException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Canceled\");\n }\n }\n\n @Test\n public void cancelBeforeEnqueue() throws Exception {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n Call call = service.getString();\n\n call.cancel();\n assertThat(call.isCanceled()).isTrue();\n\n final AtomicReference failureRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n throw new AssertionError();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n failureRef.set(t);\n latch.countDown();\n }\n });\n assertTrue(latch.await(10, SECONDS));\n assertThat(failureRef.get()).hasMessageThat().isEqualTo(\"Canceled\");\n }\n\n @Test\n public void cloningExecutedRequestDoesNotCopyState() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n server.enqueue(new MockResponse().setBody(\"Hello\"));\n\n Call call = service.getString();\n assertThat(call.execute().body()).isEqualTo(\"Hi\");\n\n Call cloned = call.clone();\n assertThat(cloned.execute().body()).isEqualTo(\"Hello\");\n }\n\n @Test\n public void cancelRequest() throws InterruptedException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setSocketPolicy(SocketPolicy.NO_RESPONSE));\n\n Call call = service.getString();\n\n final AtomicReference failureRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n throw new AssertionError();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n failureRef.set(t);\n latch.countDown();\n }\n });\n\n call.cancel();\n assertThat(call.isCanceled()).isTrue();\n\n assertTrue(latch.await(10, SECONDS));\n Throwable failure = failureRef.get();\n assertThat(failure).isInstanceOf(IOException.class);\n assertThat(failure).hasMessageThat().isEqualTo(\"Canceled\");\n }\n\n @Test\n public void cancelOkHttpRequest() throws InterruptedException {\n OkHttpClient client = new OkHttpClient();\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .client(client)\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setSocketPolicy(SocketPolicy.NO_RESPONSE));\n\n Call call = service.getString();\n\n final AtomicReference failureRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n throw new AssertionError();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n failureRef.set(t);\n latch.countDown();\n }\n });\n\n // Cancel the underlying HTTP Call. Should be reflected accurately back in the Retrofit Call.\n client.dispatcher().cancelAll();\n assertThat(call.isCanceled()).isTrue();\n\n assertTrue(latch.await(10, SECONDS));\n Throwable failure = failureRef.get();\n assertThat(failure).isInstanceOf(IOException.class);\n assertThat(failure).hasMessageThat().isEqualTo(\"Canceled\");\n }\n\n @Test\n public void requestBeforeExecuteCreates() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n final AtomicInteger writeCount = new AtomicInteger();\n Object a =\n new Object() {\n @Override\n public String toString() {\n writeCount.incrementAndGet();\n return \"Hello\";\n }\n };\n Call call = service.postRequestBody(a);\n\n call.request();\n assertThat(writeCount.get()).isEqualTo(1);\n\n call.execute();\n assertThat(writeCount.get()).isEqualTo(1);\n }\n\n @Test\n public void requestThrowingBeforeExecuteFailsExecute() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n final AtomicInteger writeCount = new AtomicInteger();\n Object a =\n new Object() {\n @Override\n public String toString() {\n writeCount.incrementAndGet();\n throw new RuntimeException(\"Broken!\");\n }\n };\n Call call = service.postRequestBody(a);\n\n try {\n call.request();\n fail();\n } catch (RuntimeException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(1);\n\n try {\n call.execute();\n fail();\n } catch (RuntimeException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(1);\n }\n\n @Test\n public void requestThrowingNonFatalErrorBeforeExecuteFailsExecute() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n final AtomicInteger writeCount = new AtomicInteger();\n Object a =\n new Object() {\n @Override\n public String toString() {\n writeCount.incrementAndGet();\n throw new NonFatalError(\"Broken!\");\n }\n };\n Call call = service.postRequestBody(a);\n\n try {\n call.request();\n fail();\n } catch (NonFatalError e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(1);\n\n try {\n call.execute();\n fail();\n } catch (NonFatalError e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(1);\n }\n\n @Test\n public void requestAfterExecuteReturnsCachedValue() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n final AtomicInteger writeCount = new AtomicInteger();\n Object a =\n new Object() {\n @Override\n public String toString() {\n writeCount.incrementAndGet();\n return \"Hello\";\n }\n };\n Call call = service.postRequestBody(a);\n\n call.execute();\n assertThat(writeCount.get()).isEqualTo(1);\n\n call.request();\n assertThat(writeCount.get()).isEqualTo(1);\n }\n\n @Test\n public void requestAfterExecuteThrowingAlsoThrows() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n final AtomicInteger writeCount = new AtomicInteger();\n Object a =\n new Object() {\n @Override\n public String toString() {\n writeCount.incrementAndGet();\n throw new RuntimeException(\"Broken!\");\n }\n };\n Call call = service.postRequestBody(a);\n\n try {\n call.execute();\n fail();\n } catch (RuntimeException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(1);\n\n try {\n call.request();\n fail();\n } catch (RuntimeException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(1);\n }\n\n @Test\n public void requestAfterExecuteThrowingAlsoThrowsForNonFatalErrors() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n final AtomicInteger writeCount = new AtomicInteger();\n Object a =\n new Object() {\n @Override\n public String toString() {\n writeCount.incrementAndGet();\n throw new NonFatalError(\"Broken!\");\n }\n };\n Call call = service.postRequestBody(a);\n\n try {\n call.execute();\n fail();\n } catch (NonFatalError e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(1);\n\n try {\n call.request();\n fail();\n } catch (NonFatalError e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(1);\n }\n\n @Test\n public void requestBeforeEnqueueCreates() throws IOException, InterruptedException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n final AtomicInteger writeCount = new AtomicInteger();\n Object a =\n new Object() {\n @Override\n public String toString() {\n writeCount.incrementAndGet();\n return \"Hello\";\n }\n };\n Call call = service.postRequestBody(a);\n\n call.request();\n assertThat(writeCount.get()).isEqualTo(1);\n\n final CountDownLatch latch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n assertThat(writeCount.get()).isEqualTo(1);\n latch.countDown();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {}\n });\n assertTrue(latch.await(10, SECONDS));\n }\n\n @Test\n public void requestThrowingBeforeEnqueueFailsEnqueue() throws IOException, InterruptedException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n final AtomicInteger writeCount = new AtomicInteger();\n Object a =\n new Object() {\n @Override\n public String toString() {\n writeCount.incrementAndGet();\n throw new RuntimeException(\"Broken!\");\n }\n };\n Call call = service.postRequestBody(a);\n\n try {\n call.request();\n fail();\n } catch (RuntimeException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(1);\n\n final CountDownLatch latch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {}\n\n @Override\n public void onFailure(Call call, Throwable t) {\n // Exact instance check as opposed to isInstanceOf's subtype checking.\n assertThat(t.getClass()).isEqualTo(RuntimeException.class);\n assertThat(t).hasMessageThat().isEqualTo(\"Broken!\");\n assertThat(writeCount.get()).isEqualTo(1);\n latch.countDown();\n }\n });\n assertTrue(latch.await(10, SECONDS));\n }\n\n @Test\n public void requestThrowingNonFatalErrorBeforeEnqueueFailsEnqueue()\n throws IOException, InterruptedException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n final AtomicInteger writeCount = new AtomicInteger();\n Object a =\n new Object() {\n @Override\n public String toString() {\n writeCount.incrementAndGet();\n throw new NonFatalError(\"Broken!\");\n }\n };\n Call call = service.postRequestBody(a);\n\n try {\n call.request();\n fail();\n } catch (NonFatalError e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(1);\n\n final CountDownLatch latch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {}\n\n @Override\n public void onFailure(Call call, Throwable t) {\n // Exact instance check as opposed to isInstanceOf's subtype checking.\n assertThat(t.getClass()).isEqualTo(NonFatalError.class);\n assertThat(t).hasMessageThat().isEqualTo(\"Broken!\");\n assertThat(writeCount.get()).isEqualTo(1);\n latch.countDown();\n }\n });\n assertTrue(latch.await(10, SECONDS));\n }\n\n @Test\n public void requestAfterEnqueueReturnsCachedValue() throws IOException, InterruptedException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n final AtomicInteger writeCount = new AtomicInteger();\n Object a =\n new Object() {\n @Override\n public String toString() {\n writeCount.incrementAndGet();\n return \"Hello\";\n }\n };\n Call call = service.postRequestBody(a);\n\n final CountDownLatch latch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n assertThat(writeCount.get()).isEqualTo(1);\n latch.countDown();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {}\n });\n assertTrue(latch.await(10, SECONDS));\n\n call.request();\n assertThat(writeCount.get()).isEqualTo(1);\n }\n\n @Test\n public void requestAfterEnqueueFailingThrows() throws IOException, InterruptedException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n final AtomicInteger writeCount = new AtomicInteger();\n Object a =\n new Object() {\n @Override\n public String toString() {\n writeCount.incrementAndGet();\n throw new RuntimeException(\"Broken!\");\n }\n };\n Call call = service.postRequestBody(a);\n\n final CountDownLatch latch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {}\n\n @Override\n public void onFailure(Call call, Throwable t) {\n // Exact instance check as opposed to isInstanceOf's subtype checking.\n assertThat(t.getClass()).isEqualTo(RuntimeException.class);\n assertThat(t).hasMessageThat().isEqualTo(\"Broken!\");\n assertThat(writeCount.get()).isEqualTo(1);\n latch.countDown();\n }\n });\n assertTrue(latch.await(10, SECONDS));\n\n try {\n call.request();\n fail();\n } catch (RuntimeException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(1);\n }\n\n @Test\n public void requestAfterEnqueueFailingThrowsForNonFatalErrors()\n throws IOException, InterruptedException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n final AtomicInteger writeCount = new AtomicInteger();\n Object a =\n new Object() {\n @Override\n public String toString() {\n writeCount.incrementAndGet();\n throw new NonFatalError(\"Broken!\");\n }\n };\n Call call = service.postRequestBody(a);\n\n final CountDownLatch latch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {}\n\n @Override\n public void onFailure(Call call, Throwable t) {\n // Exact instance check as opposed to isInstanceOf's subtype checking.\n assertThat(t.getClass()).isEqualTo(NonFatalError.class);\n assertThat(t).hasMessageThat().isEqualTo(\"Broken!\");\n assertThat(writeCount.get()).isEqualTo(1);\n latch.countDown();\n }\n });\n assertTrue(latch.await(10, SECONDS));\n\n try {\n call.request();\n fail();\n } catch (NonFatalError e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(1);\n }\n\n @Test\n public void fatalErrorsAreNotCaughtRequest() throws Exception {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n final AtomicInteger writeCount = new AtomicInteger();\n Object a =\n new Object() {\n @Override\n public String toString() {\n writeCount.incrementAndGet();\n throw new OutOfMemoryError(\"Broken!\");\n }\n };\n Call call = service.postRequestBody(a);\n\n try {\n call.request();\n fail();\n } catch (OutOfMemoryError e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(1);\n\n try {\n call.request();\n fail();\n } catch (OutOfMemoryError e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(2);\n }\n\n @Test\n public void fatalErrorsAreNotCaughtEnqueue() throws Exception {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n final AtomicInteger writeCount = new AtomicInteger();\n Object a =\n new Object() {\n @Override\n public String toString() {\n writeCount.incrementAndGet();\n throw new OutOfMemoryError(\"Broken!\");\n }\n };\n Call call = service.postRequestBody(a);\n\n try {\n final AtomicBoolean callsFailureSynchronously = new AtomicBoolean();\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {}\n\n @Override\n public void onFailure(Call call, Throwable t) {\n callsFailureSynchronously.set(true); // Will not be called for fatal errors.\n }\n });\n assertThat(callsFailureSynchronously.get()).isFalse();\n fail();\n } catch (OutOfMemoryError e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(1);\n\n try {\n call.request();\n fail();\n } catch (OutOfMemoryError e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(2);\n }\n\n @Test\n public void fatalErrorsAreNotCaughtExecute() throws Exception {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n final AtomicInteger writeCount = new AtomicInteger();\n Object a =\n new Object() {\n @Override\n public String toString() {\n writeCount.incrementAndGet();\n throw new OutOfMemoryError(\"Broken!\");\n }\n };\n Call call = service.postRequestBody(a);\n\n try {\n call.execute();\n fail();\n } catch (OutOfMemoryError e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(1);\n\n try {\n call.request();\n fail();\n } catch (OutOfMemoryError e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Broken!\");\n }\n assertThat(writeCount.get()).isEqualTo(2);\n }\n\n @Test\n public void timeoutExceeded() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setHeadersDelay(500, TimeUnit.MILLISECONDS));\n\n Call call = example.getString();\n call.timeout().timeout(100, TimeUnit.MILLISECONDS);\n try {\n call.execute();\n fail();\n } catch (InterruptedIOException expected) {\n }\n }\n\n @Test\n public void deadlineExceeded() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setHeadersDelay(500, TimeUnit.MILLISECONDS));\n\n Call call = example.getString();\n call.timeout().deadline(100, TimeUnit.MILLISECONDS);\n try {\n call.execute();\n fail();\n } catch (InterruptedIOException expected) {\n }\n }\n\n @Test\n public void timeoutEnabledButNotExceeded() throws IOException {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setHeadersDelay(100, TimeUnit.MILLISECONDS));\n\n Call call = example.getString();\n call.timeout().deadline(500, TimeUnit.MILLISECONDS);\n Response response = call.execute();\n assertThat(response.isSuccessful()).isTrue();\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/CompletableFutureCallAdapterFactoryTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport com.google.common.reflect.TypeToken;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport java.util.List;\nimport java.util.concurrent.CompletableFuture;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.helpers.ToStringConverterFactory;\n\npublic final class CompletableFutureCallAdapterFactoryTest {\n private static final Annotation[] NO_ANNOTATIONS = new Annotation[0];\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private final CallAdapter.Factory factory = new CompletableFutureCallAdapterFactory();\n private Retrofit retrofit;\n\n @Before\n public void setUp() {\n retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n }\n\n @Test\n public void responseType() {\n Type bodyClass = new TypeToken>() {}.getType();\n assertThat(factory.get(bodyClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type bodyWildcard = new TypeToken>() {}.getType();\n assertThat(factory.get(bodyWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type bodyGeneric = new TypeToken>>() {}.getType();\n assertThat(factory.get(bodyGeneric, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(new TypeToken>() {}.getType());\n Type responseClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(responseClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type responseWildcard =\n new TypeToken>>() {}.getType();\n assertThat(factory.get(responseWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type resultClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(resultClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type resultWildcard =\n new TypeToken>>() {}.getType();\n assertThat(factory.get(resultWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n }\n\n @Test\n public void nonListenableFutureReturnsNull() {\n CallAdapter adapter = factory.get(String.class, NO_ANNOTATIONS, retrofit);\n assertThat(adapter).isNull();\n }\n\n @Test\n public void rawTypeThrows() {\n Type observableType = new TypeToken() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"CompletableFuture return type must be parameterized as CompletableFuture or CompletableFuture\");\n }\n }\n\n @Test\n public void rawResponseTypeThrows() {\n Type observableType = new TypeToken>() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Response must be parameterized as Response or Response\");\n }\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/CompletableFutureTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\nimport static org.junit.Assert.fail;\n\nimport java.io.IOException;\nimport java.util.concurrent.CompletableFuture;\nimport java.util.concurrent.ExecutionException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.helpers.ToStringConverterFactory;\nimport retrofit2.http.GET;\n\npublic final class CompletableFutureTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\")\n CompletableFuture body();\n\n @GET(\"/\")\n CompletableFuture> response();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodySuccess200() throws Exception {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n CompletableFuture future = service.body();\n assertThat(future.get()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void bodySuccess404() throws Exception {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n CompletableFuture future = service.body();\n try {\n future.get();\n fail();\n } catch (ExecutionException e) {\n Throwable cause = e.getCause();\n assertThat(cause).isInstanceOf(HttpException.class);\n assertThat(cause).hasMessageThat().isEqualTo(\"HTTP 404 Client Error\");\n }\n }\n\n @Test\n public void bodyFailure() throws Exception {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n CompletableFuture future = service.body();\n try {\n future.get();\n fail();\n } catch (ExecutionException e) {\n assertThat(e).hasCauseThat().isInstanceOf(IOException.class);\n }\n }\n\n @Test\n public void responseSuccess200() throws Exception {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n CompletableFuture> future = service.response();\n Response response = future.get();\n assertThat(response.isSuccessful()).isTrue();\n assertThat(response.body()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void responseSuccess404() throws Exception {\n server.enqueue(new MockResponse().setResponseCode(404).setBody(\"Hi\"));\n\n CompletableFuture> future = service.response();\n Response response = future.get();\n assertThat(response.isSuccessful()).isFalse();\n assertThat(response.errorBody().string()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void responseFailure() throws Exception {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n CompletableFuture> future = service.response();\n try {\n future.get();\n fail();\n } catch (ExecutionException e) {\n assertThat(e).hasCauseThat().isInstanceOf(IOException.class);\n }\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/DefaultCallAdapterFactoryTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.assertTrue;\nimport static org.junit.Assert.fail;\n\nimport com.google.common.reflect.TypeToken;\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport java.util.List;\nimport java.util.concurrent.atomic.AtomicBoolean;\nimport okhttp3.Request;\nimport okio.Timeout;\nimport org.junit.Test;\n\n@SuppressWarnings(\"unchecked\")\npublic final class DefaultCallAdapterFactoryTest {\n private static final Annotation[] NO_ANNOTATIONS = new Annotation[0];\n\n private final Retrofit retrofit = new Retrofit.Builder().baseUrl(\"http://localhost:1\").build();\n private final CallAdapter.Factory factory = new DefaultCallAdapterFactory(Runnable::run);\n\n @Test\n public void rawTypeThrows() {\n try {\n factory.get(Call.class, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Call return type must be parameterized as Call or Call\");\n }\n }\n\n @Test\n public void responseType() {\n Type classType = new TypeToken>() {}.getType();\n assertThat(factory.get(classType, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type wilcardType = new TypeToken>() {}.getType();\n assertThat(factory.get(wilcardType, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type genericType = new TypeToken>>() {}.getType();\n assertThat(factory.get(genericType, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(new TypeToken>() {}.getType());\n }\n\n @Test\n public void adaptedCallExecute() throws IOException {\n Type returnType = new TypeToken>() {}.getType();\n CallAdapter> adapter =\n (CallAdapter>) factory.get(returnType, NO_ANNOTATIONS, retrofit);\n final Response response = Response.success(\"Hi\");\n Call call =\n adapter.adapt(\n new EmptyCall() {\n @Override\n public Response execute() {\n return response;\n }\n });\n assertThat(call.execute()).isSameInstanceAs(response);\n }\n\n @Test\n public void adaptedCallCloneDeepCopy() {\n Type returnType = new TypeToken>() {}.getType();\n CallAdapter> adapter =\n (CallAdapter>) factory.get(returnType, NO_ANNOTATIONS, retrofit);\n final AtomicBoolean cloned = new AtomicBoolean();\n Call delegate =\n new EmptyCall() {\n @Override\n public Call clone() {\n cloned.set(true);\n return this;\n }\n };\n Call call = adapter.adapt(delegate);\n assertThat(call.clone()).isNotSameInstanceAs(call);\n assertTrue(cloned.get());\n }\n\n @Test\n public void adaptedCallCancel() {\n Type returnType = new TypeToken>() {}.getType();\n CallAdapter> adapter =\n (CallAdapter>) factory.get(returnType, NO_ANNOTATIONS, retrofit);\n final AtomicBoolean canceled = new AtomicBoolean();\n Call delegate =\n new EmptyCall() {\n @Override\n public void cancel() {\n canceled.set(true);\n }\n };\n Call call = adapter.adapt(delegate);\n call.cancel();\n assertTrue(canceled.get());\n }\n\n static class EmptyCall implements Call {\n @Override\n public void enqueue(Callback callback) {\n throw new UnsupportedOperationException();\n }\n\n @Override\n public boolean isExecuted() {\n return false;\n }\n\n @Override\n public Response execute() throws IOException {\n throw new UnsupportedOperationException();\n }\n\n @Override\n public void cancel() {\n throw new UnsupportedOperationException();\n }\n\n @Override\n public boolean isCanceled() {\n return false;\n }\n\n @Override\n public Call clone() {\n throw new UnsupportedOperationException();\n }\n\n @Override\n public Request request() {\n throw new UnsupportedOperationException();\n }\n\n @Override\n public Timeout timeout() {\n return Timeout.NONE;\n }\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/DefaultMethodsTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\n\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.helpers.ToStringConverterFactory;\nimport retrofit2.http.GET;\nimport retrofit2.http.Query;\n\npublic final class DefaultMethodsTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Example {\n @GET(\"/\")\n Call user(@Query(\"name\") String name);\n\n default Call user() {\n return user(\"hey\");\n }\n }\n\n @Test\n public void test() throws IOException {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n Example example = retrofit.create(Example.class);\n\n Response response = example.user().execute();\n assertThat(response.body()).isEqualTo(\"Hi\");\n Response response2 = example.user(\"Hi\").execute();\n assertThat(response2.body()).isEqualTo(\"Hi\");\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/HttpExceptionTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport org.junit.Test;\n\npublic final class HttpExceptionTest {\n @Test\n public void response() {\n Response response = Response.success(\"Hi\");\n HttpException exception = new HttpException(response);\n assertThat(exception.code()).isEqualTo(200);\n assertThat(exception.message()).isEqualTo(\"OK\");\n assertThat(exception.response()).isSameInstanceAs(response);\n }\n\n @Test\n public void nullResponseThrows() {\n try {\n new HttpException(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"response == null\");\n }\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/InvocationTest.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport java.lang.reflect.Method;\nimport java.util.ArrayList;\nimport java.util.Arrays;\nimport java.util.List;\nimport okhttp3.MediaType;\nimport okhttp3.OkHttpClient;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport org.junit.Test;\nimport retrofit2.http.Body;\nimport retrofit2.http.GET;\nimport retrofit2.http.POST;\nimport retrofit2.http.Path;\nimport retrofit2.http.Query;\nimport retrofit2.http.Url;\n\npublic final class InvocationTest {\n interface Example {\n @POST(\"/{p1}\") //\n Call postMethod(\n @Path(\"p1\") String p1, @Query(\"p2\") String p2, @Body RequestBody body);\n\n @GET //\n Call urlMethod(@Url String url);\n }\n\n interface ExampleSub extends Example {}\n\n @Test\n public void invocationObjectOnCallAndRequestTag() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com/\")\n .callFactory(new OkHttpClient())\n .build();\n\n Example example = retrofit.create(Example.class);\n RequestBody requestBody = RequestBody.create(MediaType.get(\"text/plain\"), \"three\");\n Call call = example.postMethod(\"one\", \"two\", requestBody);\n\n Invocation invocation = call.request().tag(Invocation.class);\n Method method = invocation.method();\n assertThat(method.getName()).isEqualTo(\"postMethod\");\n assertThat(method.getDeclaringClass()).isEqualTo(Example.class);\n assertThat(invocation.arguments()).isEqualTo(Arrays.asList(\"one\", \"two\", requestBody));\n assertThat(invocation.annotationUrl()).isEqualTo(\"/{p1}\");\n }\n\n @Test\n public void invocationCorrectlyIdentifiesServiceMethodInvocation() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com/\")\n .callFactory(new OkHttpClient())\n .build();\n\n ExampleSub example = retrofit.create(ExampleSub.class);\n RequestBody requestBody = RequestBody.create(MediaType.get(\"text/plain\"), \"three\");\n Call call = example.postMethod(\"one\", \"two\", requestBody);\n\n Invocation invocation = call.request().tag(Invocation.class);\n assertThat(invocation.service()).isEqualTo(ExampleSub.class);\n assertThat(invocation.instance()).isSameInstanceAs(example);\n assertThat(invocation.method().getName()).isEqualTo(\"postMethod\");\n assertThat(invocation.method().getDeclaringClass()).isEqualTo(Example.class);\n assertThat(invocation.arguments()).isEqualTo(Arrays.asList(\"one\", \"two\", requestBody));\n assertThat(invocation.annotationUrl()).isEqualTo(\"/{p1}\");\n }\n\n @Test\n public void annotationUrlAbsent() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com/\")\n .callFactory(new OkHttpClient())\n .build();\n\n Example example = retrofit.create(Example.class);\n Call call = example.urlMethod(\"/abc\");\n\n Invocation invocation = call.request().tag(Invocation.class);\n Method method = invocation.method();\n assertThat(method.getName()).isEqualTo(\"urlMethod\");\n assertThat(method.getDeclaringClass()).isEqualTo(Example.class);\n assertThat(invocation.arguments()).isEqualTo(Arrays.asList(\"/abc\"));\n assertThat(invocation.annotationUrl()).isNull();\n }\n\n @Test\n public void ofInstance() {\n try {\n Invocation.of(\n null, new Object(), Object.class.getDeclaredMethods()[0], Arrays.asList(\"one\", \"two\"));\n fail();\n } catch (NullPointerException expected) {\n assertThat(expected).hasMessageThat().isEqualTo(\"service == null\");\n }\n }\n\n @Test\n public void nullService() {\n Object service = new Object();\n Method method = Object.class.getDeclaredMethods()[0];\n List arguments = Arrays.asList(\"one\", \"two\");\n Invocation invocation = Invocation.of(Object.class, service, method, arguments, \"/abc\");\n assertThat(invocation.service()).isEqualTo(Object.class);\n assertThat(invocation.instance()).isEqualTo(service);\n assertThat(invocation.method()).isEqualTo(method);\n assertThat(invocation.arguments()).isEqualTo(arguments);\n assertThat(invocation.annotationUrl()).isEqualTo(\"/abc\");\n }\n\n @Test\n public void nullInstance() {\n try {\n Invocation.of(\n Object.class,\n null,\n Object.class.getDeclaredMethods()[0],\n Arrays.asList(\"one\", \"two\"),\n null);\n fail();\n } catch (NullPointerException expected) {\n assertThat(expected).hasMessageThat().isEqualTo(\"instance == null\");\n }\n }\n\n @Test\n public void nullMethod() {\n try {\n Invocation.of(Object.class, new Object(), null, Arrays.asList(\"one\", \"two\"), null);\n fail();\n } catch (NullPointerException expected) {\n assertThat(expected).hasMessageThat().isEqualTo(\"method == null\");\n }\n }\n\n @Test\n public void nullArguments() {\n try {\n Invocation.of(Object.class, new Object(), Example.class.getDeclaredMethods()[0], null, null);\n fail();\n } catch (NullPointerException expected) {\n assertThat(expected).hasMessageThat().isEqualTo(\"arguments == null\");\n }\n }\n\n @Test\n public void deprecatedNullMethod() {\n try {\n Invocation.of(null, Arrays.asList(\"one\", \"two\"));\n fail();\n } catch (NullPointerException expected) {\n assertThat(expected).hasMessageThat().isEqualTo(\"method == null\");\n }\n }\n\n @Test\n public void deprecatedNullArguments() {\n try {\n Invocation.of(Example.class.getDeclaredMethods()[0], null);\n fail();\n } catch (NullPointerException expected) {\n assertThat(expected).hasMessageThat().isEqualTo(\"arguments == null\");\n }\n }\n\n @Test\n public void argumentsAreImmutable() {\n List mutableList = new ArrayList<>(Arrays.asList(\"one\", \"two\"));\n Invocation invocation = Invocation.of(Example.class.getDeclaredMethods()[0], mutableList);\n mutableList.add(\"three\");\n assertThat(invocation.arguments()).isEqualTo(Arrays.asList(\"one\", \"two\"));\n try {\n invocation.arguments().clear();\n fail();\n } catch (UnsupportedOperationException expected) {\n }\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/Java8DefaultStaticMethodsInValidationTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static org.junit.Assert.assertNotNull;\n\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.helpers.ToStringConverterFactory;\nimport retrofit2.http.GET;\nimport retrofit2.http.Query;\n\npublic final class Java8DefaultStaticMethodsInValidationTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Example {\n @GET(\"/\")\n Call user(@Query(\"name\") String name);\n\n default Call user() {\n return user(\"hey\");\n }\n\n static String staticMethod() {\n return \"Hi\";\n }\n }\n\n @Test\n public void test() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .validateEagerly(true)\n .build();\n assertNotNull(retrofit.create(Example.class));\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/MethodParameterReflectionTest.java", "content": "/*\n * Copyright (C) 2024 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport okhttp3.ResponseBody;\nimport org.junit.Test;\nimport retrofit2.helpers.ExampleWithoutParameterNames;\nimport retrofit2.http.GET;\n\npublic final class MethodParameterReflectionTest {\n private final Retrofit retrofit =\n new Retrofit.Builder().baseUrl(\"http://example.com/\").validateEagerly(true).build();\n\n @Test\n public void paramIndexIsUsedWithoutParamReflection() {\n try {\n retrofit.create(ExampleWithoutParameterNames.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"No Retrofit annotation found. (parameter #1)\\n for method ExampleWithoutParameterNames.method\");\n }\n }\n\n /** This module is compiled with parameter names embedded in the class file. */\n interface ExampleWithParameterNames {\n @GET(\"/\") //\n Call method(String theFirstParameter);\n }\n\n @Test\n public void paramNameIsUsedWithParamReflection() {\n try {\n retrofit.create(ExampleWithParameterNames.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"No Retrofit annotation found. (parameter 'theFirstParameter')\\n for method ExampleWithParameterNames.method\");\n }\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/NonFatalError.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nfinal class NonFatalError extends Error {\n NonFatalError(String message) {\n super(message);\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/OptionalConverterFactoryTest.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\n\nimport java.io.IOException;\nimport java.util.Optional;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.helpers.ObjectInstanceConverterFactory;\nimport retrofit2.http.GET;\n\npublic final class OptionalConverterFactoryTest {\n interface Service {\n @GET(\"/\")\n Call> optional();\n\n @GET(\"/\")\n Call object();\n }\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ObjectInstanceConverterFactory())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void optional() throws IOException {\n server.enqueue(new MockResponse());\n\n Optional optional = service.optional().execute().body();\n assertThat(optional).isNotNull();\n assertThat(optional.get()).isSameInstanceAs(ObjectInstanceConverterFactory.VALUE);\n }\n\n @Test\n public void onlyMatchesOptional() throws IOException {\n server.enqueue(new MockResponse());\n\n Object body = service.object().execute().body();\n assertThat(body).isSameInstanceAs(ObjectInstanceConverterFactory.VALUE);\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/RequestFactoryBuilderTest.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\n\nimport java.util.Set;\nimport org.junit.Test;\n\n// TODO this test is far too white box, migrate to black box.\npublic final class RequestFactoryBuilderTest {\n @Test\n public void pathParameterParsing() throws Exception {\n expectParams(\"/\");\n expectParams(\"/foo\");\n expectParams(\"/foo/bar\");\n expectParams(\"/foo/bar/{}\");\n expectParams(\"/foo/bar/{taco}\", \"taco\");\n expectParams(\"/foo/bar/{t}\", \"t\");\n expectParams(\"/foo/bar/{!!!}/\"); // Invalid parameter.\n expectParams(\"/foo/bar/{}/{taco}\", \"taco\");\n expectParams(\"/foo/bar/{taco}/or/{burrito}\", \"taco\", \"burrito\");\n expectParams(\"/foo/bar/{taco}/or/{taco}\", \"taco\");\n expectParams(\"/foo/bar/{taco-shell}\", \"taco-shell\");\n expectParams(\"/foo/bar/{taco_shell}\", \"taco_shell\");\n expectParams(\"/foo/bar/{sha256}\", \"sha256\");\n expectParams(\"/foo/bar/{TACO}\", \"TACO\");\n expectParams(\"/foo/bar/{taco}/{tAco}/{taCo}\", \"taco\", \"tAco\", \"taCo\");\n expectParams(\"/foo/bar/{1}\"); // Invalid parameter, name cannot start with digit.\n }\n\n private static void expectParams(String path, String... expected) {\n Set calculated = RequestFactory.Builder.parsePathParameters(path);\n assertThat(calculated).containsExactlyElementsIn(expected);\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/RequestFactoryTest.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static java.util.Arrays.asList;\nimport static java.util.Collections.emptyList;\nimport static org.junit.Assert.assertNull;\nimport static org.junit.Assert.fail;\nimport static retrofit2.TestingUtils.buildRequest;\n\nimport java.io.IOException;\nimport java.math.BigInteger;\nimport java.net.URI;\nimport java.util.Arrays;\nimport java.util.Collections;\nimport java.util.HashMap;\nimport java.util.LinkedHashMap;\nimport java.util.List;\nimport java.util.Map;\nimport okhttp3.HttpUrl;\nimport okhttp3.MediaType;\nimport okhttp3.MultipartBody;\nimport okhttp3.Request;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport okio.Buffer;\nimport org.junit.Ignore;\nimport org.junit.Test;\nimport retrofit2.helpers.NullObjectConverterFactory;\nimport retrofit2.http.Body;\nimport retrofit2.http.DELETE;\nimport retrofit2.http.Field;\nimport retrofit2.http.FieldMap;\nimport retrofit2.http.FormUrlEncoded;\nimport retrofit2.http.GET;\nimport retrofit2.http.HEAD;\nimport retrofit2.http.HTTP;\nimport retrofit2.http.Header;\nimport retrofit2.http.HeaderMap;\nimport retrofit2.http.Headers;\nimport retrofit2.http.Multipart;\nimport retrofit2.http.OPTIONS;\nimport retrofit2.http.PATCH;\nimport retrofit2.http.POST;\nimport retrofit2.http.PUT;\nimport retrofit2.http.Part;\nimport retrofit2.http.PartMap;\nimport retrofit2.http.Path;\nimport retrofit2.http.Query;\nimport retrofit2.http.QueryMap;\nimport retrofit2.http.QueryName;\nimport retrofit2.http.Tag;\nimport retrofit2.http.Url;\n\n@SuppressWarnings({\"UnusedParameters\", \"unused\"}) // Parameters inspected reflectively.\npublic final class RequestFactoryTest {\n private static final MediaType TEXT_PLAIN = MediaType.get(\"text/plain\");\n\n @Test\n public void customMethodNoBody() {\n class Example {\n @HTTP(method = \"CUSTOM1\", path = \"/foo\")\n Call method() {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class);\n assertThat(request.method()).isEqualTo(\"CUSTOM1\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void customMethodWithBody() {\n class Example {\n @HTTP(method = \"CUSTOM2\", path = \"/foo\", hasBody = true)\n Call method(@Body RequestBody body) {\n return null;\n }\n }\n\n RequestBody body = RequestBody.create(TEXT_PLAIN, \"hi\");\n Request request = buildRequest(Example.class, body);\n assertThat(request.method()).isEqualTo(\"CUSTOM2\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo\");\n assertBody(request.body(), \"hi\");\n }\n\n @Test\n public void onlyOneEncodingIsAllowedMultipartFirst() {\n class Example {\n @Multipart //\n @FormUrlEncoded //\n @POST(\"/\") //\n Call method() {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Only one encoding annotation is allowed.\\n for method Example.method\");\n }\n }\n\n @Test\n public void onlyOneEncodingIsAllowedFormEncodingFirst() {\n class Example {\n @FormUrlEncoded //\n @Multipart //\n @POST(\"/\") //\n Call method() {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Only one encoding annotation is allowed.\\n for method Example.method\");\n }\n }\n\n @Test\n public void invalidPathParam() throws Exception {\n class Example {\n @GET(\"/\") //\n Call method(@Path(\"hey!\") String thing) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Path parameter name must match \\\\{([a-zA-Z][a-zA-Z0-9_-]*)\\\\}.\"\n + \" Found: hey! (parameter 'thing')\\n for method Example.method\");\n }\n }\n\n @Test\n public void pathParamNotAllowedInQuery() throws Exception {\n class Example {\n @GET(\"/foo?bar={bar}\") //\n Call method(@Path(\"bar\") String thing) {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"URL query string \\\"bar={bar}\\\" must not have replace block.\"\n + \" For dynamic query parameters use @Query.\\n for method Example.method\");\n }\n }\n\n @Test\n public void multipleParameterAnnotationsNotAllowed() throws Exception {\n class Example {\n @GET(\"/\") //\n Call method(@Body @Query(\"nope\") String o) {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Multiple Retrofit annotations found, only one allowed. (parameter 'o')\\n for method Example.method\");\n }\n }\n\n @interface NonNull {}\n\n @Test\n public void multipleParameterAnnotationsOnlyOneRetrofitAllowed() throws Exception {\n class Example {\n @GET(\"/\") //\n Call method(@Query(\"maybe\") @NonNull Object o) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"yep\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/?maybe=yep\");\n }\n\n @Test\n public void twoMethodsFail() {\n class Example {\n @PATCH(\"/foo\") //\n @POST(\"/foo\") //\n Call method() {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isAnyOf(\n \"Only one HTTP method is allowed. Found: PATCH and POST.\\n for method Example.method\",\n \"Only one HTTP method is allowed. Found: POST and PATCH.\\n for method Example.method\");\n }\n }\n\n @Test\n public void lackingMethod() {\n class Example {\n Call method() {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"HTTP method annotation is required (e.g., @GET, @POST, etc.).\\n for method Example.method\");\n }\n }\n\n @Test\n public void implicitMultipartForbidden() {\n class Example {\n @POST(\"/\") //\n Call method(@Part(\"a\") int a) {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Part parameters can only be used with multipart encoding. (parameter 'a')\\n for method Example.method\");\n }\n }\n\n @Test\n public void implicitMultipartWithPartMapForbidden() {\n class Example {\n @POST(\"/\") //\n Call method(@PartMap Map params) {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@PartMap parameters can only be used with multipart encoding. (parameter 'params')\\n for method Example.method\");\n }\n }\n\n @Test\n public void multipartFailsOnNonBodyMethod() {\n class Example {\n @Multipart //\n @GET(\"/\") //\n Call method() {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Multipart can only be specified on HTTP methods with request body (e.g., @POST).\\n for method Example.method\");\n }\n }\n\n @Test\n public void multipartFailsWithNoParts() {\n class Example {\n @Multipart //\n @POST(\"/\") //\n Call method() {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Multipart method must contain at least one @Part.\\n for method Example.method\");\n }\n }\n\n @Test\n public void implicitFormEncodingByFieldForbidden() {\n class Example {\n @POST(\"/\") //\n Call method(@Field(\"a\") int a) {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Field parameters can only be used with form encoding. (parameter 'a')\\n for method Example.method\");\n }\n }\n\n @Test\n public void implicitFormEncodingByFieldMapForbidden() {\n class Example {\n @POST(\"/\") //\n Call method(@FieldMap Map a) {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@FieldMap parameters can only be used with form encoding. (parameter 'a')\\n for method Example.method\");\n }\n }\n\n @Test\n public void formEncodingFailsOnNonBodyMethod() {\n class Example {\n @FormUrlEncoded //\n @GET(\"/\") //\n Call method() {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"FormUrlEncoded can only be specified on HTTP methods with request body (e.g., @POST).\\n for method Example.method\");\n }\n }\n\n @Test\n public void formEncodingFailsWithNoParts() {\n class Example {\n @FormUrlEncoded //\n @POST(\"/\") //\n Call method() {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Form-encoded method must contain at least one @Field.\\n for method Example.method\");\n }\n }\n\n @Test\n public void headersFailWhenEmptyOnMethod() {\n class Example {\n @GET(\"/\") //\n @Headers({}) //\n Call method() {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"@Headers annotation is empty.\\n for method Example.method\");\n }\n }\n\n @Test\n public void headersFailWhenMalformed() {\n class Example {\n @GET(\"/\") //\n @Headers(\"Malformed\") //\n Call method() {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Headers value must be in the form \\\"Name: Value\\\". Found: \\\"Malformed\\\"\\n for method Example.method\");\n }\n }\n\n @Test\n public void pathParamNonPathParamAndTypedBytes() {\n class Example {\n @PUT(\"/{a}\") //\n Call method(@Path(\"a\") int a, @Path(\"b\") int b, @Body int c) {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"URL \\\"/{a}\\\" does not contain \\\"{b}\\\". (parameter 'b')\\n for method Example.method\");\n }\n }\n\n @Test\n public void parameterWithoutAnnotation() {\n class Example {\n @GET(\"/\") //\n Call method(String a) {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"No Retrofit annotation found. (parameter 'a')\\n for method Example.method\");\n }\n }\n\n @Test\n public void nonBodyHttpMethodWithSingleEntity() {\n class Example {\n @GET(\"/\") //\n Call method(@Body String o) {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Non-body HTTP method cannot contain @Body.\\n for method Example.method\");\n }\n }\n\n @Test\n public void queryMapMustBeAMap() {\n class Example {\n @GET(\"/\") //\n Call method(@QueryMap List a) {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@QueryMap parameter type must be Map. (parameter 'a')\\n for method Example.method\");\n }\n }\n\n @Test\n public void queryMapSupportsSubclasses() {\n class Foo extends HashMap {}\n\n class Example {\n @GET(\"/\") //\n Call method(@QueryMap Foo a) {\n return null;\n }\n }\n\n Foo foo = new Foo();\n foo.put(\"hello\", \"world\");\n\n Request request = buildRequest(Example.class, foo);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/?hello=world\");\n }\n\n @Test\n public void queryMapRejectsNull() {\n class Example {\n @GET(\"/\") //\n Call method(@QueryMap Map a) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, new Object[] {null});\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Query map was null (parameter 'a')\\n\" + \" for method Example.method\");\n }\n }\n\n @Test\n public void queryMapRejectsNullKeys() {\n class Example {\n @GET(\"/\") //\n Call method(@QueryMap Map a) {\n return null;\n }\n }\n\n Map queryParams = new LinkedHashMap<>();\n queryParams.put(\"ping\", \"pong\");\n queryParams.put(null, \"kat\");\n\n try {\n buildRequest(Example.class, queryParams);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Query map contained null key. (parameter 'a')\\n\" + \" for method Example.method\");\n }\n }\n\n @Test\n public void queryMapRejectsNullValues() {\n class Example {\n @GET(\"/\") //\n Call method(@QueryMap Map a) {\n return null;\n }\n }\n\n Map queryParams = new LinkedHashMap<>();\n queryParams.put(\"ping\", \"pong\");\n queryParams.put(\"kit\", null);\n\n try {\n buildRequest(Example.class, queryParams);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Query map contained null value for key 'kit'. (parameter 'a')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void getWithHeaderMap() {\n class Example {\n @GET(\"/search\")\n Call method(@HeaderMap Map headers) {\n return null;\n }\n }\n\n Map headers = new LinkedHashMap<>();\n headers.put(\"Accept\", \"text/plain\");\n headers.put(\"Accept-Charset\", \"utf-8\");\n\n Request request = buildRequest(Example.class, headers);\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/search\");\n assertThat(request.body()).isNull();\n assertThat(request.headers().size()).isEqualTo(2);\n assertThat(request.header(\"Accept\")).isEqualTo(\"text/plain\");\n assertThat(request.header(\"Accept-Charset\")).isEqualTo(\"utf-8\");\n }\n\n @Test\n public void headerMapMustBeAMapOrHeaders() {\n class Example {\n @GET(\"/\")\n Call method(\n @HeaderMap okhttp3.Headers headers, @HeaderMap List headerMap) {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@HeaderMap parameter type must be Map or Headers. (parameter 'headerMap')\\n for method Example.method\");\n }\n }\n\n @Test\n public void headerMapSupportsSubclasses() {\n class Foo extends HashMap {}\n\n class Example {\n @GET(\"/search\")\n Call method(@HeaderMap Foo headers) {\n return null;\n }\n }\n\n Foo headers = new Foo();\n headers.put(\"Accept\", \"text/plain\");\n\n Request request = buildRequest(Example.class, headers);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/search\");\n assertThat(request.headers().size()).isEqualTo(1);\n assertThat(request.header(\"Accept\")).isEqualTo(\"text/plain\");\n }\n\n @Test\n public void headerMapRejectsNull() {\n class Example {\n @GET(\"/\")\n Call method(@HeaderMap Map headers) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, (Map) null);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Header map was null. (parameter 'headers')\\n\" + \" for method Example.method\");\n }\n }\n\n @Test\n public void headerMapRejectsNullKeys() {\n class Example {\n @GET(\"/\")\n Call method(@HeaderMap Map headers) {\n return null;\n }\n }\n\n Map headers = new LinkedHashMap<>();\n headers.put(\"Accept\", \"text/plain\");\n headers.put(null, \"utf-8\");\n\n try {\n buildRequest(Example.class, headers);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Header map contained null key. (parameter 'headers')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void headerMapRejectsNullValues() {\n class Example {\n @GET(\"/\")\n Call method(@HeaderMap Map headers) {\n return null;\n }\n }\n\n Map headers = new LinkedHashMap<>();\n headers.put(\"Accept\", \"text/plain\");\n headers.put(\"Accept-Charset\", null);\n\n try {\n buildRequest(Example.class, headers);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Header map contained null value for key 'Accept-Charset'. (parameter 'headers')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void getWithHeaders() {\n class Example {\n @GET(\"/search\")\n Call method(@HeaderMap okhttp3.Headers headers) {\n throw new AssertionError();\n }\n }\n\n okhttp3.Headers headers =\n new okhttp3.Headers.Builder()\n .add(\"Accept\", \"text/plain\")\n .add(\"Accept\", \"application/json\")\n .add(\"Accept-Charset\", \"utf-8\")\n .build();\n\n Request request = buildRequest(Example.class, headers);\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/search\");\n assertThat(request.body()).isNull();\n assertThat(request.headers().size()).isEqualTo(3);\n assertThat(request.headers(\"Accept\")).isEqualTo(asList(\"text/plain\", \"application/json\"));\n assertThat(request.header(\"Accept-Charset\")).isEqualTo(\"utf-8\");\n }\n\n @Test\n public void getWithHeadersAndHeaderMap() {\n class Example {\n @GET(\"/search\")\n Call method(\n @HeaderMap okhttp3.Headers headers, @HeaderMap Map headerMap) {\n throw new AssertionError();\n }\n }\n\n okhttp3.Headers headers =\n new okhttp3.Headers.Builder()\n .add(\"Accept\", \"text/plain\")\n .add(\"Accept-Charset\", \"utf-8\")\n .build();\n Map headerMap = Collections.singletonMap(\"Accept\", \"application/json\");\n\n Request request = buildRequest(Example.class, headers, headerMap);\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/search\");\n assertThat(request.body()).isNull();\n assertThat(request.headers().size()).isEqualTo(3);\n assertThat(request.headers(\"Accept\")).isEqualTo(asList(\"text/plain\", \"application/json\"));\n assertThat(request.header(\"Accept-Charset\")).isEqualTo(\"utf-8\");\n }\n\n @Test\n public void headersRejectsNull() {\n class Example {\n @GET(\"/\")\n Call method(@HeaderMap okhttp3.Headers headers) {\n throw new AssertionError();\n }\n }\n\n try {\n buildRequest(Example.class, (okhttp3.Headers) null);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Headers parameter must not be null. (parameter 'headers')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void getWithHeaderMapAllowingUnsafeNonAsciiValues() {\n class Example {\n @GET(\"/search\")\n Call method(\n @HeaderMap(allowUnsafeNonAsciiValues = true) Map headers) {\n return null;\n }\n }\n\n Map headers = new LinkedHashMap<>();\n headers.put(\"Accept\", \"text/plain\");\n headers.put(\"Title\", \"Kein plötzliches\");\n\n Request request = buildRequest(Example.class, headers);\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/search\");\n assertThat(request.body()).isNull();\n assertThat(request.headers().size()).isEqualTo(2);\n assertThat(request.header(\"Accept\")).isEqualTo(\"text/plain\");\n assertThat(request.header(\"Title\")).isEqualTo(\"Kein plötzliches\");\n }\n\n @Test\n public void twoBodies() {\n class Example {\n @PUT(\"/\") //\n Call method(@Body String o1, @Body String o2) {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Multiple @Body method annotations found. (parameter 'o2')\\n for method Example.method\");\n }\n }\n\n @Test\n public void bodyInNonBodyRequest() {\n class Example {\n @Multipart //\n @PUT(\"/\") //\n Call method(@Part(\"one\") String o1, @Body String o2) {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Body parameters cannot be used with form or multi-part encoding. (parameter 'o2')\\n for method Example.method\");\n }\n }\n\n @Test\n public void get() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method() {\n return null;\n }\n }\n Request request = buildRequest(Example.class);\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void delete() {\n class Example {\n @DELETE(\"/foo/bar/\") //\n Call method() {\n return null;\n }\n }\n Request request = buildRequest(Example.class);\n assertThat(request.method()).isEqualTo(\"DELETE\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertNull(request.body());\n }\n\n @Test\n public void headVoid() {\n class Example {\n @HEAD(\"/foo/bar/\") //\n Call method() {\n return null;\n }\n }\n Request request = buildRequest(Example.class);\n assertThat(request.method()).isEqualTo(\"HEAD\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Ignore(\"This test is valid but isn't validated by RequestFactory so it needs moved\")\n @Test\n public void headWithoutVoidThrows() {\n class Example {\n @HEAD(\"/foo/bar/\") //\n Call method() {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"HEAD method must use Void or Unit as response type.\\n for method Example.method\");\n }\n }\n\n @Test\n public void post() {\n class Example {\n @POST(\"/foo/bar/\") //\n Call method(@Body RequestBody body) {\n return null;\n }\n }\n RequestBody body = RequestBody.create(TEXT_PLAIN, \"hi\");\n Request request = buildRequest(Example.class, body);\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertBody(request.body(), \"hi\");\n }\n\n @Test\n public void put() {\n class Example {\n @PUT(\"/foo/bar/\") //\n Call method(@Body RequestBody body) {\n return null;\n }\n }\n RequestBody body = RequestBody.create(TEXT_PLAIN, \"hi\");\n Request request = buildRequest(Example.class, body);\n assertThat(request.method()).isEqualTo(\"PUT\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertBody(request.body(), \"hi\");\n }\n\n @Test\n public void patch() {\n class Example {\n @PATCH(\"/foo/bar/\") //\n Call method(@Body RequestBody body) {\n return null;\n }\n }\n RequestBody body = RequestBody.create(TEXT_PLAIN, \"hi\");\n Request request = buildRequest(Example.class, body);\n assertThat(request.method()).isEqualTo(\"PATCH\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertBody(request.body(), \"hi\");\n }\n\n @Test\n public void options() {\n class Example {\n @OPTIONS(\"/foo/bar/\") //\n Call method() {\n return null;\n }\n }\n Request request = buildRequest(Example.class);\n assertThat(request.method()).isEqualTo(\"OPTIONS\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithPathParam() {\n class Example {\n @GET(\"/foo/bar/{ping}/\") //\n Call method(@Path(\"ping\") String ping) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"po ng\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/po%20ng/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithUnusedAndInvalidNamedPathParam() {\n class Example {\n @GET(\"/foo/bar/{ping}/{kit,kat}/\") //\n Call method(@Path(\"ping\") String ping) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"pong\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString())\n .isEqualTo(\"http://example.com/foo/bar/pong/%7Bkit,kat%7D/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithEncodedPathParam() {\n class Example {\n @GET(\"/foo/bar/{ping}/\") //\n Call method(@Path(value = \"ping\", encoded = true) String ping) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"po%20ng\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/po%20ng/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithEncodedPathSegments() {\n class Example {\n @GET(\"/foo/bar/{ping}/\") //\n Call method(@Path(value = \"ping\", encoded = true) String ping) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"baz/pong/more\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/baz/pong/more/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithUnencodedPathSegmentsPreventsRequestSplitting() {\n class Example {\n @GET(\"/foo/bar/{ping}/\") //\n Call method(@Path(value = \"ping\", encoded = false) String ping) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"baz/\\r\\nheader: blue\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString())\n .isEqualTo(\"http://example.com/foo/bar/baz%2F%0D%0Aheader:%20blue/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithEncodedPathStillPreventsRequestSplitting() {\n class Example {\n @GET(\"/foo/bar/{ping}/\") //\n Call method(@Path(value = \"ping\", encoded = true) String ping) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"baz/\\r\\npong\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/baz/pong/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void pathParametersAndPathTraversal() {\n class Example {\n @GET(\"/foo/bar/{ping}/\") //\n Call method(@Path(value = \"ping\") String ping) {\n return null;\n }\n }\n\n assertMalformedRequest(Example.class, \".\");\n assertMalformedRequest(Example.class, \"..\");\n\n assertThat(buildRequest(Example.class, \"./a\").url().encodedPath()).isEqualTo(\"/foo/bar/.%2Fa/\");\n assertThat(buildRequest(Example.class, \"a/.\").url().encodedPath()).isEqualTo(\"/foo/bar/a%2F./\");\n assertThat(buildRequest(Example.class, \"a/..\").url().encodedPath())\n .isEqualTo(\"/foo/bar/a%2F../\");\n assertThat(buildRequest(Example.class, \"../a\").url().encodedPath())\n .isEqualTo(\"/foo/bar/..%2Fa/\");\n assertThat(buildRequest(Example.class, \"..\\\\..\").url().encodedPath())\n .isEqualTo(\"/foo/bar/..%5C../\");\n\n assertThat(buildRequest(Example.class, \"%2E\").url().encodedPath()).isEqualTo(\"/foo/bar/%252E/\");\n assertThat(buildRequest(Example.class, \"%2E%2E\").url().encodedPath())\n .isEqualTo(\"/foo/bar/%252E%252E/\");\n }\n\n @Test\n public void encodedPathParametersAndPathTraversal() {\n class Example {\n @GET(\"/foo/bar/{ping}/\") //\n Call method(@Path(value = \"ping\", encoded = true) String ping) {\n return null;\n }\n }\n\n assertMalformedRequest(Example.class, \".\");\n assertMalformedRequest(Example.class, \"%2E\");\n assertMalformedRequest(Example.class, \"%2e\");\n assertMalformedRequest(Example.class, \"..\");\n assertMalformedRequest(Example.class, \"%2E.\");\n assertMalformedRequest(Example.class, \"%2e.\");\n assertMalformedRequest(Example.class, \".%2E\");\n assertMalformedRequest(Example.class, \".%2e\");\n assertMalformedRequest(Example.class, \"%2E%2e\");\n assertMalformedRequest(Example.class, \"%2e%2E\");\n assertMalformedRequest(Example.class, \"./a\");\n assertMalformedRequest(Example.class, \"a/.\");\n assertMalformedRequest(Example.class, \"../a\");\n assertMalformedRequest(Example.class, \"a/..\");\n assertMalformedRequest(Example.class, \"a/../b\");\n assertMalformedRequest(Example.class, \"a/%2e%2E/b\");\n\n assertThat(buildRequest(Example.class, \"...\").url().encodedPath()).isEqualTo(\"/foo/bar/.../\");\n assertThat(buildRequest(Example.class, \"a..b\").url().encodedPath()).isEqualTo(\"/foo/bar/a..b/\");\n assertThat(buildRequest(Example.class, \"a..\").url().encodedPath()).isEqualTo(\"/foo/bar/a../\");\n assertThat(buildRequest(Example.class, \"a..b\").url().encodedPath()).isEqualTo(\"/foo/bar/a..b/\");\n assertThat(buildRequest(Example.class, \"..b\").url().encodedPath()).isEqualTo(\"/foo/bar/..b/\");\n assertThat(buildRequest(Example.class, \"..\\\\..\").url().encodedPath())\n .isEqualTo(\"/foo/bar/..%5C../\");\n }\n\n @Test\n public void dotDotsOkayWhenNotFullPathSegment() {\n class Example {\n @GET(\"/foo{ping}bar/\") //\n Call method(@Path(value = \"ping\", encoded = true) String ping) {\n return null;\n }\n }\n\n assertMalformedRequest(Example.class, \"/./\");\n assertMalformedRequest(Example.class, \"/../\");\n\n assertThat(buildRequest(Example.class, \".\").url().encodedPath()).isEqualTo(\"/foo.bar/\");\n assertThat(buildRequest(Example.class, \"..\").url().encodedPath()).isEqualTo(\"/foo..bar/\");\n }\n\n @Test\n public void pathParamRequired() {\n class Example {\n @GET(\"/foo/bar/{ping}/\") //\n Call method(@Path(\"ping\") String ping) {\n return null;\n }\n }\n try {\n buildRequest(Example.class, new Object[] {null});\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e.getMessage())\n .isEqualTo(\n \"Path parameter \\\"ping\\\" value must not be null. (parameter 'ping')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void getWithQueryParam() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@Query(\"ping\") String ping) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"pong\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/?ping=pong\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithEncodedQueryParam() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@Query(value = \"pi%20ng\", encoded = true) String ping) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"p%20o%20n%20g\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString())\n .isEqualTo(\"http://example.com/foo/bar/?pi%20ng=p%20o%20n%20g\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void queryParamOptionalOmitsQuery() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@Query(\"ping\") String ping) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, new Object[] {null});\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n }\n\n @Test\n public void queryParamOptional() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(\n @Query(\"foo\") String foo, @Query(\"ping\") String ping, @Query(\"kit\") String kit) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"bar\", null, \"kat\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/?foo=bar&kit=kat\");\n }\n\n @Test\n public void getWithQueryUrlAndParam() {\n class Example {\n @GET(\"/foo/bar/?hi=mom\") //\n Call method(@Query(\"ping\") String ping) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"pong\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/?hi=mom&ping=pong\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithQuery() {\n class Example {\n @GET(\"/foo/bar/?hi=mom\") //\n Call method() {\n return null;\n }\n }\n Request request = buildRequest(Example.class);\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/?hi=mom\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithPathAndQueryParam() {\n class Example {\n @GET(\"/foo/bar/{ping}/\") //\n Call method(\n @Path(\"ping\") String ping, @Query(\"kit\") String kit, @Query(\"riff\") String riff) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, \"pong\", \"kat\", \"raff\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString())\n .isEqualTo(\"http://example.com/foo/bar/pong/?kit=kat&riff=raff\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithQueryThenPathThrows() {\n class Example {\n @GET(\"/foo/bar/{ping}/\") //\n Call method(@Query(\"kit\") String kit, @Path(\"ping\") String ping) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, \"kat\", \"pong\");\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"A @Path parameter must not come after a @Query. (parameter 'ping')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void getWithQueryNameThenPathThrows() {\n class Example {\n @GET(\"/foo/bar/{ping}/\") //\n Call method(@QueryName String kit, @Path(\"ping\") String ping) {\n throw new AssertionError();\n }\n }\n\n try {\n buildRequest(Example.class, \"kat\", \"pong\");\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"A @Path parameter must not come after a @QueryName. (parameter 'ping')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void getWithQueryMapThenPathThrows() {\n class Example {\n @GET(\"/foo/bar/{ping}/\") //\n Call method(@QueryMap Map queries, @Path(\"ping\") String ping) {\n throw new AssertionError();\n }\n }\n\n try {\n buildRequest(Example.class, Collections.singletonMap(\"kit\", \"kat\"), \"pong\");\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"A @Path parameter must not come after a @QueryMap. (parameter 'ping')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void getWithPathAndQueryQuestionMarkParam() {\n class Example {\n @GET(\"/foo/bar/{ping}/\") //\n Call method(@Path(\"ping\") String ping, @Query(\"kit\") String kit) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, \"pong?\", \"kat?\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString())\n .isEqualTo(\"http://example.com/foo/bar/pong%3F/?kit=kat%3F\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithPathAndQueryAmpersandParam() {\n class Example {\n @GET(\"/foo/bar/{ping}/\") //\n Call method(@Path(\"ping\") String ping, @Query(\"kit\") String kit) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, \"pong&\", \"kat&\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/pong&/?kit=kat%26\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithPathAndQueryHashParam() {\n class Example {\n @GET(\"/foo/bar/{ping}/\") //\n Call method(@Path(\"ping\") String ping, @Query(\"kit\") String kit) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, \"pong#\", \"kat#\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString())\n .isEqualTo(\"http://example.com/foo/bar/pong%23/?kit=kat%23\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithQueryParamList() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@Query(\"key\") List keys) {\n return null;\n }\n }\n\n List values = Arrays.asList(1, 2, null, \"three\", \"1\");\n Request request = buildRequest(Example.class, values);\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString())\n .isEqualTo(\"http://example.com/foo/bar/?key=1&key=2&key=three&key=1\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithQueryParamArray() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@Query(\"key\") Object[] keys) {\n return null;\n }\n }\n\n Object[] values = {1, 2, null, \"three\", \"1\"};\n Request request = buildRequest(Example.class, new Object[] {values});\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString())\n .isEqualTo(\"http://example.com/foo/bar/?key=1&key=2&key=three&key=1\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithQueryParamPrimitiveArray() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@Query(\"key\") int[] keys) {\n return null;\n }\n }\n\n int[] values = {1, 2, 3, 1};\n Request request = buildRequest(Example.class, new Object[] {values});\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString())\n .isEqualTo(\"http://example.com/foo/bar/?key=1&key=2&key=3&key=1\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithQueryNameParam() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@QueryName String ping) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"pong\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/?pong\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithEncodedQueryNameParam() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@QueryName(encoded = true) String ping) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"p%20o%20n%20g\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/?p%20o%20n%20g\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void queryNameParamOptionalOmitsQuery() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@QueryName String ping) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, new Object[] {null});\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n }\n\n @Test\n public void getWithQueryNameParamList() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@QueryName List keys) {\n return null;\n }\n }\n\n List values = Arrays.asList(1, 2, null, \"three\", \"1\");\n Request request = buildRequest(Example.class, values);\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/?1&2&three&1\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithQueryNameParamArray() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@QueryName Object[] keys) {\n return null;\n }\n }\n\n Object[] values = {1, 2, null, \"three\", \"1\"};\n Request request = buildRequest(Example.class, new Object[] {values});\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/?1&2&three&1\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithQueryNameParamPrimitiveArray() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@QueryName int[] keys) {\n return null;\n }\n }\n\n int[] values = {1, 2, 3, 1};\n Request request = buildRequest(Example.class, new Object[] {values});\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/?1&2&3&1\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithQueryParamMap() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@QueryMap Map query) {\n return null;\n }\n }\n\n Map params = new LinkedHashMap<>();\n params.put(\"kit\", \"kat\");\n params.put(\"ping\", \"pong\");\n\n Request request = buildRequest(Example.class, params);\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/?kit=kat&ping=pong\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithEncodedQueryParamMap() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@QueryMap(encoded = true) Map query) {\n return null;\n }\n }\n\n Map params = new LinkedHashMap<>();\n params.put(\"kit\", \"k%20t\");\n params.put(\"pi%20ng\", \"p%20g\");\n\n Request request = buildRequest(Example.class, params);\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString())\n .isEqualTo(\"http://example.com/foo/bar/?kit=k%20t&pi%20ng=p%20g\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getAbsoluteUrl() {\n class Example {\n @GET(\"http://example2.com/foo/bar/\")\n Call method() {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class);\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example2.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithStringUrl() {\n class Example {\n @GET\n Call method(@Url String url) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, \"foo/bar/\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithJavaUriUrl() {\n class Example {\n @GET\n Call method(@Url URI url) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, URI.create(\"foo/bar/\"));\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithStringUrlAbsolute() {\n class Example {\n @GET\n Call method(@Url String url) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, \"https://example2.com/foo/bar/\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"https://example2.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithJavaUriUrlAbsolute() {\n class Example {\n @GET\n Call method(@Url URI url) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, URI.create(\"https://example2.com/foo/bar/\"));\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"https://example2.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithUrlAbsoluteSameHost() {\n class Example {\n @GET\n Call method(@Url String url) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, \"http://example.com/foo/bar/\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithHttpUrl() {\n class Example {\n @GET\n Call method(@Url HttpUrl url) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, HttpUrl.get(\"http://example.com/foo/bar/\"));\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url()).isEqualTo(HttpUrl.get(\"http://example.com/foo/bar/\"));\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void getWithNullUrl() {\n class Example {\n @GET\n Call method(@Url HttpUrl url) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, (HttpUrl) null);\n fail();\n } catch (IllegalArgumentException expected) {\n assertThat(expected)\n .hasMessageThat()\n .isEqualTo(\n \"@Url parameter is null. (parameter 'url')\\n\" + \" for method Example.method\");\n }\n }\n\n @Test\n public void getWithNonStringUrlThrows() {\n class Example {\n @GET\n Call method(@Url Object url) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, \"foo/bar\");\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Url must be okhttp3.HttpUrl, String, java.net.URI, or android.net.Uri type.\"\n + \" (parameter 'url')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void getUrlAndUrlParamThrows() {\n class Example {\n @GET(\"foo/bar\")\n Call method(@Url Object url) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, \"foo/bar\");\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Url cannot be used with @GET URL (parameter 'url')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void getWithoutUrlThrows() {\n class Example {\n @GET\n Call method() {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Missing either @GET URL or @Url parameter.\\n\" + \" for method Example.method\");\n }\n }\n\n @Test\n public void getWithUrlThenPathThrows() {\n class Example {\n @GET\n Call method(@Url String url, @Path(\"hey\") String hey) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, \"foo/bar\");\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Path parameters may not be used with @Url. (parameter 'hey')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void getWithPathThenUrlThrows() {\n class Example {\n @GET\n Call method(@Path(\"hey\") String hey, @Url Object url) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, \"foo/bar\");\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Path can only be used with relative url on @GET (parameter 'hey')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void getWithQueryThenUrlThrows() {\n class Example {\n @GET(\"foo/bar\")\n Call method(@Query(\"hey\") String hey, @Url Object url) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, \"hey\", \"foo/bar/\");\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"A @Url parameter must not come after a @Query. (parameter 'url')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void getWithQueryNameThenUrlThrows() {\n class Example {\n @GET\n Call method(@QueryName String name, @Url String url) {\n throw new AssertionError();\n }\n }\n\n try {\n buildRequest(Example.class, Collections.singletonMap(\"kit\", \"kat\"), \"foo/bar/\");\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"A @Url parameter must not come after a @QueryName. (parameter 'url')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void getWithQueryMapThenUrlThrows() {\n class Example {\n @GET\n Call method(@QueryMap Map queries, @Url String url) {\n throw new AssertionError();\n }\n }\n\n try {\n buildRequest(Example.class, Collections.singletonMap(\"kit\", \"kat\"), \"foo/bar/\");\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"A @Url parameter must not come after a @QueryMap. (parameter 'url')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void getWithUrlThenQuery() {\n class Example {\n @GET\n Call method(@Url String url, @Query(\"hey\") String hey) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, \"foo/bar/\", \"hey!\");\n assertThat(request.method()).isEqualTo(\"GET\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/?hey=hey%21\");\n }\n\n @Test\n public void postWithUrl() {\n class Example {\n @POST\n Call method(@Url String url, @Body RequestBody body) {\n return null;\n }\n }\n RequestBody body = RequestBody.create(TEXT_PLAIN, \"hi\");\n Request request = buildRequest(Example.class, \"http://example.com/foo/bar\", body);\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar\");\n assertBody(request.body(), \"hi\");\n }\n\n @Test\n public void normalPostWithPathParam() {\n class Example {\n @POST(\"/foo/bar/{ping}/\") //\n Call method(@Path(\"ping\") String ping, @Body RequestBody body) {\n return null;\n }\n }\n RequestBody body = RequestBody.create(TEXT_PLAIN, \"Hi!\");\n Request request = buildRequest(Example.class, \"pong\", body);\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/pong/\");\n assertBody(request.body(), \"Hi!\");\n }\n\n @Test\n public void emptyBody() {\n class Example {\n @POST(\"/foo/bar/\") //\n Call method() {\n return null;\n }\n }\n Request request = buildRequest(Example.class);\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertBody(request.body(), \"\");\n }\n\n @Test\n public void customMethodEmptyBody() {\n class Example {\n @HTTP(method = \"CUSTOM\", path = \"/foo/bar/\", hasBody = true) //\n Call method() {\n return null;\n }\n }\n Request request = buildRequest(Example.class);\n assertThat(request.method()).isEqualTo(\"CUSTOM\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertBody(request.body(), \"\");\n }\n\n @Test\n public void bodyRequired() {\n class Example {\n @POST(\"/foo/bar/\") //\n Call method(@Body RequestBody body) {\n return null;\n }\n }\n try {\n buildRequest(Example.class, new Object[] {null});\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e.getMessage())\n .isEqualTo(\n \"Body parameter value must not be null. (parameter 'body')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void bodyWithPathParams() {\n class Example {\n @POST(\"/foo/bar/{ping}/{kit}/\") //\n Call method(\n @Path(\"ping\") String ping, @Body RequestBody body, @Path(\"kit\") String kit) {\n return null;\n }\n }\n RequestBody body = RequestBody.create(TEXT_PLAIN, \"Hi!\");\n Request request = buildRequest(Example.class, \"pong\", body, \"kat\");\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/pong/kat/\");\n assertBody(request.body(), \"Hi!\");\n }\n\n @Test\n public void simpleMultipart() throws IOException {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@Part(\"ping\") String ping, @Part(\"kit\") RequestBody kit) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, \"pong\", RequestBody.create(TEXT_PLAIN, \"kat\"));\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n\n RequestBody body = request.body();\n assertThat(body.contentType().toString()).startsWith(\"multipart/form-data; boundary=\");\n\n Buffer buffer = new Buffer();\n body.writeTo(buffer);\n String bodyString = buffer.readUtf8();\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"ping\\\"\\r\\n\");\n assertThat(bodyString).contains(\"\\r\\npong\\r\\n--\");\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"kit\\\"\");\n assertThat(bodyString).contains(\"\\r\\nkat\\r\\n--\");\n }\n\n @Test\n public void multipartArray() throws IOException {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@Part(\"ping\") String[] ping) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, new Object[] {new String[] {\"pong1\", \"pong2\"}});\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n\n RequestBody body = request.body();\n Buffer buffer = new Buffer();\n body.writeTo(buffer);\n String bodyString = buffer.readUtf8();\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"ping\\\"\\r\\n\");\n assertThat(bodyString).contains(\"\\r\\npong1\\r\\n--\");\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"ping\\\"\");\n assertThat(bodyString).contains(\"\\r\\npong2\\r\\n--\");\n }\n\n @Test\n public void multipartRequiresName() {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@Part RequestBody part) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, new Object[] {null});\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Part annotation must supply a name or use MultipartBody.Part parameter type. (parameter 'part')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void multipartIterableRequiresName() {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@Part List part) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, new Object[] {null});\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Part annotation must supply a name or use MultipartBody.Part parameter type. (parameter 'part')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void multipartArrayRequiresName() {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@Part RequestBody[] part) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, new Object[] {null});\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Part annotation must supply a name or use MultipartBody.Part parameter type. (parameter 'part')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void multipartOkHttpPartForbidsName() {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@Part(\"name\") MultipartBody.Part part) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, new Object[] {null});\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Part parameters using the MultipartBody.Part must not include a part name in the annotation. (parameter 'part')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void multipartOkHttpPart() throws IOException {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@Part MultipartBody.Part part) {\n return null;\n }\n }\n\n MultipartBody.Part part = MultipartBody.Part.createFormData(\"kit\", \"kat\");\n Request request = buildRequest(Example.class, part);\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n\n RequestBody body = request.body();\n Buffer buffer = new Buffer();\n body.writeTo(buffer);\n String bodyString = buffer.readUtf8();\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"kit\\\"\\r\\n\");\n assertThat(bodyString).contains(\"\\r\\nkat\\r\\n--\");\n }\n\n @Test\n public void multipartOkHttpIterablePart() throws IOException {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@Part List part) {\n return null;\n }\n }\n\n MultipartBody.Part part1 = MultipartBody.Part.createFormData(\"foo\", \"bar\");\n MultipartBody.Part part2 = MultipartBody.Part.createFormData(\"kit\", \"kat\");\n Request request = buildRequest(Example.class, asList(part1, part2));\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n\n RequestBody body = request.body();\n Buffer buffer = new Buffer();\n body.writeTo(buffer);\n String bodyString = buffer.readUtf8();\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"foo\\\"\\r\\n\");\n assertThat(bodyString).contains(\"\\r\\nbar\\r\\n--\");\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"kit\\\"\\r\\n\");\n assertThat(bodyString).contains(\"\\r\\nkat\\r\\n--\");\n }\n\n @Test\n public void multipartOkHttpArrayPart() throws IOException {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@Part MultipartBody.Part[] part) {\n return null;\n }\n }\n\n MultipartBody.Part part1 = MultipartBody.Part.createFormData(\"foo\", \"bar\");\n MultipartBody.Part part2 = MultipartBody.Part.createFormData(\"kit\", \"kat\");\n Request request =\n buildRequest(Example.class, new Object[] {new MultipartBody.Part[] {part1, part2}});\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n\n RequestBody body = request.body();\n Buffer buffer = new Buffer();\n body.writeTo(buffer);\n String bodyString = buffer.readUtf8();\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"foo\\\"\\r\\n\");\n assertThat(bodyString).contains(\"\\r\\nbar\\r\\n--\");\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"kit\\\"\\r\\n\");\n assertThat(bodyString).contains(\"\\r\\nkat\\r\\n--\");\n }\n\n @Test\n public void multipartOkHttpPartWithFilename() throws IOException {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@Part MultipartBody.Part part) {\n return null;\n }\n }\n\n MultipartBody.Part part =\n MultipartBody.Part.createFormData(\"kit\", \"kit.txt\", RequestBody.create(null, \"kat\"));\n Request request = buildRequest(Example.class, part);\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n\n RequestBody body = request.body();\n Buffer buffer = new Buffer();\n body.writeTo(buffer);\n String bodyString = buffer.readUtf8();\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"kit\\\"; filename=\\\"kit.txt\\\"\\r\\n\");\n assertThat(bodyString).contains(\"\\r\\nkat\\r\\n--\");\n }\n\n @Test\n public void multipartIterable() throws IOException {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@Part(\"ping\") List ping) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, asList(\"pong1\", \"pong2\"));\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n\n RequestBody body = request.body();\n Buffer buffer = new Buffer();\n body.writeTo(buffer);\n String bodyString = buffer.readUtf8();\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"ping\\\"\\r\\n\");\n assertThat(bodyString).contains(\"\\r\\npong1\\r\\n--\");\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"ping\\\"\");\n assertThat(bodyString).contains(\"\\r\\npong2\\r\\n--\");\n }\n\n @Test\n public void multipartIterableOkHttpPart() {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@Part(\"ping\") List part) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, new Object[] {null});\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Part parameters using the MultipartBody.Part must not include a part name in the annotation. (parameter 'part')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void multipartArrayOkHttpPart() {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@Part(\"ping\") MultipartBody.Part[] part) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, new Object[] {null});\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Part parameters using the MultipartBody.Part must not include a part name in the annotation. (parameter 'part')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void multipartWithEncoding() throws IOException {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(\n @Part(value = \"ping\", encoding = \"8-bit\") String ping,\n @Part(value = \"kit\", encoding = \"7-bit\") RequestBody kit) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, \"pong\", RequestBody.create(TEXT_PLAIN, \"kat\"));\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n\n RequestBody body = request.body();\n Buffer buffer = new Buffer();\n body.writeTo(buffer);\n String bodyString = buffer.readUtf8();\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"ping\\\"\\r\\n\");\n assertThat(bodyString).contains(\"Content-Transfer-Encoding: 8-bit\");\n assertThat(bodyString).contains(\"\\r\\npong\\r\\n--\");\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"kit\\\"\");\n assertThat(bodyString).contains(\"Content-Transfer-Encoding: 7-bit\");\n assertThat(bodyString).contains(\"\\r\\nkat\\r\\n--\");\n }\n\n @Test\n public void multipartPartMap() throws IOException {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@PartMap Map parts) {\n return null;\n }\n }\n\n Map params = new LinkedHashMap<>();\n params.put(\"ping\", RequestBody.create(null, \"pong\"));\n params.put(\"kit\", RequestBody.create(null, \"kat\"));\n\n Request request = buildRequest(Example.class, params);\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n\n RequestBody body = request.body();\n Buffer buffer = new Buffer();\n body.writeTo(buffer);\n String bodyString = buffer.readUtf8();\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"ping\\\"\\r\\n\");\n assertThat(bodyString).contains(\"\\r\\npong\\r\\n--\");\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"kit\\\"\");\n assertThat(bodyString).contains(\"\\r\\nkat\\r\\n--\");\n }\n\n @Test\n public void multipartPartMapWithEncoding() throws IOException {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@PartMap(encoding = \"8-bit\") Map parts) {\n return null;\n }\n }\n\n Map params = new LinkedHashMap<>();\n params.put(\"ping\", RequestBody.create(null, \"pong\"));\n params.put(\"kit\", RequestBody.create(null, \"kat\"));\n\n Request request = buildRequest(Example.class, params);\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n\n RequestBody body = request.body();\n Buffer buffer = new Buffer();\n body.writeTo(buffer);\n String bodyString = buffer.readUtf8();\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"ping\\\"\\r\\n\");\n assertThat(bodyString).contains(\"Content-Transfer-Encoding: 8-bit\");\n assertThat(bodyString).contains(\"\\r\\npong\\r\\n--\");\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"kit\\\"\");\n assertThat(bodyString).contains(\"Content-Transfer-Encoding: 8-bit\");\n assertThat(bodyString).contains(\"\\r\\nkat\\r\\n--\");\n }\n\n @Test\n public void multipartPartMapRejectsNonStringKeys() {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@PartMap Map parts) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, new Object[] {null});\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@PartMap keys must be of type String: class java.lang.Object (parameter 'parts')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void multipartPartMapRejectsOkHttpPartValues() {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@PartMap Map parts) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, new Object[] {null});\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@PartMap values cannot be MultipartBody.Part. Use @Part List or a different value type instead. (parameter 'parts')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void multipartPartMapRejectsNull() {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@PartMap Map parts) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, new Object[] {null});\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Part map was null. (parameter 'parts')\\n\" + \" for method Example.method\");\n }\n }\n\n @Test\n public void multipartPartMapRejectsNullKeys() {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@PartMap Map parts) {\n return null;\n }\n }\n\n Map params = new LinkedHashMap<>();\n params.put(\"ping\", RequestBody.create(null, \"pong\"));\n params.put(null, RequestBody.create(null, \"kat\"));\n\n try {\n buildRequest(Example.class, params);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Part map contained null key. (parameter 'parts')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void multipartPartMapRejectsNullValues() {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@PartMap Map parts) {\n return null;\n }\n }\n\n Map params = new LinkedHashMap<>();\n params.put(\"ping\", RequestBody.create(null, \"pong\"));\n params.put(\"kit\", null);\n\n try {\n buildRequest(Example.class, params);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Part map contained null value for key 'kit'. (parameter 'parts')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void multipartPartMapMustBeMap() {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@PartMap List parts) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, emptyList());\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@PartMap parameter type must be Map. (parameter 'parts')\\n for method Example.method\");\n }\n }\n\n @Test\n public void multipartPartMapSupportsSubclasses() throws IOException {\n class Foo extends HashMap {}\n\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@PartMap Foo parts) {\n return null;\n }\n }\n\n Foo foo = new Foo();\n foo.put(\"hello\", \"world\");\n\n Request request = buildRequest(Example.class, foo);\n Buffer buffer = new Buffer();\n request.body().writeTo(buffer);\n String bodyString = buffer.readUtf8();\n\n assertThat(bodyString).contains(\"name=\\\"hello\\\"\");\n assertThat(bodyString).contains(\"\\r\\n\\r\\nworld\\r\\n--\");\n }\n\n @Test\n public void multipartNullRemovesPart() throws IOException {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@Part(\"ping\") String ping, @Part(\"fizz\") String fizz) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"pong\", null);\n assertThat(request.method()).isEqualTo(\"POST\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n\n RequestBody body = request.body();\n Buffer buffer = new Buffer();\n body.writeTo(buffer);\n String bodyString = buffer.readUtf8();\n\n assertThat(bodyString).contains(\"Content-Disposition: form-data;\");\n assertThat(bodyString).contains(\"name=\\\"ping\\\"\");\n assertThat(bodyString).contains(\"\\r\\npong\\r\\n--\");\n }\n\n @Test\n public void multipartPartOptional() {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n Call method(@Part(\"ping\") RequestBody ping) {\n return null;\n }\n }\n try {\n buildRequest(Example.class, new Object[] {null});\n fail();\n } catch (IllegalStateException e) {\n assertThat(e.getMessage()).isEqualTo(\"Multipart body must have at least one part.\");\n }\n }\n\n @Test\n public void simpleFormEncoded() {\n class Example {\n @FormUrlEncoded //\n @POST(\"/foo\") //\n Call method(@Field(\"foo\") String foo, @Field(\"ping\") String ping) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"bar\", \"pong\");\n RequestBody body = request.body();\n assertBody(body, \"foo=bar&ping=pong\");\n assertThat(body.contentType().toString()).isEqualTo(\"application/x-www-form-urlencoded\");\n }\n\n @Test\n public void formEncodedWithEncodedNameFieldParam() {\n class Example {\n @FormUrlEncoded //\n @POST(\"/foo\") //\n Call method(@Field(value = \"na%20me\", encoded = true) String foo) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"ba%20r\");\n assertBody(request.body(), \"na%20me=ba%20r\");\n }\n\n @Test\n public void formEncodedFieldOptional() {\n class Example {\n @FormUrlEncoded //\n @POST(\"/foo\") //\n Call method(\n @Field(\"foo\") String foo, @Field(\"ping\") String ping, @Field(\"kit\") String kit) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"bar\", null, \"kat\");\n assertBody(request.body(), \"foo=bar&kit=kat\");\n }\n\n @Test\n public void formEncodedFieldList() {\n class Example {\n @FormUrlEncoded //\n @POST(\"/foo\") //\n Call method(@Field(\"foo\") List fields, @Field(\"kit\") String kit) {\n return null;\n }\n }\n\n List values = Arrays.asList(\"foo\", \"bar\", null, 3);\n Request request = buildRequest(Example.class, values, \"kat\");\n assertBody(request.body(), \"foo=foo&foo=bar&foo=3&kit=kat\");\n }\n\n @Test\n public void formEncodedFieldArray() {\n class Example {\n @FormUrlEncoded //\n @POST(\"/foo\") //\n Call method(@Field(\"foo\") Object[] fields, @Field(\"kit\") String kit) {\n return null;\n }\n }\n\n Object[] values = {1, 2, null, \"three\"};\n Request request = buildRequest(Example.class, values, \"kat\");\n assertBody(request.body(), \"foo=1&foo=2&foo=three&kit=kat\");\n }\n\n @Test\n public void formEncodedFieldPrimitiveArray() {\n class Example {\n @FormUrlEncoded //\n @POST(\"/foo\") //\n Call method(@Field(\"foo\") int[] fields, @Field(\"kit\") String kit) {\n return null;\n }\n }\n\n int[] values = {1, 2, 3};\n Request request = buildRequest(Example.class, values, \"kat\");\n assertBody(request.body(), \"foo=1&foo=2&foo=3&kit=kat\");\n }\n\n @Test\n public void formEncodedWithEncodedNameFieldParamMap() {\n class Example {\n @FormUrlEncoded //\n @POST(\"/foo\") //\n Call method(@FieldMap(encoded = true) Map fieldMap) {\n return null;\n }\n }\n\n Map fieldMap = new LinkedHashMap<>();\n fieldMap.put(\"k%20it\", \"k%20at\");\n fieldMap.put(\"pin%20g\", \"po%20ng\");\n\n Request request = buildRequest(Example.class, fieldMap);\n assertBody(request.body(), \"k%20it=k%20at&pin%20g=po%20ng\");\n }\n\n @Test\n public void formEncodedFieldMap() {\n class Example {\n @FormUrlEncoded //\n @POST(\"/foo\") //\n Call method(@FieldMap Map fieldMap) {\n return null;\n }\n }\n\n Map fieldMap = new LinkedHashMap<>();\n fieldMap.put(\"kit\", \"kat\");\n fieldMap.put(\"ping\", \"pong\");\n\n Request request = buildRequest(Example.class, fieldMap);\n assertBody(request.body(), \"kit=kat&ping=pong\");\n }\n\n @Test\n public void fieldMapRejectsNull() {\n class Example {\n @FormUrlEncoded //\n @POST(\"/\") //\n Call method(@FieldMap Map a) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, new Object[] {null});\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Field map was null. (parameter 'a')\\n\" + \" for method Example.method\");\n }\n }\n\n @Test\n public void fieldMapRejectsNullKeys() {\n class Example {\n @FormUrlEncoded //\n @POST(\"/\") //\n Call method(@FieldMap Map a) {\n return null;\n }\n }\n\n Map fieldMap = new LinkedHashMap<>();\n fieldMap.put(\"kit\", \"kat\");\n fieldMap.put(null, \"pong\");\n\n try {\n buildRequest(Example.class, fieldMap);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Field map contained null key. (parameter 'a')\\n\" + \" for method Example.method\");\n }\n }\n\n @Test\n public void fieldMapRejectsNullValues() {\n class Example {\n @FormUrlEncoded //\n @POST(\"/\") //\n Call method(@FieldMap Map a) {\n return null;\n }\n }\n\n Map fieldMap = new LinkedHashMap<>();\n fieldMap.put(\"kit\", \"kat\");\n fieldMap.put(\"foo\", null);\n\n try {\n buildRequest(Example.class, fieldMap);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Field map contained null value for key 'foo'. (parameter 'a')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void fieldMapMustBeAMap() {\n class Example {\n @FormUrlEncoded //\n @POST(\"/\") //\n Call method(@FieldMap List a) {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@FieldMap parameter type must be Map. (parameter 'a')\\n for method Example.method\");\n }\n }\n\n @Test\n public void fieldMapSupportsSubclasses() throws IOException {\n class Foo extends HashMap {}\n\n class Example {\n @FormUrlEncoded //\n @POST(\"/\") //\n Call method(@FieldMap Foo a) {\n return null;\n }\n }\n\n Foo foo = new Foo();\n foo.put(\"hello\", \"world\");\n\n Request request = buildRequest(Example.class, foo);\n Buffer buffer = new Buffer();\n request.body().writeTo(buffer);\n assertThat(buffer.readUtf8()).isEqualTo(\"hello=world\");\n }\n\n @Test\n public void simpleHeaders() {\n class Example {\n @GET(\"/foo/bar/\")\n @Headers({\"ping: pong\", \"kit: kat\"})\n Call method() {\n return null;\n }\n }\n Request request = buildRequest(Example.class);\n assertThat(request.method()).isEqualTo(\"GET\");\n okhttp3.Headers headers = request.headers();\n assertThat(headers.size()).isEqualTo(2);\n assertThat(headers.get(\"ping\")).isEqualTo(\"pong\");\n assertThat(headers.get(\"kit\")).isEqualTo(\"kat\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void simpleHeadersAllowingUnsafeNonAsciiValues() {\n class Example {\n @GET(\"/foo/bar/\")\n @Headers(\n value = {\"ping: pong\", \"title: Kein plötzliches\"},\n allowUnsafeNonAsciiValues = true)\n Call method() {\n return null;\n }\n }\n Request request = buildRequest(Example.class);\n assertThat(request.method()).isEqualTo(\"GET\");\n okhttp3.Headers headers = request.headers();\n assertThat(headers.size()).isEqualTo(2);\n assertThat(headers.get(\"ping\")).isEqualTo(\"pong\");\n assertThat(headers.get(\"title\")).isEqualTo(\"Kein plötzliches\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void headersDoNotOverwriteEachOther() {\n class Example {\n @GET(\"/foo/bar/\")\n @Headers({\n \"ping: pong\",\n \"kit: kat\",\n \"kit: -kat\",\n })\n Call method() {\n return null;\n }\n }\n Request request = buildRequest(Example.class);\n assertThat(request.method()).isEqualTo(\"GET\");\n okhttp3.Headers headers = request.headers();\n assertThat(headers.size()).isEqualTo(3);\n assertThat(headers.get(\"ping\")).isEqualTo(\"pong\");\n assertThat(headers.values(\"kit\")).containsExactly(\"kat\", \"-kat\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void headerParamToString() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@Header(\"kit\") BigInteger kit) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, new BigInteger(\"1234\"));\n assertThat(request.method()).isEqualTo(\"GET\");\n okhttp3.Headers headers = request.headers();\n assertThat(headers.size()).isEqualTo(1);\n assertThat(headers.get(\"kit\")).isEqualTo(\"1234\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void headerParam() {\n class Example {\n @GET(\"/foo/bar/\") //\n @Headers(\"ping: pong\") //\n Call method(@Header(\"kit\") String kit) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"kat\");\n assertThat(request.method()).isEqualTo(\"GET\");\n okhttp3.Headers headers = request.headers();\n assertThat(headers.size()).isEqualTo(2);\n assertThat(headers.get(\"ping\")).isEqualTo(\"pong\");\n assertThat(headers.get(\"kit\")).isEqualTo(\"kat\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void headerParamAllowingUnsafeNonAsciiValues() {\n class Example {\n @GET(\"/foo/bar/\") //\n @Headers(\"ping: pong\") //\n Call method(\n @Header(value = \"title\", allowUnsafeNonAsciiValues = true) String kit) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"Kein plötzliches\");\n assertThat(request.method()).isEqualTo(\"GET\");\n okhttp3.Headers headers = request.headers();\n assertThat(headers.size()).isEqualTo(2);\n assertThat(headers.get(\"ping\")).isEqualTo(\"pong\");\n assertThat(headers.get(\"title\")).isEqualTo(\"Kein plötzliches\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void headerParamList() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@Header(\"foo\") List kit) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, asList(\"bar\", null, \"baz\"));\n assertThat(request.method()).isEqualTo(\"GET\");\n okhttp3.Headers headers = request.headers();\n assertThat(headers.size()).isEqualTo(2);\n assertThat(headers.values(\"foo\")).containsExactly(\"bar\", \"baz\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void headerParamArray() {\n class Example {\n @GET(\"/foo/bar/\") //\n Call method(@Header(\"foo\") String[] kit) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, (Object) new String[] {\"bar\", null, \"baz\"});\n assertThat(request.method()).isEqualTo(\"GET\");\n okhttp3.Headers headers = request.headers();\n assertThat(headers.size()).isEqualTo(2);\n assertThat(headers.values(\"foo\")).containsExactly(\"bar\", \"baz\");\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n\n @Test\n public void contentTypeAnnotationHeaderOverrides() {\n class Example {\n @POST(\"/\") //\n @Headers(\"Content-Type: text/not-plain\") //\n Call method(@Body RequestBody body) {\n return null;\n }\n }\n RequestBody body = RequestBody.create(TEXT_PLAIN, \"hi\");\n Request request = buildRequest(Example.class, body);\n assertThat(request.body().contentType().toString()).isEqualTo(\"text/not-plain\");\n }\n\n @Test\n public void contentTypeAnnotationHeaderOverridesFormEncoding() {\n class Example {\n @FormUrlEncoded //\n @POST(\"/foo\") //\n @Headers(\"Content-Type: text/not-plain\") //\n Call method(@Field(\"foo\") String foo, @Field(\"ping\") String ping) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"bar\", \"pong\");\n assertThat(request.body().contentType().toString()).isEqualTo(\"text/not-plain\");\n }\n\n @Test\n public void contentTypeAnnotationHeaderOverridesMultipart() {\n class Example {\n @Multipart //\n @POST(\"/foo/bar/\") //\n @Headers(\"Content-Type: text/not-plain\") //\n Call method(@Part(\"ping\") String ping, @Part(\"kit\") RequestBody kit) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, \"pong\", RequestBody.create(TEXT_PLAIN, \"kat\"));\n\n RequestBody body = request.body();\n assertThat(request.body().contentType().toString()).isEqualTo(\"text/not-plain\");\n }\n\n @Test\n public void malformedContentTypeHeaderThrows() {\n class Example {\n @POST(\"/\") //\n @Headers(\"Content-Type: hello, world!\") //\n Call method(@Body RequestBody body) {\n return null;\n }\n }\n RequestBody body = RequestBody.create(TEXT_PLAIN, \"hi\");\n try {\n buildRequest(Example.class, body);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Malformed content type: hello, world!\\n\" + \" for method Example.method\");\n assertThat(e).hasCauseThat().isInstanceOf(IllegalArgumentException.class); // OkHttp's cause.\n }\n }\n\n @Test\n public void contentTypeAnnotationHeaderAddsHeaderWithNoBodyGet() {\n class Example {\n @GET(\"/\") //\n @Headers(\"Content-Type: text/not-plain\") //\n Call method() {\n return null;\n }\n }\n Request request = buildRequest(Example.class);\n assertThat(request.headers().get(\"Content-Type\")).isEqualTo(\"text/not-plain\");\n }\n\n @Test\n public void contentTypeAnnotationHeaderAddsHeaderWithNoBodyDelete() {\n class Example {\n @DELETE(\"/\") //\n @Headers(\"Content-Type: text/not-plain\") //\n Call method() {\n return null;\n }\n }\n Request request = buildRequest(Example.class);\n assertThat(request.headers().get(\"Content-Type\")).isEqualTo(\"text/not-plain\");\n }\n\n @Test\n public void contentTypeParameterHeaderOverrides() {\n class Example {\n @POST(\"/\") //\n Call method(\n @Header(\"Content-Type\") String contentType, @Body RequestBody body) {\n return null;\n }\n }\n RequestBody body = RequestBody.create(TEXT_PLAIN, \"Plain\");\n Request request = buildRequest(Example.class, \"text/not-plain\", body);\n assertThat(request.body().contentType().toString()).isEqualTo(\"text/not-plain\");\n }\n\n @Test\n public void malformedContentTypeParameterThrows() {\n class Example {\n @POST(\"/\") //\n Call method(\n @Header(\"Content-Type\") String contentType, @Body RequestBody body) {\n return null;\n }\n }\n RequestBody body = RequestBody.create(TEXT_PLAIN, \"hi\");\n try {\n buildRequest(Example.class, \"hello, world!\", body);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Malformed content type: hello, world!\");\n assertThat(e).hasCauseThat().isInstanceOf(IllegalArgumentException.class); // OkHttp's cause.\n }\n }\n\n @Test\n public void malformedAnnotationRelativeUrlThrows() {\n class Example {\n @GET(\"ftp://example.org\")\n Call get() {\n return null;\n }\n }\n try {\n buildRequest(Example.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Malformed URL. Base: http://example.com/, Relative: ftp://example.org\");\n }\n }\n\n @Test\n public void malformedParameterRelativeUrlThrows() {\n class Example {\n @GET\n Call get(@Url String relativeUrl) {\n return null;\n }\n }\n try {\n buildRequest(Example.class, \"ftp://example.org\");\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Malformed URL. Base: http://example.com/, Relative: ftp://example.org\");\n }\n }\n\n @Test\n public void multipartPartsShouldBeInOrder() throws IOException {\n class Example {\n @Multipart\n @POST(\"/foo\")\n Call get(\n @Part(\"first\") String data,\n @Part(\"second\") String dataTwo,\n @Part(\"third\") String dataThree) {\n return null;\n }\n }\n Request request = buildRequest(Example.class, \"firstParam\", \"secondParam\", \"thirdParam\");\n MultipartBody body = (MultipartBody) request.body();\n\n Buffer buffer = new Buffer();\n body.writeTo(buffer);\n String readBody = buffer.readUtf8();\n\n assertThat(readBody.indexOf(\"firstParam\")).isLessThan(readBody.indexOf(\"secondParam\"));\n assertThat(readBody.indexOf(\"secondParam\")).isLessThan(readBody.indexOf(\"thirdParam\"));\n }\n\n @Test\n public void queryParamsSkippedIfConvertedToNull() throws Exception {\n class Example {\n @GET(\"/query\")\n Call queryPath(@Query(\"a\") Object a) {\n return null;\n }\n }\n\n Retrofit.Builder retrofitBuilder =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com\")\n .addConverterFactory(new NullObjectConverterFactory());\n\n Request request = buildRequest(Example.class, retrofitBuilder, \"Ignored\");\n\n assertThat(request.url().toString()).doesNotContain(\"Ignored\");\n }\n\n @Test\n public void queryParamMapsConvertedToNullShouldError() throws Exception {\n class Example {\n @GET(\"/query\")\n Call queryPath(@QueryMap Map a) {\n return null;\n }\n }\n\n Retrofit.Builder retrofitBuilder =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com\")\n .addConverterFactory(new NullObjectConverterFactory());\n\n Map queryMap = Collections.singletonMap(\"kit\", \"kat\");\n\n try {\n buildRequest(Example.class, retrofitBuilder, queryMap);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .contains(\n \"Query map value 'kat' converted to null by retrofit2.helpers.NullObjectConverterFactory$1 for key 'kit'.\");\n }\n }\n\n @Test\n public void fieldParamsSkippedIfConvertedToNull() throws Exception {\n class Example {\n @FormUrlEncoded\n @POST(\"/query\")\n Call queryPath(@Field(\"a\") Object a) {\n return null;\n }\n }\n\n Retrofit.Builder retrofitBuilder =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com\")\n .addConverterFactory(new NullObjectConverterFactory());\n\n Request request = buildRequest(Example.class, retrofitBuilder, \"Ignored\");\n\n assertThat(request.url().toString()).doesNotContain(\"Ignored\");\n }\n\n @Test\n public void fieldParamMapsConvertedToNullShouldError() throws Exception {\n class Example {\n @FormUrlEncoded\n @POST(\"/query\")\n Call queryPath(@FieldMap Map a) {\n return null;\n }\n }\n\n Retrofit.Builder retrofitBuilder =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com\")\n .addConverterFactory(new NullObjectConverterFactory());\n\n Map queryMap = Collections.singletonMap(\"kit\", \"kat\");\n\n try {\n buildRequest(Example.class, retrofitBuilder, queryMap);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .contains(\n \"Field map value 'kat' converted to null by retrofit2.helpers.NullObjectConverterFactory$1 for key 'kit'.\");\n }\n }\n\n @Test\n public void tag() {\n class Example {\n @GET(\"/\")\n Call method(@Tag String tag) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, \"tagValue\");\n assertThat(request.tag(String.class)).isEqualTo(\"tagValue\");\n }\n\n @Test\n public void tagPrimitive() {\n class Example {\n @GET(\"/\")\n Call method(@Tag long timestamp) {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class, 42L);\n assertThat(request.tag(Long.class)).isEqualTo(42L);\n }\n\n @Test\n public void tagGeneric() {\n class Example {\n @GET(\"/\")\n Call method(@Tag List tag) {\n return null;\n }\n }\n\n List strings = asList(\"tag\", \"value\");\n Request request = buildRequest(Example.class, strings);\n assertThat(request.tag(List.class)).isSameInstanceAs(strings);\n }\n\n @Test\n public void tagDuplicateFails() {\n class Example {\n @GET(\"/\")\n Call method(@Tag String one, @Tag String two) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, \"one\", \"two\");\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Tag type java.lang.String is duplicate of parameter 'one' and would always overwrite its value. (parameter 'two')\\n\"\n + \" for method Example.method\");\n }\n }\n\n @Test\n public void tagGenericDuplicateFails() {\n class Example {\n @GET(\"/\")\n Call method(@Tag List one, @Tag List two) {\n return null;\n }\n }\n\n try {\n buildRequest(Example.class, emptyList(), emptyList());\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"@Tag type java.util.List is duplicate of parameter 'one' and would always overwrite its value. (parameter 'two')\\n\"\n + \" for method Example.method\");\n }\n }\n\n private static void assertBody(RequestBody body, String expected) {\n assertThat(body).isNotNull();\n Buffer buffer = new Buffer();\n try {\n body.writeTo(buffer);\n assertThat(buffer.readUtf8()).isEqualTo(expected);\n } catch (IOException e) {\n throw new RuntimeException(e);\n }\n }\n\n static void assertMalformedRequest(Class cls, Object... args) {\n try {\n Request request = buildRequest(cls, args);\n fail(\"expected a malformed request but was \" + request);\n } catch (IllegalArgumentException expected) {\n // Ignored\n }\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/ResponseTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport okhttp3.Headers;\nimport okhttp3.MediaType;\nimport okhttp3.Protocol;\nimport okhttp3.ResponseBody;\nimport org.junit.Test;\n\npublic final class ResponseTest {\n private final okhttp3.Response successResponse =\n new okhttp3.Response.Builder() //\n .code(200)\n .message(\"OK\")\n .protocol(Protocol.HTTP_1_1)\n .request(new okhttp3.Request.Builder().url(\"http://localhost\").build())\n .build();\n private final okhttp3.Response errorResponse =\n new okhttp3.Response.Builder() //\n .code(400)\n .message(\"Broken!\")\n .protocol(Protocol.HTTP_1_1)\n .request(new okhttp3.Request.Builder().url(\"http://localhost\").build())\n .build();\n\n @Test\n public void success() {\n Object body = new Object();\n Response response = Response.success(body);\n assertThat(response.raw()).isNotNull();\n assertThat(response.code()).isEqualTo(200);\n assertThat(response.message()).isEqualTo(\"OK\");\n assertThat(response.headers().size()).isEqualTo(0);\n assertThat(response.isSuccessful()).isTrue();\n assertThat(response.body()).isSameInstanceAs(body);\n assertThat(response.errorBody()).isNull();\n }\n\n @Test\n public void successNullAllowed() {\n Response response = Response.success(null);\n assertThat(response.isSuccessful()).isTrue();\n assertThat(response.body()).isNull();\n }\n\n @Test\n public void successWithHeaders() {\n Object body = new Object();\n Headers headers = Headers.of(\"foo\", \"bar\");\n Response response = Response.success(body, headers);\n assertThat(response.raw()).isNotNull();\n assertThat(response.code()).isEqualTo(200);\n assertThat(response.message()).isEqualTo(\"OK\");\n assertThat(response.headers().toMultimap()).isEqualTo(headers.toMultimap());\n assertThat(response.isSuccessful()).isTrue();\n assertThat(response.body()).isSameInstanceAs(body);\n assertThat(response.errorBody()).isNull();\n }\n\n @Test\n public void successWithNullHeadersThrows() {\n try {\n Response.success(\"\", (okhttp3.Headers) null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"headers == null\");\n }\n }\n\n @Test\n public void successWithStatusCode() {\n Object body = new Object();\n Response response = Response.success(204, body);\n assertThat(response.code()).isEqualTo(204);\n assertThat(response.message()).isEqualTo(\"Response.success()\");\n assertThat(response.headers().size()).isEqualTo(0);\n assertThat(response.isSuccessful()).isTrue();\n assertThat(response.body()).isSameInstanceAs(body);\n assertThat(response.errorBody()).isNull();\n }\n\n @Test\n public void successWithRawResponse() {\n Object body = new Object();\n Response response = Response.success(body, successResponse);\n assertThat(response.raw()).isSameInstanceAs(successResponse);\n assertThat(response.code()).isEqualTo(200);\n assertThat(response.message()).isEqualTo(\"OK\");\n assertThat(response.headers().size()).isEqualTo(0);\n assertThat(response.isSuccessful()).isTrue();\n assertThat(response.body()).isSameInstanceAs(body);\n assertThat(response.errorBody()).isNull();\n }\n\n @Test\n public void successWithNullRawResponseThrows() {\n try {\n Response.success(\"\", (okhttp3.Response) null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"rawResponse == null\");\n }\n }\n\n @Test\n public void successWithErrorRawResponseThrows() {\n try {\n Response.success(\"\", errorResponse);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"rawResponse must be successful response\");\n }\n }\n\n @Test\n public void error() {\n MediaType plainText = MediaType.get(\"text/plain; charset=utf-8\");\n ResponseBody errorBody = ResponseBody.create(plainText, \"Broken!\");\n Response response = Response.error(400, errorBody);\n assertThat(response.raw()).isNotNull();\n assertThat(response.raw().body().contentType()).isEqualTo(plainText);\n assertThat(response.raw().body().contentLength()).isEqualTo(7);\n try {\n response.raw().body().source();\n fail();\n } catch (IllegalStateException expected) {\n }\n assertThat(response.code()).isEqualTo(400);\n assertThat(response.message()).isEqualTo(\"Response.error()\");\n assertThat(response.headers().size()).isEqualTo(0);\n assertThat(response.isSuccessful()).isFalse();\n assertThat(response.body()).isNull();\n assertThat(response.errorBody()).isSameInstanceAs(errorBody);\n }\n\n @Test\n public void nullErrorThrows() {\n try {\n Response.error(400, null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"body == null\");\n }\n }\n\n @Test\n public void errorWithSuccessCodeThrows() {\n ResponseBody errorBody = ResponseBody.create(null, \"Broken!\");\n try {\n Response.error(200, errorBody);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"code < 400: 200\");\n }\n }\n\n @Test\n public void errorWithRawResponse() {\n ResponseBody errorBody = ResponseBody.create(null, \"Broken!\");\n Response response = Response.error(errorBody, errorResponse);\n assertThat(response.raw()).isSameInstanceAs(errorResponse);\n assertThat(response.code()).isEqualTo(400);\n assertThat(response.message()).isEqualTo(\"Broken!\");\n assertThat(response.headers().size()).isEqualTo(0);\n assertThat(response.isSuccessful()).isFalse();\n assertThat(response.body()).isNull();\n assertThat(response.errorBody()).isSameInstanceAs(errorBody);\n }\n\n @Test\n public void nullErrorWithRawResponseThrows() {\n try {\n Response.error(null, errorResponse);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"body == null\");\n }\n }\n\n @Test\n public void errorWithNullRawResponseThrows() {\n ResponseBody errorBody = ResponseBody.create(null, \"Broken!\");\n try {\n Response.error(errorBody, null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"rawResponse == null\");\n }\n }\n\n @Test\n public void errorWithSuccessRawResponseThrows() {\n ResponseBody errorBody = ResponseBody.create(null, \"Broken!\");\n try {\n Response.error(errorBody, successResponse);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"rawResponse should not be successful response\");\n }\n }\n}\n" }, { "path": "retrofit/java-test/src/test/java/retrofit2/RetrofitTest.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AT_START;\nimport static org.junit.Assert.assertEquals;\nimport static org.junit.Assert.assertNotNull;\nimport static org.junit.Assert.assertSame;\nimport static org.junit.Assert.assertThrows;\nimport static org.junit.Assert.assertTrue;\nimport static org.junit.Assert.fail;\nimport static retrofit2.AnnotationArraySubject.assertThat;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.annotation.Retention;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport java.net.MalformedURLException;\nimport java.net.URL;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Set;\nimport java.util.concurrent.CountDownLatch;\nimport java.util.concurrent.Executor;\nimport java.util.concurrent.Future;\nimport java.util.concurrent.TimeUnit;\nimport java.util.concurrent.atomic.AtomicBoolean;\nimport java.util.concurrent.atomic.AtomicInteger;\nimport java.util.concurrent.atomic.AtomicReference;\nimport javax.annotation.Nullable;\nimport okhttp3.HttpUrl;\nimport okhttp3.MediaType;\nimport okhttp3.OkHttpClient;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.helpers.DelegatingCallAdapterFactory;\nimport retrofit2.helpers.NonMatchingCallAdapterFactory;\nimport retrofit2.helpers.NonMatchingConverterFactory;\nimport retrofit2.helpers.ToStringConverterFactory;\nimport retrofit2.http.Body;\nimport retrofit2.http.GET;\nimport retrofit2.http.POST;\nimport retrofit2.http.Query;\n\npublic final class RetrofitTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface CallMethod {\n @GET(\"/\")\n Call disallowed();\n\n @POST(\"/\")\n Call disallowed(@Body String body);\n\n @GET(\"/\")\n Call badType1();\n\n @GET(\"/\")\n Call badType2();\n\n @GET(\"/\")\n Call getResponseBody();\n\n @SkipCallbackExecutor\n @GET(\"/\")\n Call getResponseBodySkippedExecutor();\n\n @GET(\"/\")\n Call getVoid();\n\n @POST(\"/\")\n Call postRequestBody(@Body RequestBody body);\n\n @GET(\"/\")\n Call queryString(@Query(\"foo\") String foo);\n\n @GET(\"/\")\n Call queryObject(@Query(\"foo\") Object foo);\n }\n\n interface FutureMethod {\n @GET(\"/\")\n Future method();\n }\n\n interface Extending extends CallMethod {}\n\n interface TypeParam {}\n\n interface ExtendingTypeParam extends TypeParam {}\n\n interface StringService {\n @GET(\"/\")\n String get();\n }\n\n interface UnresolvableResponseType {\n @GET(\"/\")\n Call typeVariable();\n\n @GET(\"/\")\n Call typeVariableUpperBound();\n\n @GET(\"/\")\n Call>>> crazy();\n\n @GET(\"/\")\n Call wildcard();\n\n @GET(\"/\")\n Call wildcardUpperBound();\n }\n\n interface UnresolvableParameterType {\n @POST(\"/\")\n Call typeVariable(@Body T body);\n\n @POST(\"/\")\n Call typeVariableUpperBound(@Body T body);\n\n @POST(\"/\")\n Call crazy(@Body List>> body);\n\n @POST(\"/\")\n Call wildcard(@Body List body);\n\n @POST(\"/\")\n Call wildcardUpperBound(@Body List body);\n }\n\n interface VoidService {\n @GET(\"/\")\n void nope();\n }\n\n interface Annotated {\n @GET(\"/\")\n @Foo\n Call method();\n\n @POST(\"/\")\n Call bodyParameter(@Foo @Body String param);\n\n @GET(\"/\")\n Call queryParameter(@Foo @Query(\"foo\") Object foo);\n\n @Retention(RUNTIME)\n @interface Foo {}\n }\n\n interface MutableParameters {\n @GET(\"/\")\n Call method(@Query(\"i\") AtomicInteger value);\n }\n\n // We are explicitly testing this behavior.\n @SuppressWarnings({\"EqualsBetweenInconvertibleTypes\", \"EqualsIncompatibleType\"})\n @Test\n public void objectMethodsStillWork() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n CallMethod example = retrofit.create(CallMethod.class);\n\n assertThat(example.hashCode()).isNotEqualTo(0);\n assertThat(example.equals(this)).isFalse();\n assertThat(example.toString()).isNotEmpty();\n }\n\n @Test\n public void interfaceWithTypeParameterThrows() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n try {\n retrofit.create(TypeParam.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Type parameters are unsupported on retrofit2.RetrofitTest$TypeParam\");\n }\n }\n\n @Test\n public void interfaceWithExtend() throws IOException {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n Extending extending = retrofit.create(Extending.class);\n String result = extending.getResponseBody().execute().body().string();\n assertEquals(\"Hi\", result);\n }\n\n @Test\n public void interfaceWithExtendWithTypeParameterThrows() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n try {\n retrofit.create(ExtendingTypeParam.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Type parameters are unsupported on retrofit2.RetrofitTest$TypeParam \"\n + \"which is an interface of retrofit2.RetrofitTest$ExtendingTypeParam\");\n }\n }\n\n @Test\n public void cloneSharesStatefulInstances() {\n CallAdapter.Factory callAdapter =\n new CallAdapter.Factory() {\n @Nullable\n @Override\n public CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n throw new AssertionError();\n }\n };\n Converter.Factory converter = new Converter.Factory() {};\n HttpUrl baseUrl = server.url(\"/\");\n Executor executor = Runnable::run;\n okhttp3.Call.Factory callFactory =\n request -> {\n throw new AssertionError();\n };\n\n Retrofit one =\n new Retrofit.Builder()\n .addCallAdapterFactory(callAdapter)\n .addConverterFactory(converter)\n .baseUrl(baseUrl)\n .callbackExecutor(executor)\n .callFactory(callFactory)\n .build();\n\n CallAdapter.Factory callAdapter2 =\n new CallAdapter.Factory() {\n @Nullable\n @Override\n public CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n throw new AssertionError();\n }\n };\n Converter.Factory converter2 = new Converter.Factory() {};\n Retrofit two =\n one.newBuilder()\n .addCallAdapterFactory(callAdapter2)\n .addConverterFactory(converter2)\n .build();\n assertEquals(one.callAdapterFactories().size() + 1, two.callAdapterFactories().size());\n assertThat(two.callAdapterFactories()).containsAtLeast(callAdapter, callAdapter2);\n assertEquals(one.converterFactories().size() + 1, two.converterFactories().size());\n assertThat(two.converterFactories()).containsAtLeast(converter, converter2);\n assertSame(baseUrl, two.baseUrl());\n assertSame(executor, two.callbackExecutor());\n assertSame(callFactory, two.callFactory());\n }\n\n @Test\n public void builtInConvertersAbsentInCloneBuilder() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n\n assertEquals(0, retrofit.newBuilder().converterFactories().size());\n }\n\n @Test\n public void responseTypeCannotBeRetrofitResponse() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n CallMethod service = retrofit.create(CallMethod.class);\n try {\n service.badType1();\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Response must include generic type (e.g., Response)\\n\"\n + \" for method CallMethod.badType1\");\n }\n }\n\n @Test\n public void responseTypeCannotBeOkHttpResponse() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n CallMethod service = retrofit.create(CallMethod.class);\n try {\n service.badType2();\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"'okhttp3.Response' is not a valid response body type. Did you mean ResponseBody?\\n\"\n + \" for method CallMethod.badType2\");\n }\n }\n\n @Test\n public void voidReturnTypeNotAllowed() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n VoidService service = retrofit.create(VoidService.class);\n\n try {\n service.nope();\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .startsWith(\"Service methods cannot return void.\\n for method VoidService.nope\");\n }\n }\n\n @Test\n public void validateEagerlyDisabledByDefault() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n\n // Should not throw exception about incorrect configuration of the VoidService\n retrofit.create(VoidService.class);\n }\n\n @Test\n public void validateEagerlyDisabledByUser() {\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).validateEagerly(false).build();\n\n // Should not throw exception about incorrect configuration of the VoidService\n retrofit.create(VoidService.class);\n }\n\n @Test\n public void validateEagerlyFailsAtCreation() {\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).validateEagerly(true).build();\n\n try {\n retrofit.create(VoidService.class);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .startsWith(\"Service methods cannot return void.\\n for method VoidService.nope\");\n }\n }\n\n @Test\n public void callCallAdapterAddedByDefault() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n CallMethod example = retrofit.create(CallMethod.class);\n assertThat(example.getResponseBody()).isNotNull();\n }\n\n @Test\n public void callCallCustomAdapter() {\n final AtomicBoolean factoryCalled = new AtomicBoolean();\n final AtomicBoolean adapterCalled = new AtomicBoolean();\n class MyCallAdapterFactory extends CallAdapter.Factory {\n @Override\n public @Nullable CallAdapter get(\n final Type returnType, Annotation[] annotations, Retrofit retrofit) {\n factoryCalled.set(true);\n if (getRawType(returnType) != Call.class) {\n return null;\n }\n return new CallAdapter>() {\n @Override\n public Type responseType() {\n return getParameterUpperBound(0, (ParameterizedType) returnType);\n }\n\n @Override\n public Call adapt(Call call) {\n adapterCalled.set(true);\n return call;\n }\n };\n }\n }\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addCallAdapterFactory(new MyCallAdapterFactory())\n .build();\n CallMethod example = retrofit.create(CallMethod.class);\n assertThat(example.getResponseBody()).isNotNull();\n assertThat(factoryCalled.get()).isTrue();\n assertThat(adapterCalled.get()).isTrue();\n }\n\n @Test\n public void customCallAdapter() {\n class GreetingCallAdapterFactory extends CallAdapter.Factory {\n @Override\n public @Nullable CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n if (getRawType(returnType) != String.class) {\n return null;\n }\n return new CallAdapter() {\n @Override\n public Type responseType() {\n return String.class;\n }\n\n @Override\n public String adapt(Call call) {\n return \"Hi!\";\n }\n };\n }\n }\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .addCallAdapterFactory(new GreetingCallAdapterFactory())\n .build();\n StringService example = retrofit.create(StringService.class);\n assertThat(example.get()).isEqualTo(\"Hi!\");\n }\n\n @Test\n public void methodAnnotationsPassedToCallAdapter() {\n final AtomicReference annotationsRef = new AtomicReference<>();\n class MyCallAdapterFactory extends CallAdapter.Factory {\n @Override\n public @Nullable CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n annotationsRef.set(annotations);\n return null;\n }\n }\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .addCallAdapterFactory(new MyCallAdapterFactory())\n .build();\n Annotated annotated = retrofit.create(Annotated.class);\n annotated.method(); // Trigger internal setup.\n\n Annotation[] annotations = annotationsRef.get();\n assertThat(annotations).hasAtLeastOneElementOfType(Annotated.Foo.class);\n }\n\n @Test\n public void customCallAdapterMissingThrows() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n FutureMethod example = retrofit.create(FutureMethod.class);\n try {\n example.method();\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Unable to create call adapter for java.util.concurrent.Future\\n\"\n + \" for method FutureMethod.method\");\n assertThat(e.getCause())\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Could not locate call adapter for java.util.concurrent.Future.\\n\"\n + \" Tried:\\n\"\n + \" * retrofit2.CompletableFutureCallAdapterFactory\\n\"\n + \" * retrofit2.DefaultCallAdapterFactory\");\n }\n }\n\n @Test\n public void methodAnnotationsPassedToResponseBodyConverter() {\n final AtomicReference annotationsRef = new AtomicReference<>();\n class MyConverterFactory extends Converter.Factory {\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n annotationsRef.set(annotations);\n return new ToStringConverterFactory().responseBodyConverter(type, annotations, retrofit);\n }\n }\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new MyConverterFactory())\n .build();\n Annotated annotated = retrofit.create(Annotated.class);\n annotated.method(); // Trigger internal setup.\n\n Annotation[] annotations = annotationsRef.get();\n assertThat(annotations).hasAtLeastOneElementOfType(Annotated.Foo.class);\n }\n\n @Test\n public void methodAndParameterAnnotationsPassedToRequestBodyConverter() {\n final AtomicReference parameterAnnotationsRef = new AtomicReference<>();\n final AtomicReference methodAnnotationsRef = new AtomicReference<>();\n\n class MyConverterFactory extends Converter.Factory {\n @Override\n public Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n parameterAnnotationsRef.set(parameterAnnotations);\n methodAnnotationsRef.set(methodAnnotations);\n return new ToStringConverterFactory()\n .requestBodyConverter(type, parameterAnnotations, methodAnnotations, retrofit);\n }\n }\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new MyConverterFactory())\n .build();\n Annotated annotated = retrofit.create(Annotated.class);\n annotated.bodyParameter(null); // Trigger internal setup.\n\n assertThat(parameterAnnotationsRef.get()).hasAtLeastOneElementOfType(Annotated.Foo.class);\n assertThat(methodAnnotationsRef.get()).hasAtLeastOneElementOfType(POST.class);\n }\n\n @Test\n public void parameterAnnotationsPassedToStringConverter() {\n final AtomicReference annotationsRef = new AtomicReference<>();\n class MyConverterFactory extends Converter.Factory {\n @Override\n public Converter stringConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n annotationsRef.set(annotations);\n\n return (Converter) String::valueOf;\n }\n }\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new MyConverterFactory())\n .build();\n Annotated annotated = retrofit.create(Annotated.class);\n annotated.queryParameter(null); // Trigger internal setup.\n\n Annotation[] annotations = annotationsRef.get();\n assertThat(annotations).hasAtLeastOneElementOfType(Annotated.Foo.class);\n }\n\n @Test\n public void stringConverterCalledForString() {\n final AtomicBoolean factoryCalled = new AtomicBoolean();\n class MyConverterFactory extends Converter.Factory {\n @Override\n public @Nullable Converter stringConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n factoryCalled.set(true);\n return null;\n }\n }\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new MyConverterFactory())\n .build();\n CallMethod service = retrofit.create(CallMethod.class);\n Call call = service.queryString(null);\n assertThat(call).isNotNull();\n assertThat(factoryCalled.get()).isTrue();\n }\n\n @Test\n public void stringConverterReturningNullResultsInDefault() {\n final AtomicBoolean factoryCalled = new AtomicBoolean();\n class MyConverterFactory extends Converter.Factory {\n @Override\n public @Nullable Converter stringConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n factoryCalled.set(true);\n return null;\n }\n }\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new MyConverterFactory())\n .build();\n CallMethod service = retrofit.create(CallMethod.class);\n Call call = service.queryObject(null);\n assertThat(call).isNotNull();\n assertThat(factoryCalled.get()).isTrue();\n }\n\n @Test\n public void missingConverterThrowsOnNonRequestBody() throws IOException {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n CallMethod example = retrofit.create(CallMethod.class);\n try {\n example.disallowed(\"Hi!\");\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Unable to create @Body converter for class java.lang.String (parameter 'body')\\n\"\n + \" for method CallMethod.disallowed\");\n assertThat(e.getCause())\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Could not locate RequestBody converter for class java.lang.String.\\n\"\n + \" Tried:\\n\"\n + \" * retrofit2.BuiltInConverters\\n\"\n + \" * retrofit2.OptionalConverterFactory\");\n }\n }\n\n @Test\n public void missingConverterThrowsOnNonResponseBody() throws IOException {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n CallMethod example = retrofit.create(CallMethod.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n try {\n example.disallowed();\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Unable to create converter for class java.lang.String\\n\"\n + \" for method CallMethod.disallowed\");\n assertThat(e.getCause())\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Could not locate ResponseBody converter for class java.lang.String.\\n\"\n + \" Tried:\\n\"\n + \" * retrofit2.BuiltInConverters\\n\"\n + \" * retrofit2.OptionalConverterFactory\");\n }\n }\n\n @Test\n public void requestBodyOutgoingAllowed() throws IOException {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n CallMethod example = retrofit.create(CallMethod.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n Response response = example.getResponseBody().execute();\n assertThat(response.body().string()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void voidOutgoingAllowed() throws IOException {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n CallMethod example = retrofit.create(CallMethod.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n Response response = example.getVoid().execute();\n assertThat(response.body()).isNull();\n }\n\n @Test\n public void voidResponsesArePooled() throws Exception {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n CallMethod example = retrofit.create(CallMethod.class);\n\n server.enqueue(new MockResponse().setBody(\"abc\"));\n server.enqueue(new MockResponse().setBody(\"def\"));\n\n example.getVoid().execute();\n example.getVoid().execute();\n\n assertThat(server.takeRequest().getSequenceNumber()).isEqualTo(0);\n assertThat(server.takeRequest().getSequenceNumber()).isEqualTo(1);\n }\n\n @Test\n public void responseBodyIncomingAllowed() throws IOException, InterruptedException {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n CallMethod example = retrofit.create(CallMethod.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RequestBody body = RequestBody.create(MediaType.get(\"text/plain\"), \"Hey\");\n Response response = example.postRequestBody(body).execute();\n assertThat(response.body().string()).isEqualTo(\"Hi\");\n\n assertThat(server.takeRequest().getBody().readUtf8()).isEqualTo(\"Hey\");\n }\n\n @Test\n public void unresolvableResponseTypeThrows() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n UnresolvableResponseType example = retrofit.create(UnresolvableResponseType.class);\n\n try {\n example.typeVariable();\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Method return type must not include a type variable or wildcard: \"\n + \"retrofit2.Call\\n for method UnresolvableResponseType.typeVariable\");\n }\n try {\n example.typeVariableUpperBound();\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Method return type must not include a type variable or wildcard: \"\n + \"retrofit2.Call\\n for method UnresolvableResponseType.typeVariableUpperBound\");\n }\n try {\n example.crazy();\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Method return type must not include a type variable or wildcard: \"\n + \"retrofit2.Call>>>\\n\"\n + \" for method UnresolvableResponseType.crazy\");\n }\n try {\n example.wildcard();\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Method return type must not include a type variable or wildcard: \"\n + \"retrofit2.Call\\n for method UnresolvableResponseType.wildcard\");\n }\n try {\n example.wildcardUpperBound();\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Method return type must not include a type variable or wildcard: \"\n + \"retrofit2.Call\\n\"\n + \" for method UnresolvableResponseType.wildcardUpperBound\");\n }\n }\n\n @Test\n public void unresolvableParameterTypeThrows() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n UnresolvableParameterType example = retrofit.create(UnresolvableParameterType.class);\n\n try {\n example.typeVariable(null);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Parameter type must not include a type variable or wildcard: \"\n + \"T (parameter 'body')\\n for method UnresolvableParameterType.typeVariable\");\n }\n try {\n example.typeVariableUpperBound(null);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Parameter type must not include a type variable or wildcard: \"\n + \"T (parameter 'body')\\n for method UnresolvableParameterType.typeVariableUpperBound\");\n }\n try {\n example.crazy(null);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Parameter type must not include a type variable or wildcard: \"\n + \"java.util.List>> (parameter 'body')\\n\"\n + \" for method UnresolvableParameterType.crazy\");\n }\n try {\n example.wildcard(null);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Parameter type must not include a type variable or wildcard: \"\n + \"java.util.List (parameter 'body')\\n for method UnresolvableParameterType.wildcard\");\n }\n try {\n example.wildcardUpperBound(null);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Parameter type must not include a type variable or wildcard: \"\n + \"java.util.List (parameter 'body')\\n\"\n + \" for method UnresolvableParameterType.wildcardUpperBound\");\n }\n }\n\n @Test\n public void baseUrlRequired() {\n try {\n new Retrofit.Builder().build();\n fail();\n } catch (IllegalStateException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Base URL required.\");\n }\n }\n\n @Test\n public void baseUrlNullThrows() {\n try {\n new Retrofit.Builder().baseUrl((String) null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"baseUrl == null\");\n }\n try {\n new Retrofit.Builder().baseUrl((HttpUrl) null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"baseUrl == null\");\n }\n }\n\n @Test\n public void baseUrlInvalidThrows() {\n try {\n new Retrofit.Builder().baseUrl(\"ftp://foo/bar\");\n fail();\n } catch (IllegalArgumentException ignored) {\n }\n }\n\n @Test\n public void baseUrlNoTrailingSlashThrows() {\n try {\n new Retrofit.Builder().baseUrl(\"http://example.com/api\");\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"baseUrl must end in /: http://example.com/api\");\n }\n HttpUrl parsed = HttpUrl.get(\"http://example.com/api\");\n try {\n new Retrofit.Builder().baseUrl(parsed);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"baseUrl must end in /: http://example.com/api\");\n }\n }\n\n @Test\n public void baseUrlStringPropagated() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(\"http://example.com/\").build();\n HttpUrl baseUrl = retrofit.baseUrl();\n assertThat(baseUrl).isEqualTo(HttpUrl.get(\"http://example.com/\"));\n }\n\n @Test\n public void baseHttpUrlPropagated() {\n HttpUrl url = HttpUrl.get(\"http://example.com/\");\n Retrofit retrofit = new Retrofit.Builder().baseUrl(url).build();\n assertThat(retrofit.baseUrl()).isSameInstanceAs(url);\n }\n\n @Test\n public void baseJavaUrlPropagated() throws MalformedURLException {\n URL url = new URL(\"http://example.com/\");\n Retrofit retrofit = new Retrofit.Builder().baseUrl(url).build();\n assertThat(retrofit.baseUrl()).isEqualTo(HttpUrl.get(\"http://example.com/\"));\n }\n\n @Test\n public void clientNullThrows() {\n try {\n new Retrofit.Builder().client(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"client == null\");\n }\n }\n\n @Test\n public void callFactoryDefault() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(\"http://example.com\").build();\n assertThat(retrofit.callFactory()).isNotNull();\n }\n\n @Test\n public void callFactoryPropagated() {\n okhttp3.Call.Factory callFactory =\n request -> {\n throw new AssertionError();\n };\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(\"http://example.com/\").callFactory(callFactory).build();\n assertThat(retrofit.callFactory()).isSameInstanceAs(callFactory);\n }\n\n @Test\n public void callFactoryClientPropagated() {\n OkHttpClient client = new OkHttpClient();\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(\"http://example.com/\").client(client).build();\n assertThat(retrofit.callFactory()).isSameInstanceAs(client);\n }\n\n @Test\n public void callFactoryUsed() throws IOException {\n final AtomicBoolean called = new AtomicBoolean();\n okhttp3.Call.Factory callFactory =\n request -> {\n called.set(true);\n return new OkHttpClient().newCall(request);\n };\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).callFactory(callFactory).build();\n\n server.enqueue(new MockResponse());\n\n CallMethod service = retrofit.create(CallMethod.class);\n service.getResponseBody().execute();\n assertTrue(called.get());\n }\n\n @Test\n public void callFactoryReturningNullThrows() throws IOException {\n okhttp3.Call.Factory callFactory = request -> null;\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(\"http://example.com/\").callFactory(callFactory).build();\n\n server.enqueue(new MockResponse());\n\n CallMethod service = retrofit.create(CallMethod.class);\n Call call = service.getResponseBody();\n try {\n call.execute();\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Call.Factory returned null.\");\n }\n }\n\n @Test\n public void callFactoryThrowingPropagates() {\n final RuntimeException cause = new RuntimeException(\"Broken!\");\n okhttp3.Call.Factory callFactory =\n request -> {\n throw cause;\n };\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(\"http://example.com/\").callFactory(callFactory).build();\n\n server.enqueue(new MockResponse());\n\n CallMethod service = retrofit.create(CallMethod.class);\n Call call = service.getResponseBody();\n try {\n call.execute();\n fail();\n } catch (Exception e) {\n assertThat(e).isSameInstanceAs(cause);\n }\n }\n\n @Test\n public void converterNullThrows() {\n try {\n new Retrofit.Builder().addConverterFactory(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"factory == null\");\n }\n }\n\n @Test\n public void converterFactoryDefault() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(\"http://example.com/\").build();\n List converterFactories = retrofit.converterFactories();\n assertThat(converterFactories).hasSize(2);\n assertThat(converterFactories.get(0)).isInstanceOf(BuiltInConverters.class);\n }\n\n @Test\n public void builtInConvertersFirstInClone() {\n Converter.Factory factory =\n new Converter.Factory() {\n @Nullable\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n throw new AssertionError(\n \"User converter factory shouldn't be called for built-in types\");\n }\n };\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com/\")\n .addConverterFactory(factory)\n .build()\n .newBuilder() // Do a newBuilder().builder() dance to force the internal list to clone.\n .build();\n\n assertNotNull(retrofit.responseBodyConverter(Void.class, new Annotation[0]));\n }\n\n @Test\n public void requestConverterFactoryQueried() {\n final Converter expectedAdapter =\n new Converter() {\n @Nullable\n @Override\n public RequestBody convert(Object value) {\n throw new AssertionError();\n }\n };\n Converter.Factory factory =\n new Converter.Factory() {\n @Override\n public Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n return String.class.equals(type) ? expectedAdapter : null;\n }\n };\n\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(\"http://example.com/\").addConverterFactory(factory).build();\n\n Converter actualAdapter =\n retrofit.requestBodyConverter(String.class, new Annotation[0], new Annotation[0]);\n assertThat(actualAdapter).isSameInstanceAs(expectedAdapter);\n }\n\n @Test\n public void requestConverterFactoryNoMatchThrows() {\n Type type = String.class;\n Annotation[] annotations = new Annotation[0];\n\n NonMatchingConverterFactory nonMatchingFactory = new NonMatchingConverterFactory();\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com/\")\n .addConverterFactory(nonMatchingFactory)\n .build();\n\n try {\n retrofit.requestBodyConverter(type, annotations, annotations);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Could not locate RequestBody converter for class java.lang.String.\\n\"\n + \" Tried:\\n\"\n + \" * retrofit2.BuiltInConverters\\n\"\n + \" * retrofit2.helpers.NonMatchingConverterFactory\\n\"\n + \" * retrofit2.OptionalConverterFactory\");\n }\n\n assertThat(nonMatchingFactory.called).isTrue();\n }\n\n @Test\n public void requestConverterFactorySkippedNoMatchThrows() {\n Type type = String.class;\n Annotation[] annotations = new Annotation[0];\n\n NonMatchingConverterFactory nonMatchingFactory1 = new NonMatchingConverterFactory();\n NonMatchingConverterFactory nonMatchingFactory2 = new NonMatchingConverterFactory();\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com/\")\n .addConverterFactory(nonMatchingFactory1)\n .addConverterFactory(nonMatchingFactory2)\n .build();\n\n try {\n retrofit.nextRequestBodyConverter(nonMatchingFactory1, type, annotations, annotations);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Could not locate RequestBody converter for class java.lang.String.\\n\"\n + \" Skipped:\\n\"\n + \" * retrofit2.BuiltInConverters\\n\"\n + \" * retrofit2.helpers.NonMatchingConverterFactory\\n\"\n + \" Tried:\\n\"\n + \" * retrofit2.helpers.NonMatchingConverterFactory\\n\"\n + \" * retrofit2.OptionalConverterFactory\");\n }\n\n assertThat(nonMatchingFactory1.called).isFalse();\n assertThat(nonMatchingFactory2.called).isTrue();\n }\n\n @Test\n public void responseConverterFactoryQueried() {\n final Converter expectedAdapter =\n new Converter() {\n @Nullable\n @Override\n public Object convert(ResponseBody value) {\n throw new AssertionError();\n }\n };\n Converter.Factory factory =\n new Converter.Factory() {\n @Nullable\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return String.class.equals(type) ? expectedAdapter : null;\n }\n };\n\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(\"http://example.com/\").addConverterFactory(factory).build();\n\n Converter actualAdapter =\n retrofit.responseBodyConverter(String.class, new Annotation[0]);\n assertThat(actualAdapter).isSameInstanceAs(expectedAdapter);\n }\n\n @Test\n public void responseConverterFactoryNoMatchThrows() {\n Type type = String.class;\n Annotation[] annotations = new Annotation[0];\n\n NonMatchingConverterFactory nonMatchingFactory = new NonMatchingConverterFactory();\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com/\")\n .addConverterFactory(nonMatchingFactory)\n .build();\n\n try {\n retrofit.responseBodyConverter(type, annotations);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Could not locate ResponseBody converter for class java.lang.String.\\n\"\n + \" Tried:\\n\"\n + \" * retrofit2.BuiltInConverters\\n\"\n + \" * retrofit2.helpers.NonMatchingConverterFactory\\n\"\n + \" * retrofit2.OptionalConverterFactory\");\n }\n\n assertThat(nonMatchingFactory.called).isTrue();\n }\n\n @Test\n public void responseConverterFactorySkippedNoMatchThrows() {\n Type type = String.class;\n Annotation[] annotations = new Annotation[0];\n\n NonMatchingConverterFactory nonMatchingFactory1 = new NonMatchingConverterFactory();\n NonMatchingConverterFactory nonMatchingFactory2 = new NonMatchingConverterFactory();\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com/\")\n .addConverterFactory(nonMatchingFactory1)\n .addConverterFactory(nonMatchingFactory2)\n .build();\n\n try {\n retrofit.nextResponseBodyConverter(nonMatchingFactory1, type, annotations);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Could not locate ResponseBody converter for class java.lang.String.\\n\"\n + \" Skipped:\\n\"\n + \" * retrofit2.BuiltInConverters\\n\"\n + \" * retrofit2.helpers.NonMatchingConverterFactory\\n\"\n + \" Tried:\\n\"\n + \" * retrofit2.helpers.NonMatchingConverterFactory\\n\"\n + \" * retrofit2.OptionalConverterFactory\");\n }\n\n assertThat(nonMatchingFactory1.called).isFalse();\n assertThat(nonMatchingFactory2.called).isTrue();\n }\n\n @Test\n public void stringConverterFactoryQueried() {\n final Converter expectedConverter =\n new Converter() {\n @Nullable\n @Override\n public String convert(Object value) {\n throw new AssertionError();\n }\n };\n Converter.Factory factory =\n new Converter.Factory() {\n @Nullable\n @Override\n public Converter stringConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return Object.class.equals(type) ? expectedConverter : null;\n }\n };\n\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(\"http://example.com/\").addConverterFactory(factory).build();\n\n Converter actualConverter =\n retrofit.stringConverter(Object.class, new Annotation[0]);\n assertThat(actualConverter).isSameInstanceAs(expectedConverter);\n }\n\n @Test\n public void converterFactoryPropagated() {\n Converter.Factory factory = new Converter.Factory() {};\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(\"http://example.com/\").addConverterFactory(factory).build();\n assertThat(retrofit.converterFactories()).contains(factory);\n }\n\n @Test\n public void callAdapterFactoryNullThrows() {\n try {\n new Retrofit.Builder().addCallAdapterFactory(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"factory == null\");\n }\n }\n\n @Test\n public void callAdapterFactoryDefault() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(\"http://example.com/\").build();\n assertThat(retrofit.callAdapterFactories()).isNotEmpty();\n }\n\n @Test\n public void callAdapterFactoryPropagated() {\n CallAdapter.Factory factory =\n new CallAdapter.Factory() {\n @Nullable\n @Override\n public CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n throw new AssertionError();\n }\n };\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com/\")\n .addCallAdapterFactory(factory)\n .build();\n assertThat(retrofit.callAdapterFactories()).contains(factory);\n }\n\n @Test\n public void callAdapterFactoryQueried() {\n final CallAdapter expectedAdapter =\n new CallAdapter() {\n @Override\n public Type responseType() {\n throw new AssertionError();\n }\n\n @Override\n public Object adapt(Call call) {\n throw new AssertionError();\n }\n };\n CallAdapter.Factory factory =\n new CallAdapter.Factory() {\n @Nullable\n @Override\n public CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n return String.class.equals(returnType) ? expectedAdapter : null;\n }\n };\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com/\")\n .addCallAdapterFactory(factory)\n .build();\n\n CallAdapter actualAdapter = retrofit.callAdapter(String.class, new Annotation[0]);\n assertThat(actualAdapter).isSameInstanceAs(expectedAdapter);\n }\n\n @Test\n public void callAdapterFactoryQueriedCanDelegate() {\n final CallAdapter expectedAdapter =\n new CallAdapter() {\n @Override\n public Type responseType() {\n throw new AssertionError();\n }\n\n @Override\n public Object adapt(Call call) {\n throw new AssertionError();\n }\n };\n CallAdapter.Factory factory2 =\n new CallAdapter.Factory() {\n @Override\n public CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n return expectedAdapter;\n }\n };\n final AtomicBoolean factory1called = new AtomicBoolean();\n CallAdapter.Factory factory1 =\n new CallAdapter.Factory() {\n @Override\n public CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n factory1called.set(true);\n return retrofit.nextCallAdapter(this, returnType, annotations);\n }\n };\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com/\")\n .addCallAdapterFactory(factory1)\n .addCallAdapterFactory(factory2)\n .build();\n\n CallAdapter actualAdapter = retrofit.callAdapter(String.class, new Annotation[0]);\n assertThat(actualAdapter).isSameInstanceAs(expectedAdapter);\n assertTrue(factory1called.get());\n }\n\n @Test\n public void callAdapterFactoryQueriedCanDelegateTwiceWithoutRecursion() {\n Type type = String.class;\n Annotation[] annotations = new Annotation[0];\n\n final CallAdapter expectedAdapter =\n new CallAdapter() {\n @Override\n public Type responseType() {\n throw new AssertionError();\n }\n\n @Override\n public Object adapt(Call call) {\n throw new AssertionError();\n }\n };\n CallAdapter.Factory factory3 =\n new CallAdapter.Factory() {\n @Override\n public CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n return expectedAdapter;\n }\n };\n final AtomicBoolean factory2called = new AtomicBoolean();\n CallAdapter.Factory factory2 =\n new CallAdapter.Factory() {\n @Override\n public CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n factory2called.set(true);\n return retrofit.nextCallAdapter(this, returnType, annotations);\n }\n };\n final AtomicBoolean factory1called = new AtomicBoolean();\n CallAdapter.Factory factory1 =\n new CallAdapter.Factory() {\n @Override\n public CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n factory1called.set(true);\n return retrofit.nextCallAdapter(this, returnType, annotations);\n }\n };\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com/\")\n .addCallAdapterFactory(factory1)\n .addCallAdapterFactory(factory2)\n .addCallAdapterFactory(factory3)\n .build();\n\n CallAdapter actualAdapter = retrofit.callAdapter(type, annotations);\n assertThat(actualAdapter).isSameInstanceAs(expectedAdapter);\n assertTrue(factory1called.get());\n assertTrue(factory2called.get());\n }\n\n @Test\n public void callAdapterFactoryNoMatchThrows() {\n Type type = String.class;\n Annotation[] annotations = new Annotation[0];\n\n NonMatchingCallAdapterFactory nonMatchingFactory = new NonMatchingCallAdapterFactory();\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com/\")\n .addCallAdapterFactory(nonMatchingFactory)\n .build();\n\n try {\n retrofit.callAdapter(type, annotations);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Could not locate call adapter for class java.lang.String.\\n\"\n + \" Tried:\\n\"\n + \" * retrofit2.helpers.NonMatchingCallAdapterFactory\\n\"\n + \" * retrofit2.CompletableFutureCallAdapterFactory\\n\"\n + \" * retrofit2.DefaultCallAdapterFactory\");\n }\n\n assertThat(nonMatchingFactory.called).isTrue();\n }\n\n @Test\n public void callAdapterFactoryDelegateNoMatchThrows() {\n Type type = String.class;\n Annotation[] annotations = new Annotation[0];\n\n DelegatingCallAdapterFactory delegatingFactory1 = new DelegatingCallAdapterFactory();\n DelegatingCallAdapterFactory delegatingFactory2 = new DelegatingCallAdapterFactory();\n NonMatchingCallAdapterFactory nonMatchingFactory = new NonMatchingCallAdapterFactory();\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com/\")\n .addCallAdapterFactory(delegatingFactory1)\n .addCallAdapterFactory(delegatingFactory2)\n .addCallAdapterFactory(nonMatchingFactory)\n .build();\n\n try {\n retrofit.callAdapter(type, annotations);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Could not locate call adapter for class java.lang.String.\\n\"\n + \" Skipped:\\n\"\n + \" * retrofit2.helpers.DelegatingCallAdapterFactory\\n\"\n + \" * retrofit2.helpers.DelegatingCallAdapterFactory\\n\"\n + \" Tried:\\n\"\n + \" * retrofit2.helpers.NonMatchingCallAdapterFactory\\n\"\n + \" * retrofit2.CompletableFutureCallAdapterFactory\\n\"\n + \" * retrofit2.DefaultCallAdapterFactory\");\n }\n\n assertThat(delegatingFactory1.called).isTrue();\n assertThat(delegatingFactory2.called).isTrue();\n assertThat(nonMatchingFactory.called).isTrue();\n }\n\n @Test\n public void platformAwareAdapterAbsentInCloneBuilder() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n\n assertEquals(0, retrofit.newBuilder().callAdapterFactories().size());\n }\n\n @Test\n public void callbackExecutorNullThrows() {\n try {\n new Retrofit.Builder().callbackExecutor(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"executor == null\");\n }\n }\n\n @Test\n public void callbackExecutorPropagated() {\n Executor executor =\n command -> {\n throw new AssertionError();\n };\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(\"http://example.com/\").callbackExecutor(executor).build();\n assertThat(retrofit.callbackExecutor()).isSameInstanceAs(executor);\n }\n\n @Test\n public void callbackExecutorUsedForSuccess() throws InterruptedException {\n final CountDownLatch runnableLatch = new CountDownLatch(1);\n final AtomicReference runnableRef = new AtomicReference<>();\n Executor executor =\n command -> {\n runnableRef.set(command);\n runnableLatch.countDown();\n };\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).callbackExecutor(executor).build();\n CallMethod service = retrofit.create(CallMethod.class);\n Call call = service.getResponseBody();\n\n server.enqueue(new MockResponse());\n\n final CountDownLatch callbackLatch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n callbackLatch.countDown();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n t.printStackTrace();\n }\n });\n\n assertTrue(runnableLatch.await(2, TimeUnit.SECONDS));\n assertEquals(1, callbackLatch.getCount()); // Callback not run yet.\n\n runnableRef.get().run();\n assertTrue(callbackLatch.await(2, TimeUnit.SECONDS));\n }\n\n @Test\n public void callbackExecutorUsedForFailure() throws InterruptedException {\n final CountDownLatch runnableLatch = new CountDownLatch(1);\n final AtomicReference runnableRef = new AtomicReference<>();\n Executor executor =\n command -> {\n runnableRef.set(command);\n runnableLatch.countDown();\n };\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).callbackExecutor(executor).build();\n CallMethod service = retrofit.create(CallMethod.class);\n Call call = service.getResponseBody();\n\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AT_START));\n\n final CountDownLatch callbackLatch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n throw new AssertionError();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n callbackLatch.countDown();\n }\n });\n\n assertTrue(runnableLatch.await(2, TimeUnit.SECONDS));\n assertEquals(1, callbackLatch.getCount()); // Callback not run yet.\n\n runnableRef.get().run();\n assertTrue(callbackLatch.await(2, TimeUnit.SECONDS));\n }\n\n @Test\n public void skippedCallbackExecutorNotUsedForSuccess() throws InterruptedException {\n Executor executor = command -> fail();\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).callbackExecutor(executor).build();\n CallMethod service = retrofit.create(CallMethod.class);\n Call call = service.getResponseBodySkippedExecutor();\n\n server.enqueue(new MockResponse());\n\n final CountDownLatch latch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n latch.countDown();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n t.printStackTrace();\n }\n });\n assertTrue(latch.await(2, TimeUnit.SECONDS));\n }\n\n @Test\n public void skippedCallbackExecutorNotUsedForFailure() throws InterruptedException {\n Executor executor = command -> fail();\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).callbackExecutor(executor).build();\n CallMethod service = retrofit.create(CallMethod.class);\n Call call = service.getResponseBodySkippedExecutor();\n\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AT_START));\n\n final CountDownLatch latch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n throw new AssertionError();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n latch.countDown();\n }\n });\n assertTrue(latch.await(2, TimeUnit.SECONDS));\n }\n\n /** Confirm that Retrofit encodes parameters when the call is executed, and not earlier. */\n @Test\n public void argumentCapture() throws Exception {\n AtomicInteger i = new AtomicInteger();\n\n server.enqueue(new MockResponse().setBody(\"a\"));\n server.enqueue(new MockResponse().setBody(\"b\"));\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ToStringConverterFactory())\n .build();\n MutableParameters mutableParameters = retrofit.create(MutableParameters.class);\n\n i.set(100);\n Call call1 = mutableParameters.method(i);\n\n i.set(101);\n Response response1 = call1.execute();\n\n i.set(102);\n assertEquals(\"a\", response1.body());\n assertEquals(\"/?i=101\", server.takeRequest().getPath());\n\n i.set(200);\n Call call2 = call1.clone();\n\n i.set(201);\n Response response2 = call2.execute();\n\n i.set(202);\n assertEquals(\"b\", response2.body());\n\n assertEquals(\"/?i=201\", server.takeRequest().getPath());\n }\n\n @Test\n public void annotationParsingFailureObservedByWaitingThreads() throws InterruptedException {\n AtomicInteger fails = new AtomicInteger();\n CountDownLatch startedParsing = new CountDownLatch(1);\n CountDownLatch failParsing = new CountDownLatch(1);\n RuntimeException failure = new RuntimeException(\"boom!\");\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(\n new Converter.Factory() {\n @Nullable\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n startedParsing.countDown();\n try {\n failParsing.await();\n } catch (InterruptedException e) {\n throw new AssertionError(e);\n }\n fails.incrementAndGet();\n throw failure;\n }\n })\n .build();\n Annotated service = retrofit.create(Annotated.class);\n\n AtomicReference result1 = new AtomicReference<>();\n Thread thread1 =\n new Thread(\n () -> {\n try {\n service.method();\n } catch (RuntimeException e) {\n result1.set(e);\n }\n });\n thread1.start();\n\n // Wait for thread1 to enter the converter. This means it has inserted and taken a lock on\n // parsing for the method.\n startedParsing.await();\n\n CountDownLatch thread2Locked = new CountDownLatch(1);\n AtomicReference result2 = new AtomicReference<>();\n Thread thread2 =\n new Thread(\n () -> {\n try {\n thread2Locked.countDown();\n service.method();\n } catch (RuntimeException e) {\n result2.set(e);\n }\n });\n thread2.start();\n thread2Locked.await();\n\n // Wait for thread2 to lock on the shared object. This should be pretty fast after the last\n // signal, but we have no way of knowing for sure it happened.\n Thread.sleep(1_000);\n\n failParsing.countDown();\n thread1.join();\n thread2.join();\n\n RuntimeException failure1 = result1.get();\n assertThat(failure1).isInstanceOf(IllegalArgumentException.class);\n assertThat(failure1).hasCauseThat().isSameInstanceAs(failure);\n\n RuntimeException failure2 = result2.get();\n assertThat(failure2).isInstanceOf(IllegalArgumentException.class);\n assertThat(failure2).hasCauseThat().isSameInstanceAs(failure);\n\n // Importantly, even though the second thread was locked waiting on the first, failure of the\n // first thread caused the second thread to retry parsing.\n assertThat(fails.get()).isEqualTo(2);\n\n // Make sure now that both threads have released the lock, new callers also retry.\n RuntimeException failure3 = assertThrows(IllegalArgumentException.class, service::method);\n assertThat(failure3).hasCauseThat().isSameInstanceAs(failure);\n assertThat(fails.get()).isEqualTo(3);\n }\n}\n" }, { "path": "retrofit/kotlin-test/build.gradle", "content": "apply plugin: 'org.jetbrains.kotlin.jvm'\n\ndependencies {\n testImplementation projects.retrofit\n testImplementation projects.retrofit.testHelpers\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.okhttp.mockwebserver\n testImplementation libs.kotlinx.coroutines\n}\n" }, { "path": "retrofit/kotlin-test/src/test/java/retrofit2/KotlinExtensionsTest.kt", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2\n\nimport okhttp3.mockwebserver.MockWebServer\nimport org.junit.Assert.assertNotNull\nimport org.junit.Rule\nimport org.junit.Test\n\nclass KotlinExtensionsTest {\n @get:Rule val server = MockWebServer()\n\n interface Empty\n\n @Test fun reifiedCreate() {\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .build()\n\n assertNotNull(retrofit.create())\n }\n}\n" }, { "path": "retrofit/kotlin-test/src/test/java/retrofit2/KotlinRequestFactoryTest.java", "content": "package retrofit2;\n\nimport kotlin.Unit;\nimport okhttp3.Request;\nimport org.junit.Test;\nimport retrofit2.http.HEAD;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static retrofit2.TestingUtils.buildRequest;\n\npublic final class KotlinRequestFactoryTest {\n @Test\n public void headUnit() {\n class Example {\n @HEAD(\"/foo/bar/\")\n Call method() {\n return null;\n }\n }\n\n Request request = buildRequest(Example.class);\n assertThat(request.method()).isEqualTo(\"HEAD\");\n assertThat(request.headers().size()).isEqualTo(0);\n assertThat(request.url().toString()).isEqualTo(\"http://example.com/foo/bar/\");\n assertThat(request.body()).isNull();\n }\n}\n" }, { "path": "retrofit/kotlin-test/src/test/java/retrofit2/KotlinSuspendRawTest.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport kotlin.coroutines.Continuation;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.http.GET;\n\n/**\n * This code path can only be tested from Java because Kotlin does not allow you specify a raw\n * Response type. Win! We still test this codepath for completeness.\n */\npublic final class KotlinSuspendRawTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\")\n Object body(Continuation response);\n }\n\n @Test\n public void raw() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n Service service = retrofit.create(Service.class);\n\n try {\n service.body(null);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat().isEqualTo(\n \"Response must include generic type (e.g., Response)\\n\"\n + \" for method Service.body\");\n }\n }\n}\n" }, { "path": "retrofit/kotlin-test/src/test/java/retrofit2/KotlinSuspendTest.kt", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2\n\nimport com.google.common.truth.Truth.assertThat\nimport java.io.IOException\nimport java.lang.reflect.ParameterizedType\nimport java.lang.reflect.Type\nimport kotlin.coroutines.CoroutineContext\nimport kotlinx.coroutines.CoroutineDispatcher\nimport kotlinx.coroutines.GlobalScope\nimport kotlinx.coroutines.async\nimport kotlinx.coroutines.runBlocking\nimport kotlinx.coroutines.withContext\nimport okhttp3.OkHttpClient\nimport okhttp3.mockwebserver.MockResponse\nimport okhttp3.mockwebserver.MockWebServer\nimport okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST\nimport okhttp3.mockwebserver.SocketPolicy.NO_RESPONSE\nimport org.junit.Assert.assertTrue\nimport org.junit.Assert.fail\nimport org.junit.Ignore\nimport org.junit.Rule\nimport org.junit.Test\nimport retrofit2.helpers.ToStringConverterFactory\nimport retrofit2.http.GET\nimport retrofit2.http.HEAD\nimport retrofit2.http.Path\n\nclass KotlinSuspendTest {\n @get:Rule val server = MockWebServer()\n\n interface Service {\n @GET(\"/\")\n suspend fun body(): String\n\n @GET(\"/\")\n suspend fun bodyNullable(): String?\n\n @GET(\"/\")\n suspend fun response(): Response\n\n @GET(\"/\")\n suspend fun unit()\n\n @HEAD(\"/\")\n suspend fun headUnit()\n\n @GET(\"/{a}/{b}/{c}\")\n suspend fun params(\n @Path(\"a\") a: String,\n @Path(\"b\") b: String,\n @Path(\"c\") c: String,\n ): String\n\n @GET(\"/\")\n suspend fun bodyWithCallType(): Call\n }\n\n @Test fun body() {\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(ToStringConverterFactory())\n .build()\n val example = retrofit.create(Service::class.java)\n\n server.enqueue(MockResponse().setBody(\"Hi\"))\n\n val body = runBlocking { example.body() }\n assertThat(body).isEqualTo(\"Hi\")\n }\n\n @Test fun body404() {\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(ToStringConverterFactory())\n .build()\n val example = retrofit.create(Service::class.java)\n\n server.enqueue(MockResponse().setResponseCode(404))\n\n try {\n runBlocking { example.body() }\n fail()\n } catch (e: HttpException) {\n assertThat(e.code()).isEqualTo(404)\n }\n }\n\n @Test fun bodyFailure() {\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(ToStringConverterFactory())\n .build()\n val example = retrofit.create(Service::class.java)\n\n server.enqueue(MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST))\n\n try {\n runBlocking { example.body() }\n fail()\n } catch (e: IOException) {\n }\n }\n\n @Test fun bodyThrowsOnNull() {\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(ToStringConverterFactory())\n .build()\n val example = retrofit.create(Service::class.java)\n\n server.enqueue(MockResponse().setResponseCode(204))\n\n try {\n runBlocking { example.body() }\n fail()\n } catch (e: KotlinNullPointerException) {\n // Coroutines wraps exceptions with a synthetic trace so fall back to cause message.\n val message = e.message ?: (e.cause as KotlinNullPointerException).message\n assertThat(message).isEqualTo(\n \"Response from retrofit2.KotlinSuspendTest\\$Service.body was null but response body type was declared as non-null\",\n )\n }\n }\n\n @Ignore(\"Not working yet\")\n @Test\n fun bodyNullable() {\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(ToStringConverterFactory())\n .build()\n val example = retrofit.create(Service::class.java)\n\n server.enqueue(MockResponse().setResponseCode(204))\n\n val body = runBlocking { example.bodyNullable() }\n assertThat(body).isNull()\n }\n\n @Test fun response() {\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(ToStringConverterFactory())\n .build()\n val example = retrofit.create(Service::class.java)\n\n server.enqueue(MockResponse().setBody(\"Hi\"))\n\n val response = runBlocking { example.response() }\n assertThat(response.code()).isEqualTo(200)\n assertThat(response.body()).isEqualTo(\"Hi\")\n }\n\n @Test fun response404() {\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(ToStringConverterFactory())\n .build()\n val example = retrofit.create(Service::class.java)\n\n server.enqueue(MockResponse().setResponseCode(404))\n\n val response = runBlocking { example.response() }\n assertThat(response.code()).isEqualTo(404)\n }\n\n @Test fun responseFailure() {\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(ToStringConverterFactory())\n .build()\n val example = retrofit.create(Service::class.java)\n\n server.enqueue(MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST))\n\n try {\n runBlocking { example.response() }\n fail()\n } catch (e: IOException) {\n }\n }\n\n @Test fun unit() {\n val retrofit = Retrofit.Builder().baseUrl(server.url(\"/\")).build()\n val example = retrofit.create(Service::class.java)\n server.enqueue(MockResponse().setBody(\"Unit\"))\n runBlocking { example.unit() }\n }\n\n @Test fun unitNullableBody() {\n val retrofit = Retrofit.Builder().baseUrl(server.url(\"/\")).build()\n val example = retrofit.create(Service::class.java)\n server.enqueue(MockResponse().setResponseCode(204))\n runBlocking { example.unit() }\n }\n\n @Test fun headUnit() {\n val retrofit = Retrofit.Builder().baseUrl(server.url(\"/\")).build()\n val example = retrofit.create(Service::class.java)\n server.enqueue(MockResponse())\n runBlocking { example.headUnit() }\n }\n\n @Test fun params() {\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(ToStringConverterFactory())\n .build()\n val example = retrofit.create(Service::class.java)\n\n server.enqueue(MockResponse())\n\n runBlocking { example.params(\"1\", \"2\", \"3\") }\n val request = server.takeRequest()\n assertThat(request.path).isEqualTo(\"/1/2/3\")\n }\n\n @Test fun cancelationWorks() {\n lateinit var call: okhttp3.Call\n\n val okHttpClient = OkHttpClient()\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .callFactory {\n val newCall = okHttpClient.newCall(it)\n call = newCall\n newCall\n }\n .addConverterFactory(ToStringConverterFactory())\n .build()\n val example = retrofit.create(Service::class.java)\n\n // This leaves the connection open indefinitely allowing us to cancel without racing a body.\n server.enqueue(MockResponse().setSocketPolicy(NO_RESPONSE))\n\n val deferred = GlobalScope.async { example.body() }\n\n // This will block until the server has received the request ensuring it's in flight.\n server.takeRequest()\n\n deferred.cancel()\n assertTrue(call.isCanceled())\n }\n\n @Test fun doesNotUseCallbackExecutor() {\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .callbackExecutor { fail() }\n .addConverterFactory(ToStringConverterFactory())\n .build()\n val example = retrofit.create(Service::class.java)\n\n server.enqueue(MockResponse().setBody(\"Hi\"))\n\n val body = runBlocking { example.body() }\n assertThat(body).isEqualTo(\"Hi\")\n }\n\n @Test fun usesCallAdapterForCall() {\n val callAdapterFactory = object : CallAdapter.Factory() {\n override fun get(\n returnType: Type,\n annotations: Array,\n retrofit: Retrofit,\n ): CallAdapter<*, *>? {\n if (getRawType(returnType) != Call::class.java) {\n return null\n }\n if (getParameterUpperBound(0, returnType as ParameterizedType) != String::class.java) {\n return null\n }\n return object : CallAdapter> {\n override fun responseType() = String::class.java\n override fun adapt(call: Call): Call {\n return object : Call by call {\n override fun enqueue(callback: Callback) {\n call.enqueue(object : Callback by callback {\n override fun onResponse(call: Call, response: Response) {\n if (response.isSuccessful) {\n callback.onResponse(call, Response.success(response.body()?.repeat(5)))\n } else {\n callback.onResponse(call, response)\n }\n }\n })\n }\n }\n }\n }\n }\n }\n\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addCallAdapterFactory(callAdapterFactory)\n .addConverterFactory(ToStringConverterFactory())\n .build()\n val example = retrofit.create(Service::class.java)\n\n server.enqueue(MockResponse().setBody(\"Hi\"))\n\n val body = runBlocking { example.body() }\n assertThat(body).isEqualTo(\"HiHiHiHiHi\")\n }\n\n @Test fun checkedExceptionsAreNotSynchronouslyThrownForBody() = runBlocking {\n val retrofit = Retrofit.Builder()\n .baseUrl(\"https://unresolved-host.com/\")\n .addConverterFactory(ToStringConverterFactory())\n .build()\n val example = retrofit.create(Service::class.java)\n\n server.shutdown()\n\n // Run with a dispatcher that prevents yield from actually deferring work. An old workaround\n // for this problem relied on yield, but it is not guaranteed to prevent direct execution.\n withContext(DirectUnconfinedDispatcher) {\n // The problematic behavior of the UnknownHostException being synchronously thrown is\n // probabilistic based on thread preemption. Running a thousand times will almost always\n // trigger it, so we run an order of magnitude more to be safe.\n repeat(10000) {\n try {\n example.body()\n fail()\n } catch (_: IOException) {\n // We expect IOException, the bad behavior will wrap this in UndeclaredThrowableException.\n }\n }\n }\n }\n\n @Test fun checkedExceptionsAreNotSynchronouslyThrownForResponse() = runBlocking {\n val retrofit = Retrofit.Builder()\n .baseUrl(\"https://unresolved-host.com/\")\n .addConverterFactory(ToStringConverterFactory())\n .build()\n val example = retrofit.create(Service::class.java)\n\n server.shutdown()\n\n // Run with a dispatcher that prevents yield from actually deferring work. An old workaround\n // for this problem relied on yield, but it is not guaranteed to prevent direct execution.\n withContext(DirectUnconfinedDispatcher) {\n // The problematic behavior of the UnknownHostException being synchronously thrown is\n // probabilistic based on thread preemption. Running a thousand times will almost always\n // trigger it, so we run an order of magnitude more to be safe.\n repeat(10000) {\n try {\n example.response()\n fail()\n } catch (_: IOException) {\n // We expect IOException, the bad behavior will wrap this in UndeclaredThrowableException.\n }\n }\n }\n }\n\n @Test fun rejectCallReturnTypeWhenUsingSuspend() {\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(ToStringConverterFactory())\n .build()\n val example = retrofit.create(Service::class.java)\n\n try {\n runBlocking { example.bodyWithCallType() }\n fail()\n } catch (e: IllegalArgumentException) {\n assertThat(e).hasMessageThat().isEqualTo(\n \"Suspend functions should not return Call, as they already execute asynchronously.\\n\" +\n \"Change its return type to class java.lang.String\\n\" +\n \" for method Service.bodyWithCallType\",\n )\n }\n }\n\n @Suppress(\"EXPERIMENTAL_OVERRIDE\")\n private object DirectUnconfinedDispatcher : CoroutineDispatcher() {\n override fun isDispatchNeeded(context: CoroutineContext): Boolean = false\n override fun dispatch(context: CoroutineContext, block: Runnable) = block.run()\n }\n}\n" }, { "path": "retrofit/kotlin-test/src/test/java/retrofit2/KotlinUnitTest.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static com.google.common.truth.Truth.assertThat;\n\nimport java.io.IOException;\nimport kotlin.Unit;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.http.GET;\nimport retrofit2.http.HEAD;\n\npublic final class KotlinUnitTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\")\n Call empty();\n\n @HEAD(\"/\")\n Call head();\n }\n\n @Test\n public void unitGet() throws IOException {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n Response response = example.empty().execute();\n assertThat(response.isSuccessful()).isTrue();\n assertThat(response.body()).isSameInstanceAs(Unit.INSTANCE);\n }\n\n @Test\n public void unitHead() throws IOException {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(server.url(\"/\")).build();\n Service example = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n Response response = example.head().execute();\n assertThat(response.isSuccessful()).isTrue();\n assertThat(response.body()).isSameInstanceAs(Unit.INSTANCE);\n }\n}\n" }, { "path": "retrofit/robovm-test/build.gradle", "content": "// Normally we want all buildscript classpath dependencies to be at the root so that they\n// participate in a single round of dependency resolution. However, the RoboVM plugin\n// bundles outdated dependencies like BouncyCastle that are essential to other plugins (namely, AGP)\n// without shading them into a new package. Moving it to this project works around this problem.\nbuildscript {\n dependencies {\n classpath libs.robovmPlugin\n }\n repositories {\n mavenCentral()\n }\n}\n\napply plugin: 'java'\napply plugin: 'robovm'\n\next.mainClassName = 'retrofit2.RoboVmPlatformTest'\n\nrobovm {\n archs = 'x86_64'\n}\n\ndependencies {\n implementation projects.retrofit\n implementation libs.robovm\n}\n\ntask robovmTest(type: Exec) {\n dependsOn {\n robovmInstall\n }\n commandLine './build/robovm/retrofit2.RoboVmPlatformTest'\n}\n" }, { "path": "retrofit/robovm-test/src/main/java/retrofit2/RoboVmPlatformTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\npublic final class RoboVmPlatformTest {\n public static void main(String[] args) {\n Retrofit retrofit = new Retrofit.Builder()\n .baseUrl(\"https://example.com\")\n .callFactory(c -> { throw new AssertionError(); })\n .build();\n\n if (retrofit.callAdapterFactories().size() > 1) {\n // Everyone gets the callback executor adapter. If RoboVM was correctly detected it will NOT\n // get the Java 8-supporting CompletableFuture call adapter factory.\n System.exit(1);\n }\n }\n\n private RoboVmPlatformTest() {\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/AndroidMainExecutor.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport android.os.Handler;\nimport android.os.Looper;\nimport java.util.concurrent.Executor;\n\nfinal class AndroidMainExecutor implements Executor {\n private final Handler handler = new Handler(Looper.getMainLooper());\n\n @Override\n public void execute(Runnable r) {\n handler.post(r);\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/BuiltInConverters.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport kotlin.Unit;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.http.Streaming;\n\nfinal class BuiltInConverters extends Converter.Factory {\n\n @Override\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n if (type == ResponseBody.class) {\n return Utils.isAnnotationPresent(annotations, Streaming.class)\n ? StreamingResponseBodyConverter.INSTANCE\n : BufferingResponseBodyConverter.INSTANCE;\n }\n if (type == Void.class) {\n return VoidResponseBodyConverter.INSTANCE;\n }\n if (Utils.isUnit(type)) {\n return UnitResponseBodyConverter.INSTANCE;\n }\n return null;\n }\n\n @Override\n public @Nullable Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n if (RequestBody.class.isAssignableFrom(Utils.getRawType(type))) {\n return RequestBodyConverter.INSTANCE;\n }\n return null;\n }\n\n static final class VoidResponseBodyConverter implements Converter {\n static final VoidResponseBodyConverter INSTANCE = new VoidResponseBodyConverter();\n\n @Override\n public Void convert(ResponseBody value) {\n value.close();\n return null;\n }\n }\n\n static final class UnitResponseBodyConverter implements Converter {\n static final UnitResponseBodyConverter INSTANCE = new UnitResponseBodyConverter();\n\n @Override\n public Unit convert(ResponseBody value) {\n value.close();\n return Unit.INSTANCE;\n }\n }\n\n static final class RequestBodyConverter implements Converter {\n static final RequestBodyConverter INSTANCE = new RequestBodyConverter();\n\n @Override\n public RequestBody convert(RequestBody value) {\n return value;\n }\n }\n\n static final class StreamingResponseBodyConverter\n implements Converter {\n static final StreamingResponseBodyConverter INSTANCE = new StreamingResponseBodyConverter();\n\n @Override\n public ResponseBody convert(ResponseBody value) {\n return value;\n }\n }\n\n static final class BufferingResponseBodyConverter\n implements Converter {\n static final BufferingResponseBodyConverter INSTANCE = new BufferingResponseBodyConverter();\n\n @Override\n public ResponseBody convert(ResponseBody value) throws IOException {\n try {\n // Buffer the entire body to avoid future I/O.\n return Utils.buffer(value);\n } finally {\n value.close();\n }\n }\n }\n\n static final class ToStringConverter implements Converter {\n static final ToStringConverter INSTANCE = new ToStringConverter();\n\n @Override\n public String convert(Object value) {\n return value.toString();\n }\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/BuiltInFactories.java", "content": "/*\n * Copyright (C) 2024 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static java.util.Arrays.asList;\nimport static java.util.Collections.emptyList;\nimport static java.util.Collections.singletonList;\n\nimport android.annotation.TargetApi;\nimport java.util.List;\nimport java.util.concurrent.Executor;\nimport javax.annotation.Nullable;\n\nclass BuiltInFactories {\n List createDefaultCallAdapterFactories(\n @Nullable Executor callbackExecutor) {\n return singletonList(new DefaultCallAdapterFactory(callbackExecutor));\n }\n\n List createDefaultConverterFactories() {\n return emptyList();\n }\n\n @TargetApi(24)\n static final class Java8 extends BuiltInFactories {\n @Override\n List createDefaultCallAdapterFactories(\n @Nullable Executor callbackExecutor) {\n return asList(\n new CompletableFutureCallAdapterFactory(),\n new DefaultCallAdapterFactory(callbackExecutor));\n }\n\n @Override\n List createDefaultConverterFactories() {\n return singletonList(new OptionalConverterFactory());\n }\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/Call.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.io.IOException;\nimport okhttp3.Request;\nimport okio.Timeout;\n\n/**\n * An invocation of a Retrofit method that sends a request to a webserver and returns a response.\n * Each call yields its own HTTP request and response pair. Use {@link #clone} to make multiple\n * calls with the same parameters to the same webserver; this may be used to implement polling or to\n * retry a failed call.\n *\n *

Calls may be executed synchronously with {@link #execute}, or asynchronously with {@link\n * #enqueue}. In either case the call can be canceled at any time with {@link #cancel}. A call that\n * is busy writing its request or reading its response may receive a {@link IOException}; this is\n * working as designed.\n *\n * @param Successful response body type.\n */\npublic interface Call extends Cloneable {\n /**\n * Synchronously send the request and return its response.\n *\n * @throws IOException if a problem occurred talking to the server.\n * @throws RuntimeException (and subclasses) if an unexpected error occurs creating the request or\n * decoding the response.\n */\n Response execute() throws IOException;\n\n /**\n * Asynchronously send the request and notify {@code callback} of its response or if an error\n * occurred talking to the server, creating the request, or processing the response.\n */\n void enqueue(Callback callback);\n\n /**\n * Returns true if this call has been either {@linkplain #execute() executed} or {@linkplain\n * #enqueue(Callback) enqueued}. It is an error to execute or enqueue a call more than once.\n */\n boolean isExecuted();\n\n /**\n * Cancel this call. An attempt will be made to cancel in-flight calls, and if the call has not\n * yet been executed it never will be.\n */\n void cancel();\n\n /** True if {@link #cancel()} was called. */\n boolean isCanceled();\n\n /**\n * Create a new, identical call to this one which can be enqueued or executed even if this call\n * has already been.\n */\n Call clone();\n\n /** The original HTTP request. */\n Request request();\n\n /**\n * Returns a timeout that spans the entire call: resolving DNS, connecting, writing the request\n * body, server processing, and reading the response body. If the call requires redirects or\n * retries all must complete within one timeout period.\n */\n Timeout timeout();\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/CallAdapter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\n\n/**\n * Adapts a {@link Call} with response type {@code R} into the type of {@code T}. Instances are\n * created by {@linkplain Factory a factory} which is {@linkplain\n * Retrofit.Builder#addCallAdapterFactory(Factory) installed} into the {@link Retrofit} instance.\n */\npublic interface CallAdapter {\n /**\n * Returns the value type that this adapter uses when converting the HTTP response body to a Java\n * object. For example, the response type for {@code Call} is {@code Repo}. This type is\n * used to prepare the {@code call} passed to {@code #adapt}.\n *\n *

Note: This is typically not the same type as the {@code returnType} provided to this call\n * adapter's factory.\n */\n Type responseType();\n\n /**\n * Returns an instance of {@code T} which delegates to {@code call}.\n *\n *

For example, given an instance for a hypothetical utility, {@code Async}, this instance\n * would return a new {@code Async} which invoked {@code call} when run.\n *\n * 

\n   * @Override\n   * public <R> Async<R> adapt(final Call<R> call) {\n   *   return Async.create(new Callable<Response<R>>() {\n   *     @Override\n   *     public Response<R> call() throws Exception {\n   *       return call.execute();\n   *     }\n   *   });\n   * }\n   *
\n */\n T adapt(Call call);\n\n /**\n * Creates {@link CallAdapter} instances based on the return type of {@linkplain\n * Retrofit#create(Class) the service interface} methods.\n */\n abstract class Factory {\n /**\n * Returns a call adapter for interface methods that return {@code returnType}, or null if it\n * cannot be handled by this factory.\n */\n public abstract @Nullable CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit);\n\n /**\n * Extract the upper bound of the generic parameter at {@code index} from {@code type}. For\n * example, index 1 of {@code Map} returns {@code Runnable}.\n */\n protected static Type getParameterUpperBound(int index, ParameterizedType type) {\n return Utils.getParameterUpperBound(index, type);\n }\n\n /**\n * Extract the raw class type from {@code type}. For example, the type representing {@code\n * List} returns {@code List.class}.\n */\n protected static Class getRawType(Type type) {\n return Utils.getRawType(type);\n }\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/Callback.java", "content": "/*\n * Copyright (C) 2012 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\n/**\n * Communicates responses from a server or offline requests. One and only one method will be invoked\n * in response to a given request.\n *\n *

Callback methods are executed using the {@link Retrofit} callback executor. When none is\n * specified, the following defaults are used:\n *\n *

    \n *
  • Android: Callbacks are executed on the application's main (UI) thread.\n *
  • JVM: Callbacks are executed on the background thread which performed the request.\n *
\n *\n * @param Successful response body type.\n */\npublic interface Callback {\n /**\n * Invoked for a received HTTP response.\n *\n *

Note: An HTTP response may still indicate an application-level failure such as a 404 or 500.\n * Call {@link Response#isSuccessful()} to determine if the response indicates success.\n */\n void onResponse(Call call, Response response);\n\n /**\n * Invoked when a network exception occurred talking to the server or when an unexpected exception\n * occurred creating the request or processing the response.\n */\n void onFailure(Call call, Throwable t);\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/CompletableFutureCallAdapterFactory.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport android.annotation.TargetApi;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport java.util.concurrent.CompletableFuture;\nimport javax.annotation.Nullable;\nimport org.codehaus.mojo.animal_sniffer.IgnoreJRERequirement;\n\n@IgnoreJRERequirement // Only added when CompletableFuture is available (Java 8+ / Android API 24+).\n@TargetApi(24)\nfinal class CompletableFutureCallAdapterFactory extends CallAdapter.Factory {\n @Override\n public @Nullable CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n if (getRawType(returnType) != CompletableFuture.class) {\n return null;\n }\n if (!(returnType instanceof ParameterizedType)) {\n throw new IllegalStateException(\n \"CompletableFuture return type must be parameterized\"\n + \" as CompletableFuture or CompletableFuture\");\n }\n Type innerType = getParameterUpperBound(0, (ParameterizedType) returnType);\n\n if (getRawType(innerType) != Response.class) {\n // Generic type is not Response. Use it for body-only adapter.\n return new BodyCallAdapter<>(innerType);\n }\n\n // Generic type is Response. Extract T and create the Response version of the adapter.\n if (!(innerType instanceof ParameterizedType)) {\n throw new IllegalStateException(\n \"Response must be parameterized\" + \" as Response or Response\");\n }\n Type responseType = getParameterUpperBound(0, (ParameterizedType) innerType);\n return new ResponseCallAdapter<>(responseType);\n }\n\n @IgnoreJRERequirement\n private static final class BodyCallAdapter implements CallAdapter> {\n private final Type responseType;\n\n BodyCallAdapter(Type responseType) {\n this.responseType = responseType;\n }\n\n @Override\n public Type responseType() {\n return responseType;\n }\n\n @Override\n public CompletableFuture adapt(final Call call) {\n CompletableFuture future = new CallCancelCompletableFuture<>(call);\n call.enqueue(new BodyCallback(future));\n return future;\n }\n\n @IgnoreJRERequirement\n private class BodyCallback implements Callback {\n private final CompletableFuture future;\n\n public BodyCallback(CompletableFuture future) {\n this.future = future;\n }\n\n @Override\n public void onResponse(Call call, Response response) {\n if (response.isSuccessful()) {\n future.complete(response.body());\n } else {\n future.completeExceptionally(new HttpException(response));\n }\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n future.completeExceptionally(t);\n }\n }\n }\n\n @IgnoreJRERequirement\n private static final class ResponseCallAdapter\n implements CallAdapter>> {\n private final Type responseType;\n\n ResponseCallAdapter(Type responseType) {\n this.responseType = responseType;\n }\n\n @Override\n public Type responseType() {\n return responseType;\n }\n\n @Override\n public CompletableFuture> adapt(final Call call) {\n CompletableFuture> future = new CallCancelCompletableFuture<>(call);\n call.enqueue(new ResponseCallback(future));\n return future;\n }\n\n @IgnoreJRERequirement\n private class ResponseCallback implements Callback {\n private final CompletableFuture> future;\n\n public ResponseCallback(CompletableFuture> future) {\n this.future = future;\n }\n\n @Override\n public void onResponse(Call call, Response response) {\n future.complete(response);\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n future.completeExceptionally(t);\n }\n }\n }\n\n @IgnoreJRERequirement\n private static final class CallCancelCompletableFuture extends CompletableFuture {\n private final Call call;\n\n CallCancelCompletableFuture(Call call) {\n this.call = call;\n }\n\n @Override\n public boolean cancel(boolean mayInterruptIfRunning) {\n if (mayInterruptIfRunning) {\n call.cancel();\n }\n return super.cancel(mayInterruptIfRunning);\n }\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/Converter.java", "content": "/*\n * Copyright (C) 2012 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.http.Body;\nimport retrofit2.http.Field;\nimport retrofit2.http.FieldMap;\nimport retrofit2.http.Header;\nimport retrofit2.http.HeaderMap;\nimport retrofit2.http.Part;\nimport retrofit2.http.PartMap;\nimport retrofit2.http.Path;\nimport retrofit2.http.Query;\nimport retrofit2.http.QueryMap;\n\n/**\n * Convert objects to and from their representation in HTTP. Instances are created by {@linkplain\n * Factory a factory} which is {@linkplain Retrofit.Builder#addConverterFactory(Factory) installed}\n * into the {@link Retrofit} instance.\n */\npublic interface Converter {\n @Nullable\n T convert(F value) throws IOException;\n\n /** Creates {@link Converter} instances based on a type and target usage. */\n abstract class Factory {\n /**\n * Returns a {@link Converter} for converting an HTTP response body to {@code type}, or null if\n * {@code type} cannot be handled by this factory. This is used to create converters for\n * response types such as {@code SimpleResponse} from a {@code Call}\n * declaration.\n */\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return null;\n }\n\n /**\n * Returns a {@link Converter} for converting {@code type} to an HTTP request body, or null if\n * {@code type} cannot be handled by this factory. This is used to create converters for types\n * specified by {@link Body @Body}, {@link Part @Part}, and {@link PartMap @PartMap} values.\n */\n public @Nullable Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n return null;\n }\n\n /**\n * Returns a {@link Converter} for converting {@code type} to a {@link String}, or null if\n * {@code type} cannot be handled by this factory. This is used to create converters for types\n * specified by {@link Field @Field}, {@link FieldMap @FieldMap} values, {@link Header @Header},\n * {@link HeaderMap @HeaderMap}, {@link Path @Path}, {@link Query @Query}, and {@link\n * QueryMap @QueryMap} values.\n */\n public @Nullable Converter stringConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return null;\n }\n\n /**\n * Extract the upper bound of the generic parameter at {@code index} from {@code type}. For\n * example, index 1 of {@code Map} returns {@code Runnable}.\n */\n protected static Type getParameterUpperBound(int index, ParameterizedType type) {\n return Utils.getParameterUpperBound(index, type);\n }\n\n /**\n * Extract the raw class type from {@code type}. For example, the type representing {@code\n * List} returns {@code List.class}.\n */\n protected static Class getRawType(Type type) {\n return Utils.getRawType(type);\n }\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/DefaultCallAdapterFactory.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport java.util.Objects;\nimport java.util.concurrent.Executor;\nimport javax.annotation.Nullable;\nimport okhttp3.Request;\nimport okio.Timeout;\n\nfinal class DefaultCallAdapterFactory extends CallAdapter.Factory {\n private final @Nullable Executor callbackExecutor;\n\n DefaultCallAdapterFactory(@Nullable Executor callbackExecutor) {\n this.callbackExecutor = callbackExecutor;\n }\n\n @Override\n public @Nullable CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n if (getRawType(returnType) != Call.class) {\n return null;\n }\n if (!(returnType instanceof ParameterizedType)) {\n throw new IllegalArgumentException(\n \"Call return type must be parameterized as Call or Call\");\n }\n final Type responseType = Utils.getParameterUpperBound(0, (ParameterizedType) returnType);\n\n final Executor executor =\n Utils.isAnnotationPresent(annotations, SkipCallbackExecutor.class)\n ? null\n : callbackExecutor;\n\n return new CallAdapter>() {\n @Override\n public Type responseType() {\n return responseType;\n }\n\n @Override\n public Call adapt(Call call) {\n return executor == null ? call : new ExecutorCallbackCall<>(executor, call);\n }\n };\n }\n\n static final class ExecutorCallbackCall implements Call {\n final Executor callbackExecutor;\n final Call delegate;\n\n ExecutorCallbackCall(Executor callbackExecutor, Call delegate) {\n this.callbackExecutor = callbackExecutor;\n this.delegate = delegate;\n }\n\n @Override\n public void enqueue(final Callback callback) {\n Objects.requireNonNull(callback, \"callback == null\");\n\n delegate.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, final Response response) {\n callbackExecutor.execute(\n () -> {\n if (delegate.isCanceled()) {\n // Emulate OkHttp's behavior of throwing/delivering an IOException on\n // cancellation.\n callback.onFailure(ExecutorCallbackCall.this, new IOException(\"Canceled\"));\n } else {\n callback.onResponse(ExecutorCallbackCall.this, response);\n }\n });\n }\n\n @Override\n public void onFailure(Call call, final Throwable t) {\n callbackExecutor.execute(() -> callback.onFailure(ExecutorCallbackCall.this, t));\n }\n });\n }\n\n @Override\n public boolean isExecuted() {\n return delegate.isExecuted();\n }\n\n @Override\n public Response execute() throws IOException {\n return delegate.execute();\n }\n\n @Override\n public void cancel() {\n delegate.cancel();\n }\n\n @Override\n public boolean isCanceled() {\n return delegate.isCanceled();\n }\n\n @SuppressWarnings(\"CloneDoesntCallSuperClone\") // Performing deep clone.\n @Override\n public Call clone() {\n return new ExecutorCallbackCall<>(callbackExecutor, delegate.clone());\n }\n\n @Override\n public Request request() {\n return delegate.request();\n }\n\n @Override\n public Timeout timeout() {\n return delegate.timeout();\n }\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/DefaultMethodSupport.java", "content": "/*\n * Copyright (C) 2024 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.lang.invoke.MethodHandles.Lookup;\nimport java.lang.reflect.Constructor;\nimport java.lang.reflect.Method;\nimport javax.annotation.Nullable;\nimport org.codehaus.mojo.animal_sniffer.IgnoreJRERequirement;\n\n/**\n * From Java 8 to Java 13, the only way to invoke a default method on a proxied interface is by\n * reflectively creating a trusted {@link Lookup} to invoke a method handle.\n *

\n * Note: This class has multi-release jar variants for newer versions of Java.\n */\nfinal class DefaultMethodSupport {\n private static @Nullable Constructor lookupConstructor;\n\n @IgnoreJRERequirement // Only used on JVM or Android API 24+.\n @Nullable\n static Object invoke(\n Method method, Class declaringClass, Object proxy, @Nullable Object[] args)\n throws Throwable {\n Constructor constructor = lookupConstructor;\n if (constructor == null) {\n constructor = Lookup.class.getDeclaredConstructor(Class.class, int.class);\n constructor.setAccessible(true);\n lookupConstructor = constructor;\n }\n return constructor\n .newInstance(declaringClass, -1 /* trusted */)\n .unreflectSpecial(method, declaringClass)\n .bindTo(proxy)\n .invokeWithArguments(args);\n }\n\n private DefaultMethodSupport() {}\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/HttpException.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.util.Objects;\nimport javax.annotation.Nullable;\n\n/** Exception for an unexpected, non-2xx HTTP response. */\npublic class HttpException extends RuntimeException {\n private static String getMessage(Response response) {\n Objects.requireNonNull(response, \"response == null\");\n return \"HTTP \" + response.code() + \" \" + response.message();\n }\n\n private final int code;\n private final String message;\n private final transient Response response;\n\n public HttpException(Response response) {\n super(getMessage(response));\n this.code = response.code();\n this.message = response.message();\n this.response = response;\n }\n\n /** HTTP status code. */\n public int code() {\n return code;\n }\n\n /** HTTP status message. */\n public String message() {\n return message;\n }\n\n /** The full HTTP response. This may be null if the exception was serialized. */\n public @Nullable Response response() {\n return response;\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/HttpServiceMethod.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static retrofit2.Utils.getRawType;\nimport static retrofit2.Utils.methodError;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Method;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport kotlin.Unit;\nimport kotlin.coroutines.Continuation;\nimport okhttp3.ResponseBody;\n\n/** Adapts an invocation of an interface method into an HTTP call. */\nabstract class HttpServiceMethod extends ServiceMethod {\n /**\n * Inspects the annotations on an interface method to construct a reusable service method that\n * speaks HTTP. This requires potentially-expensive reflection so it is best to build each service\n * method only once and reuse it.\n */\n static HttpServiceMethod parseAnnotations(\n Retrofit retrofit, Method method, RequestFactory requestFactory) {\n boolean isKotlinSuspendFunction = requestFactory.isKotlinSuspendFunction;\n boolean continuationWantsResponse = false;\n boolean continuationBodyNullable = false;\n boolean continuationIsUnit = false;\n\n Annotation[] annotations = method.getAnnotations();\n Type adapterType;\n if (isKotlinSuspendFunction) {\n Type[] parameterTypes = method.getGenericParameterTypes();\n Type responseType =\n Utils.getParameterLowerBound(\n 0, (ParameterizedType) parameterTypes[parameterTypes.length - 1]);\n if (getRawType(responseType) == Response.class && responseType instanceof ParameterizedType) {\n // Unwrap the actual body type from Response.\n responseType = Utils.getParameterUpperBound(0, (ParameterizedType) responseType);\n continuationWantsResponse = true;\n } else {\n if (getRawType(responseType) == Call.class) {\n throw methodError(\n method,\n \"Suspend functions should not return Call, as they already execute asynchronously.\\n\"\n + \"Change its return type to %s\",\n Utils.getParameterUpperBound(0, (ParameterizedType) responseType));\n }\n\n continuationIsUnit = Utils.isUnit(responseType);\n // TODO figure out if type is nullable or not\n // Metadata metadata = method.getDeclaringClass().getAnnotation(Metadata.class)\n // Find the entry for method\n // Determine if return type is nullable or not\n }\n\n adapterType = new Utils.ParameterizedTypeImpl(null, Call.class, responseType);\n annotations = SkipCallbackExecutorImpl.ensurePresent(annotations);\n } else {\n adapterType = method.getGenericReturnType();\n }\n\n CallAdapter callAdapter =\n createCallAdapter(retrofit, method, adapterType, annotations);\n Type responseType = callAdapter.responseType();\n if (responseType == okhttp3.Response.class) {\n throw methodError(\n method,\n \"'\"\n + getRawType(responseType).getName()\n + \"' is not a valid response body type. Did you mean ResponseBody?\");\n }\n if (responseType == Response.class) {\n throw methodError(method, \"Response must include generic type (e.g., Response)\");\n }\n if (requestFactory.httpMethod.equals(\"HEAD\")\n && !Void.class.equals(responseType)\n && !Utils.isUnit(responseType)) {\n throw methodError(method, \"HEAD method must use Void or Unit as response type.\");\n }\n\n Converter responseConverter =\n createResponseConverter(retrofit, method, responseType);\n\n okhttp3.Call.Factory callFactory = retrofit.callFactory;\n if (!isKotlinSuspendFunction) {\n return new CallAdapted<>(requestFactory, callFactory, responseConverter, callAdapter);\n } else if (continuationWantsResponse) {\n //noinspection unchecked Kotlin compiler guarantees ReturnT to be Object.\n return (HttpServiceMethod)\n new SuspendForResponse<>(\n requestFactory,\n callFactory,\n responseConverter,\n (CallAdapter>) callAdapter);\n } else {\n //noinspection unchecked Kotlin compiler guarantees ReturnT to be Object.\n return (HttpServiceMethod)\n new SuspendForBody<>(\n requestFactory,\n callFactory,\n responseConverter,\n (CallAdapter>) callAdapter,\n continuationBodyNullable,\n continuationIsUnit);\n }\n }\n\n private static CallAdapter createCallAdapter(\n Retrofit retrofit, Method method, Type returnType, Annotation[] annotations) {\n try {\n //noinspection unchecked\n return (CallAdapter) retrofit.callAdapter(returnType, annotations);\n } catch (RuntimeException e) { // Wide exception range because factories are user code.\n throw methodError(method, e, \"Unable to create call adapter for %s\", returnType);\n }\n }\n\n private static Converter createResponseConverter(\n Retrofit retrofit, Method method, Type responseType) {\n Annotation[] annotations = method.getAnnotations();\n try {\n return retrofit.responseBodyConverter(responseType, annotations);\n } catch (RuntimeException e) { // Wide exception range because factories are user code.\n throw methodError(method, e, \"Unable to create converter for %s\", responseType);\n }\n }\n\n private final RequestFactory requestFactory;\n private final okhttp3.Call.Factory callFactory;\n private final Converter responseConverter;\n\n HttpServiceMethod(\n RequestFactory requestFactory,\n okhttp3.Call.Factory callFactory,\n Converter responseConverter) {\n this.requestFactory = requestFactory;\n this.callFactory = callFactory;\n this.responseConverter = responseConverter;\n }\n\n @Override\n final @Nullable ReturnT invoke(Object instance, Object[] args) {\n Call call =\n new OkHttpCall<>(requestFactory, instance, args, callFactory, responseConverter);\n return adapt(call, args);\n }\n\n protected abstract @Nullable ReturnT adapt(Call call, Object[] args);\n\n static final class CallAdapted extends HttpServiceMethod {\n private final CallAdapter callAdapter;\n\n CallAdapted(\n RequestFactory requestFactory,\n okhttp3.Call.Factory callFactory,\n Converter responseConverter,\n CallAdapter callAdapter) {\n super(requestFactory, callFactory, responseConverter);\n this.callAdapter = callAdapter;\n }\n\n @Override\n protected ReturnT adapt(Call call, Object[] args) {\n return callAdapter.adapt(call);\n }\n }\n\n static final class SuspendForResponse extends HttpServiceMethod {\n private final CallAdapter> callAdapter;\n\n SuspendForResponse(\n RequestFactory requestFactory,\n okhttp3.Call.Factory callFactory,\n Converter responseConverter,\n CallAdapter> callAdapter) {\n super(requestFactory, callFactory, responseConverter);\n this.callAdapter = callAdapter;\n }\n\n @Override\n protected Object adapt(Call call, Object[] args) {\n call = callAdapter.adapt(call);\n\n //noinspection unchecked Checked by reflection inside RequestFactory.\n Continuation> continuation =\n (Continuation>) args[args.length - 1];\n\n // See SuspendForBody for explanation about this try/catch.\n try {\n return KotlinExtensions.awaitResponse(call, continuation);\n } catch (Exception e) {\n return KotlinExtensions.suspendAndThrow(e, continuation);\n }\n }\n }\n\n static final class SuspendForBody extends HttpServiceMethod {\n private final CallAdapter> callAdapter;\n private final boolean isNullable;\n private final boolean isUnit;\n\n SuspendForBody(\n RequestFactory requestFactory,\n okhttp3.Call.Factory callFactory,\n Converter responseConverter,\n CallAdapter> callAdapter,\n boolean isNullable,\n boolean isUnit) {\n super(requestFactory, callFactory, responseConverter);\n this.callAdapter = callAdapter;\n this.isNullable = isNullable;\n this.isUnit = isUnit;\n }\n\n @Override\n protected Object adapt(Call call, Object[] args) {\n call = callAdapter.adapt(call);\n\n //noinspection unchecked Checked by reflection inside RequestFactory.\n Continuation continuation = (Continuation) args[args.length - 1];\n\n // Calls to OkHttp Call.enqueue() like those inside await and awaitNullable can sometimes\n // invoke the supplied callback with an exception before the invoking stack frame can return.\n // Coroutines will intercept the subsequent invocation of the Continuation and throw the\n // exception synchronously. A Java Proxy cannot throw checked exceptions without them being\n // declared on the interface method. To avoid the synchronous checked exception being wrapped\n // in an UndeclaredThrowableException, it is intercepted and supplied to a helper which will\n // force suspension to occur so that it can be instead delivered to the continuation to\n // bypass this restriction.\n try {\n if (isUnit) {\n //noinspection unchecked Checked by isUnit\n return KotlinExtensions.awaitUnit((Call) call, (Continuation) continuation);\n } else if (isNullable) {\n return KotlinExtensions.awaitNullable(call, continuation);\n } else {\n return KotlinExtensions.await(call, continuation);\n }\n } catch (VirtualMachineError | ThreadDeath | LinkageError e) {\n // Do not attempt to capture fatal throwables. This list is derived RxJava's `throwIfFatal`.\n throw e;\n } catch (Throwable e) {\n return KotlinExtensions.suspendAndThrow(e, continuation);\n }\n }\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/Invocation.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.lang.reflect.Method;\nimport java.util.ArrayList;\nimport java.util.Collections;\nimport java.util.List;\nimport java.util.Objects;\nimport javax.annotation.Nullable;\n\n/**\n * A single invocation of a Retrofit service interface method. This class captures both the method\n * that was called and the arguments to the method.\n *\n *

Retrofit automatically adds an invocation to each OkHttp request as a tag. You can retrieve\n * the invocation in an OkHttp interceptor for metrics and monitoring.\n *\n * 

\n * class InvocationLogger implements Interceptor {\n *   @Override public Response intercept(Chain chain) throws IOException {\n *     Request request = chain.request();\n *     Invocation invocation = request.tag(Invocation.class);\n *     if (invocation != null) {\n *       System.out.printf(\"%s.%s %s%n\",\n *           invocation.service().getSimpleName(),\n *           invocation.method().getName(),\n *           invocation.arguments());\n *     }\n *     return chain.proceed(request);\n *   }\n * }\n *
\n *\n * Note: use caution when examining an invocation's arguments. Although the\n * arguments list is unmodifiable, the arguments themselves may be mutable. They may also be unsafe\n * for concurrent access. For best results declare Retrofit service interfaces using only immutable\n * types for parameters!\n */\npublic final class Invocation {\n public static Invocation of(\n Class service,\n T instance,\n Method method,\n List arguments,\n @Nullable String annotationUrl) {\n Objects.requireNonNull(service, \"service == null\");\n Objects.requireNonNull(instance, \"instance == null\");\n Objects.requireNonNull(method, \"method == null\");\n Objects.requireNonNull(arguments, \"arguments == null\");\n // Make a defensive copy of arguments.\n return new Invocation(service, instance, method, new ArrayList<>(arguments), annotationUrl);\n }\n\n public static Invocation of(Class service, T instance, Method method, List arguments) {\n return of(service, instance, method, arguments, null);\n }\n\n @Deprecated\n public static Invocation of(Method method, List arguments) {\n Objects.requireNonNull(method, \"method == null\");\n Objects.requireNonNull(arguments, \"arguments == null\");\n // Make a defensive copy of arguments.\n return new Invocation(\n method.getDeclaringClass(), null, method, new ArrayList<>(arguments), null);\n }\n\n private final Class service;\n @Nullable private final Object instance;\n private final Method method;\n private final List arguments;\n @Nullable private final String annotationUrl;\n\n /** Trusted constructor assumes ownership of {@code arguments}. */\n Invocation(\n Class service,\n @Nullable Object instance,\n Method method,\n List arguments,\n @Nullable String annotationUrl) {\n this.service = service;\n this.instance = instance;\n this.method = method;\n this.arguments = Collections.unmodifiableList(arguments);\n this.annotationUrl = annotationUrl;\n }\n\n public Class service() {\n return service;\n }\n\n /**\n * The instance of {@link #service}.\n *

\n * This will never be null when created by Retrofit. Null will only be returned when created\n * by {@link #of(Method, List)}.\n */\n @Nullable\n public Object instance() {\n return instance;\n }\n\n public Method method() {\n return method;\n }\n\n public List arguments() {\n return arguments;\n }\n\n /**\n * The URL from the annotation like {@link retrofit2.http.GET @GET} or\n * {@link retrofit2.http.POST @POST}.\n *

\n * If the method uses the {@link retrofit2.http.Path @Path} annotation, this is the template URL\n * before path substitution, as it occurs in source code.\n *

\n * This value will be null if one of the method's parameter is annotated\n * {@link retrofit2.http.Url @Url}. It will also be null if this Invocation was created using one\n * of the {@linkplain #of factory-functions} that don't have this value.\n */\n @Nullable\n public String annotationUrl() {\n return annotationUrl;\n }\n\n @Override\n public String toString() {\n return String.format(\"%s.%s() %s\", service.getName(), method.getName(), arguments);\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/KotlinExtensions.kt", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n@file:JvmName(\"KotlinExtensions\")\n\npackage retrofit2\n\nimport kotlin.coroutines.intrinsics.COROUTINE_SUSPENDED\nimport kotlin.coroutines.intrinsics.intercepted\nimport kotlin.coroutines.intrinsics.suspendCoroutineUninterceptedOrReturn\nimport kotlin.coroutines.resume\nimport kotlin.coroutines.resumeWithException\nimport kotlinx.coroutines.Dispatchers\nimport kotlinx.coroutines.suspendCancellableCoroutine\n\ninline fun Retrofit.create(): T = create(T::class.java)\n\nsuspend fun Call.await(): T {\n return suspendCancellableCoroutine { continuation ->\n continuation.invokeOnCancellation { cancel() }\n enqueue(\n object : Callback {\n override fun onResponse(call: Call, response: Response) {\n if (response.isSuccessful) {\n val body = response.body()\n if (body == null) {\n val invocation = call.request().tag(Invocation::class.java)!!\n val service = invocation.service()\n val method = invocation.method()\n val e =\n KotlinNullPointerException(\n \"Response from ${service.name}.${method.name}\" +\n \" was null but response body type was declared as non-null\"\n )\n continuation.resumeWithException(e)\n } else {\n continuation.resume(body)\n }\n } else {\n continuation.resumeWithException(HttpException(response))\n }\n }\n\n override fun onFailure(call: Call, t: Throwable) {\n continuation.resumeWithException(t)\n }\n }\n )\n }\n}\n\n@JvmName(\"awaitNullable\")\nsuspend fun Call.await(): T? {\n return suspendCancellableCoroutine { continuation ->\n continuation.invokeOnCancellation { cancel() }\n enqueue(\n object : Callback {\n override fun onResponse(call: Call, response: Response) {\n if (response.isSuccessful) {\n continuation.resume(response.body())\n } else {\n continuation.resumeWithException(HttpException(response))\n }\n }\n\n override fun onFailure(call: Call, t: Throwable) {\n continuation.resumeWithException(t)\n }\n }\n )\n }\n}\n\n@JvmName(\"awaitUnit\")\nsuspend fun Call.await() {\n @Suppress(\"UNCHECKED_CAST\") (this as Call).await()\n}\n\nsuspend fun Call.awaitResponse(): Response {\n return suspendCancellableCoroutine { continuation ->\n continuation.invokeOnCancellation { cancel() }\n enqueue(\n object : Callback {\n override fun onResponse(call: Call, response: Response) {\n continuation.resume(response)\n }\n\n override fun onFailure(call: Call, t: Throwable) {\n continuation.resumeWithException(t)\n }\n }\n )\n }\n}\n\n/**\n * Force the calling coroutine to suspend before throwing [this].\n *\n * This is needed when a checked exception is synchronously caught in a [java.lang.reflect.Proxy]\n * invocation to avoid being wrapped in [java.lang.reflect.UndeclaredThrowableException].\n *\n * The implementation is derived from:\n * https://github.com/Kotlin/kotlinx.coroutines/pull/1667#issuecomment-556106349\n */\ninternal suspend fun Throwable.suspendAndThrow(): Nothing {\n suspendCoroutineUninterceptedOrReturn { continuation ->\n Dispatchers.Default.dispatch(continuation.context) {\n continuation.intercepted().resumeWithException(this@suspendAndThrow)\n }\n COROUTINE_SUSPENDED\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/OkHttpCall.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static retrofit2.Utils.throwIfFatal;\n\nimport java.io.IOException;\nimport java.util.Objects;\nimport javax.annotation.Nullable;\nimport javax.annotation.concurrent.GuardedBy;\nimport okhttp3.MediaType;\nimport okhttp3.Request;\nimport okhttp3.ResponseBody;\nimport okio.Buffer;\nimport okio.BufferedSource;\nimport okio.ForwardingSource;\nimport okio.Okio;\nimport okio.Timeout;\n\nfinal class OkHttpCall implements Call {\n private final RequestFactory requestFactory;\n private final Object instance;\n private final Object[] args;\n private final okhttp3.Call.Factory callFactory;\n private final Converter responseConverter;\n\n private volatile boolean canceled;\n\n @GuardedBy(\"this\")\n private @Nullable okhttp3.Call rawCall;\n\n @GuardedBy(\"this\") // Either a RuntimeException, non-fatal Error, or IOException.\n private @Nullable Throwable creationFailure;\n\n @GuardedBy(\"this\")\n private boolean executed;\n\n OkHttpCall(\n RequestFactory requestFactory,\n Object instance,\n Object[] args,\n okhttp3.Call.Factory callFactory,\n Converter responseConverter) {\n this.requestFactory = requestFactory;\n this.instance = instance;\n this.args = args;\n this.callFactory = callFactory;\n this.responseConverter = responseConverter;\n }\n\n @SuppressWarnings(\"CloneDoesntCallSuperClone\") // We are a final type & this saves clearing state.\n @Override\n public OkHttpCall clone() {\n return new OkHttpCall<>(requestFactory, instance, args, callFactory, responseConverter);\n }\n\n @Override\n public synchronized Request request() {\n try {\n return getRawCall().request();\n } catch (IOException e) {\n throw new RuntimeException(\"Unable to create request.\", e);\n }\n }\n\n @Override\n public synchronized Timeout timeout() {\n try {\n return getRawCall().timeout();\n } catch (IOException e) {\n throw new RuntimeException(\"Unable to create call.\", e);\n }\n }\n\n /**\n * Returns the raw call, initializing it if necessary. Throws if initializing the raw call throws,\n * or has thrown in previous attempts to create it.\n */\n @GuardedBy(\"this\")\n private okhttp3.Call getRawCall() throws IOException {\n okhttp3.Call call = rawCall;\n if (call != null) return call;\n\n // Re-throw previous failures if this isn't the first attempt.\n if (creationFailure != null) {\n if (creationFailure instanceof IOException) {\n throw (IOException) creationFailure;\n } else if (creationFailure instanceof RuntimeException) {\n throw (RuntimeException) creationFailure;\n } else {\n throw (Error) creationFailure;\n }\n }\n\n // Create and remember either the success or the failure.\n try {\n return rawCall = createRawCall();\n } catch (RuntimeException | Error | IOException e) {\n throwIfFatal(e); // Do not assign a fatal error to creationFailure.\n creationFailure = e;\n throw e;\n }\n }\n\n @Override\n public void enqueue(final Callback callback) {\n Objects.requireNonNull(callback, \"callback == null\");\n\n okhttp3.Call call;\n Throwable failure;\n\n synchronized (this) {\n if (executed) throw new IllegalStateException(\"Already executed.\");\n executed = true;\n\n call = rawCall;\n failure = creationFailure;\n if (call == null && failure == null) {\n try {\n call = rawCall = createRawCall();\n } catch (Throwable t) {\n throwIfFatal(t);\n failure = creationFailure = t;\n }\n }\n }\n\n if (failure != null) {\n callback.onFailure(this, failure);\n return;\n }\n\n if (canceled) {\n call.cancel();\n }\n\n call.enqueue(\n new okhttp3.Callback() {\n @Override\n public void onResponse(okhttp3.Call call, okhttp3.Response rawResponse) {\n Response response;\n try {\n response = parseResponse(rawResponse);\n } catch (Throwable e) {\n throwIfFatal(e);\n callFailure(e);\n return;\n }\n\n try {\n callback.onResponse(OkHttpCall.this, response);\n } catch (Throwable t) {\n throwIfFatal(t);\n t.printStackTrace(); // TODO this is not great\n }\n }\n\n @Override\n public void onFailure(okhttp3.Call call, IOException e) {\n callFailure(e);\n }\n\n private void callFailure(Throwable e) {\n try {\n callback.onFailure(OkHttpCall.this, e);\n } catch (Throwable t) {\n throwIfFatal(t);\n t.printStackTrace(); // TODO this is not great\n }\n }\n });\n }\n\n @Override\n public synchronized boolean isExecuted() {\n return executed;\n }\n\n @Override\n public Response execute() throws IOException {\n okhttp3.Call call;\n\n synchronized (this) {\n if (executed) throw new IllegalStateException(\"Already executed.\");\n executed = true;\n\n call = getRawCall();\n }\n\n if (canceled) {\n call.cancel();\n }\n\n return parseResponse(call.execute());\n }\n\n private okhttp3.Call createRawCall() throws IOException {\n okhttp3.Call call = callFactory.newCall(requestFactory.create(instance, args));\n if (call == null) {\n throw new NullPointerException(\"Call.Factory returned null.\");\n }\n return call;\n }\n\n Response parseResponse(okhttp3.Response rawResponse) throws IOException {\n ResponseBody rawBody = rawResponse.body();\n\n // Remove the body's source (the only stateful object) so we can pass the response along.\n rawResponse =\n rawResponse\n .newBuilder()\n .body(new NoContentResponseBody(rawBody.contentType(), rawBody.contentLength()))\n .build();\n\n int code = rawResponse.code();\n if (code < 200 || code >= 300) {\n try {\n // Buffer the entire body to avoid future I/O.\n ResponseBody bufferedBody = Utils.buffer(rawBody);\n return Response.error(bufferedBody, rawResponse);\n } finally {\n rawBody.close();\n }\n }\n\n if (code == 204 || code == 205) {\n rawBody.close();\n return Response.success(null, rawResponse);\n }\n\n ExceptionCatchingResponseBody catchingBody = new ExceptionCatchingResponseBody(rawBody);\n try {\n T body = responseConverter.convert(catchingBody);\n return Response.success(body, rawResponse);\n } catch (RuntimeException e) {\n // If the underlying source threw an exception, propagate that rather than indicating it was\n // a runtime exception.\n catchingBody.throwIfCaught();\n throw e;\n }\n }\n\n @Override\n public void cancel() {\n canceled = true;\n\n okhttp3.Call call;\n synchronized (this) {\n call = rawCall;\n }\n if (call != null) {\n call.cancel();\n }\n }\n\n @Override\n public boolean isCanceled() {\n if (canceled) {\n return true;\n }\n synchronized (this) {\n return rawCall != null && rawCall.isCanceled();\n }\n }\n\n static final class NoContentResponseBody extends ResponseBody {\n private final @Nullable MediaType contentType;\n private final long contentLength;\n\n NoContentResponseBody(@Nullable MediaType contentType, long contentLength) {\n this.contentType = contentType;\n this.contentLength = contentLength;\n }\n\n @Override\n public MediaType contentType() {\n return contentType;\n }\n\n @Override\n public long contentLength() {\n return contentLength;\n }\n\n @Override\n public BufferedSource source() {\n throw new IllegalStateException(\"Cannot read raw response body of a converted body.\");\n }\n }\n\n static final class ExceptionCatchingResponseBody extends ResponseBody {\n private final ResponseBody delegate;\n private final BufferedSource delegateSource;\n @Nullable IOException thrownException;\n\n ExceptionCatchingResponseBody(ResponseBody delegate) {\n this.delegate = delegate;\n this.delegateSource =\n Okio.buffer(\n new ForwardingSource(delegate.source()) {\n @Override\n public long read(Buffer sink, long byteCount) throws IOException {\n try {\n return super.read(sink, byteCount);\n } catch (IOException e) {\n thrownException = e;\n throw e;\n }\n }\n });\n }\n\n @Override\n public MediaType contentType() {\n return delegate.contentType();\n }\n\n @Override\n public long contentLength() {\n return delegate.contentLength();\n }\n\n @Override\n public BufferedSource source() {\n return delegateSource;\n }\n\n @Override\n public void close() {\n delegate.close();\n }\n\n void throwIfCaught() throws IOException {\n if (thrownException != null) {\n throw thrownException;\n }\n }\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/OptionalConverterFactory.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport android.annotation.TargetApi;\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport java.util.Optional;\nimport javax.annotation.Nullable;\nimport okhttp3.ResponseBody;\nimport org.codehaus.mojo.animal_sniffer.IgnoreJRERequirement;\n\n/**\n * A {@link Converter.Factory} which supports Java's {@link Optional} to wrap null values from\n * another converter.\n *

\n * This factory is installed by default on the JVM and Android API 24+. If you are using another\n * converter which tries to serialize all types, such as Moshi or Gson, the default installation\n * of this factory never gets a chance to run. To work around this, you can explicitly install this\n * factory before your serialization library converter.\n */\n@IgnoreJRERequirement // Only added when Optional is available (Java 8+ / Android API 24+).\n@TargetApi(24)\npublic final class OptionalConverterFactory extends Converter.Factory {\n public static OptionalConverterFactory create() {\n return new OptionalConverterFactory();\n }\n\n OptionalConverterFactory() {}\n\n @Override\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n if (getRawType(type) != Optional.class) {\n return null;\n }\n\n Type innerType = getParameterUpperBound(0, (ParameterizedType) type);\n Converter delegate =\n retrofit.responseBodyConverter(innerType, annotations);\n return new OptionalConverter<>(delegate);\n }\n\n @IgnoreJRERequirement\n static final class OptionalConverter implements Converter> {\n private final Converter delegate;\n\n OptionalConverter(Converter delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public Optional convert(ResponseBody value) throws IOException {\n return Optional.ofNullable(delegate.convert(value));\n }\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/ParameterHandler.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.io.IOException;\nimport java.lang.reflect.Array;\nimport java.lang.reflect.Method;\nimport java.util.Map;\nimport java.util.Objects;\nimport javax.annotation.Nullable;\nimport okhttp3.MultipartBody;\nimport okhttp3.RequestBody;\n\nabstract class ParameterHandler {\n abstract void apply(RequestBuilder builder, @Nullable T value) throws IOException;\n\n final ParameterHandler> iterable() {\n return new ParameterHandler>() {\n @Override\n void apply(RequestBuilder builder, @Nullable Iterable values) throws IOException {\n if (values == null) return; // Skip null values.\n\n for (T value : values) {\n ParameterHandler.this.apply(builder, value);\n }\n }\n };\n }\n\n final ParameterHandler array() {\n return new ParameterHandler() {\n @Override\n void apply(RequestBuilder builder, @Nullable Object values) throws IOException {\n if (values == null) return; // Skip null values.\n\n for (int i = 0, size = Array.getLength(values); i < size; i++) {\n //noinspection unchecked\n ParameterHandler.this.apply(builder, (T) Array.get(values, i));\n }\n }\n };\n }\n\n static final class RelativeUrl extends ParameterHandler {\n private final Method method;\n private final int p;\n\n RelativeUrl(Method method, int p) {\n this.method = method;\n this.p = p;\n }\n\n @Override\n void apply(RequestBuilder builder, @Nullable Object value) {\n if (value == null) {\n throw Utils.parameterError(method, p, \"@Url parameter is null.\");\n }\n builder.setRelativeUrl(value);\n }\n }\n\n static final class Header extends ParameterHandler {\n private final String name;\n private final Converter valueConverter;\n private final boolean allowUnsafeNonAsciiValues;\n\n Header(String name, Converter valueConverter, boolean allowUnsafeNonAsciiValues) {\n this.name = Objects.requireNonNull(name, \"name == null\");\n this.valueConverter = valueConverter;\n this.allowUnsafeNonAsciiValues = allowUnsafeNonAsciiValues;\n }\n\n @Override\n void apply(RequestBuilder builder, @Nullable T value) throws IOException {\n if (value == null) return; // Skip null values.\n\n String headerValue = valueConverter.convert(value);\n if (headerValue == null) return; // Skip converted but null values.\n\n builder.addHeader(name, headerValue, allowUnsafeNonAsciiValues);\n }\n }\n\n static final class Path extends ParameterHandler {\n private final Method method;\n private final int p;\n private final String name;\n private final Converter valueConverter;\n private final boolean encoded;\n\n Path(Method method, int p, String name, Converter valueConverter, boolean encoded) {\n this.method = method;\n this.p = p;\n this.name = Objects.requireNonNull(name, \"name == null\");\n this.valueConverter = valueConverter;\n this.encoded = encoded;\n }\n\n @Override\n void apply(RequestBuilder builder, @Nullable T value) throws IOException {\n if (value == null) {\n throw Utils.parameterError(\n method, p, \"Path parameter \\\"\" + name + \"\\\" value must not be null.\");\n }\n builder.addPathParam(name, valueConverter.convert(value), encoded);\n }\n }\n\n static final class Query extends ParameterHandler {\n private final String name;\n private final Converter valueConverter;\n private final boolean encoded;\n\n Query(String name, Converter valueConverter, boolean encoded) {\n this.name = Objects.requireNonNull(name, \"name == null\");\n this.valueConverter = valueConverter;\n this.encoded = encoded;\n }\n\n @Override\n void apply(RequestBuilder builder, @Nullable T value) throws IOException {\n if (value == null) return; // Skip null values.\n\n String queryValue = valueConverter.convert(value);\n if (queryValue == null) return; // Skip converted but null values\n\n builder.addQueryParam(name, queryValue, encoded);\n }\n }\n\n static final class QueryName extends ParameterHandler {\n private final Converter nameConverter;\n private final boolean encoded;\n\n QueryName(Converter nameConverter, boolean encoded) {\n this.nameConverter = nameConverter;\n this.encoded = encoded;\n }\n\n @Override\n void apply(RequestBuilder builder, @Nullable T value) throws IOException {\n if (value == null) return; // Skip null values.\n builder.addQueryParam(nameConverter.convert(value), null, encoded);\n }\n }\n\n static final class QueryMap extends ParameterHandler> {\n private final Method method;\n private final int p;\n private final Converter valueConverter;\n private final boolean encoded;\n\n QueryMap(Method method, int p, Converter valueConverter, boolean encoded) {\n this.method = method;\n this.p = p;\n this.valueConverter = valueConverter;\n this.encoded = encoded;\n }\n\n @Override\n void apply(RequestBuilder builder, @Nullable Map value) throws IOException {\n if (value == null) {\n throw Utils.parameterError(method, p, \"Query map was null\");\n }\n\n for (Map.Entry entry : value.entrySet()) {\n String entryKey = entry.getKey();\n if (entryKey == null) {\n throw Utils.parameterError(method, p, \"Query map contained null key.\");\n }\n T entryValue = entry.getValue();\n if (entryValue == null) {\n throw Utils.parameterError(\n method, p, \"Query map contained null value for key '\" + entryKey + \"'.\");\n }\n\n String convertedEntryValue = valueConverter.convert(entryValue);\n if (convertedEntryValue == null) {\n throw Utils.parameterError(\n method,\n p,\n \"Query map value '\"\n + entryValue\n + \"' converted to null by \"\n + valueConverter.getClass().getName()\n + \" for key '\"\n + entryKey\n + \"'.\");\n }\n\n builder.addQueryParam(entryKey, convertedEntryValue, encoded);\n }\n }\n }\n\n static final class HeaderMap extends ParameterHandler> {\n private final Method method;\n private final int p;\n private final Converter valueConverter;\n private final boolean allowUnsafeNonAsciiValues;\n\n HeaderMap(\n Method method,\n int p,\n Converter valueConverter,\n boolean allowUnsafeNonAsciiValues) {\n this.method = method;\n this.p = p;\n this.valueConverter = valueConverter;\n this.allowUnsafeNonAsciiValues = allowUnsafeNonAsciiValues;\n }\n\n @Override\n void apply(RequestBuilder builder, @Nullable Map value) throws IOException {\n if (value == null) {\n throw Utils.parameterError(method, p, \"Header map was null.\");\n }\n\n for (Map.Entry entry : value.entrySet()) {\n String headerName = entry.getKey();\n if (headerName == null) {\n throw Utils.parameterError(method, p, \"Header map contained null key.\");\n }\n T headerValue = entry.getValue();\n if (headerValue == null) {\n throw Utils.parameterError(\n method, p, \"Header map contained null value for key '\" + headerName + \"'.\");\n }\n builder.addHeader(\n headerName, valueConverter.convert(headerValue), allowUnsafeNonAsciiValues);\n }\n }\n }\n\n static final class Headers extends ParameterHandler {\n private final Method method;\n private final int p;\n\n Headers(Method method, int p) {\n this.method = method;\n this.p = p;\n }\n\n @Override\n void apply(RequestBuilder builder, @Nullable okhttp3.Headers headers) {\n if (headers == null) {\n throw Utils.parameterError(method, p, \"Headers parameter must not be null.\");\n }\n builder.addHeaders(headers);\n }\n }\n\n static final class Field extends ParameterHandler {\n private final String name;\n private final Converter valueConverter;\n private final boolean encoded;\n\n Field(String name, Converter valueConverter, boolean encoded) {\n this.name = Objects.requireNonNull(name, \"name == null\");\n this.valueConverter = valueConverter;\n this.encoded = encoded;\n }\n\n @Override\n void apply(RequestBuilder builder, @Nullable T value) throws IOException {\n if (value == null) return; // Skip null values.\n\n String fieldValue = valueConverter.convert(value);\n if (fieldValue == null) return; // Skip null converted values\n\n builder.addFormField(name, fieldValue, encoded);\n }\n }\n\n static final class FieldMap extends ParameterHandler> {\n private final Method method;\n private final int p;\n private final Converter valueConverter;\n private final boolean encoded;\n\n FieldMap(Method method, int p, Converter valueConverter, boolean encoded) {\n this.method = method;\n this.p = p;\n this.valueConverter = valueConverter;\n this.encoded = encoded;\n }\n\n @Override\n void apply(RequestBuilder builder, @Nullable Map value) throws IOException {\n if (value == null) {\n throw Utils.parameterError(method, p, \"Field map was null.\");\n }\n\n for (Map.Entry entry : value.entrySet()) {\n String entryKey = entry.getKey();\n if (entryKey == null) {\n throw Utils.parameterError(method, p, \"Field map contained null key.\");\n }\n T entryValue = entry.getValue();\n if (entryValue == null) {\n throw Utils.parameterError(\n method, p, \"Field map contained null value for key '\" + entryKey + \"'.\");\n }\n\n String fieldEntry = valueConverter.convert(entryValue);\n if (fieldEntry == null) {\n throw Utils.parameterError(\n method,\n p,\n \"Field map value '\"\n + entryValue\n + \"' converted to null by \"\n + valueConverter.getClass().getName()\n + \" for key '\"\n + entryKey\n + \"'.\");\n }\n\n builder.addFormField(entryKey, fieldEntry, encoded);\n }\n }\n }\n\n static final class Part extends ParameterHandler {\n private final Method method;\n private final int p;\n private final okhttp3.Headers headers;\n private final Converter converter;\n\n Part(Method method, int p, okhttp3.Headers headers, Converter converter) {\n this.method = method;\n this.p = p;\n this.headers = headers;\n this.converter = converter;\n }\n\n @Override\n void apply(RequestBuilder builder, @Nullable T value) {\n if (value == null) return; // Skip null values.\n\n RequestBody body;\n try {\n body = converter.convert(value);\n } catch (IOException e) {\n throw Utils.parameterError(method, p, \"Unable to convert \" + value + \" to RequestBody\", e);\n }\n builder.addPart(headers, body);\n }\n }\n\n static final class RawPart extends ParameterHandler {\n static final RawPart INSTANCE = new RawPart();\n\n private RawPart() {}\n\n @Override\n void apply(RequestBuilder builder, @Nullable MultipartBody.Part value) {\n if (value != null) { // Skip null values.\n builder.addPart(value);\n }\n }\n }\n\n static final class PartMap extends ParameterHandler> {\n private final Method method;\n private final int p;\n private final Converter valueConverter;\n private final String transferEncoding;\n\n PartMap(\n Method method, int p, Converter valueConverter, String transferEncoding) {\n this.method = method;\n this.p = p;\n this.valueConverter = valueConverter;\n this.transferEncoding = transferEncoding;\n }\n\n @Override\n void apply(RequestBuilder builder, @Nullable Map value) throws IOException {\n if (value == null) {\n throw Utils.parameterError(method, p, \"Part map was null.\");\n }\n\n for (Map.Entry entry : value.entrySet()) {\n String entryKey = entry.getKey();\n if (entryKey == null) {\n throw Utils.parameterError(method, p, \"Part map contained null key.\");\n }\n T entryValue = entry.getValue();\n if (entryValue == null) {\n throw Utils.parameterError(\n method, p, \"Part map contained null value for key '\" + entryKey + \"'.\");\n }\n\n okhttp3.Headers headers =\n okhttp3.Headers.of(\n \"Content-Disposition\",\n \"form-data; name=\\\"\" + entryKey + \"\\\"\",\n \"Content-Transfer-Encoding\",\n transferEncoding);\n\n builder.addPart(headers, valueConverter.convert(entryValue));\n }\n }\n }\n\n static final class Body extends ParameterHandler {\n private final Method method;\n private final int p;\n private final Converter converter;\n\n Body(Method method, int p, Converter converter) {\n this.method = method;\n this.p = p;\n this.converter = converter;\n }\n\n @Override\n void apply(RequestBuilder builder, @Nullable T value) {\n if (value == null) {\n throw Utils.parameterError(method, p, \"Body parameter value must not be null.\");\n }\n RequestBody body;\n try {\n body = converter.convert(value);\n } catch (IOException e) {\n throw Utils.parameterError(method, e, p, \"Unable to convert \" + value + \" to RequestBody\");\n }\n builder.setBody(body);\n }\n }\n\n static final class Tag extends ParameterHandler {\n final Class cls;\n\n Tag(Class cls) {\n this.cls = cls;\n }\n\n @Override\n void apply(RequestBuilder builder, @Nullable T value) {\n builder.addTag(cls, value);\n }\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/Platform.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static android.os.Build.VERSION.SDK_INT;\n\nimport java.util.concurrent.Executor;\nimport javax.annotation.Nullable;\n\nfinal class Platform {\n static final @Nullable Executor callbackExecutor;\n static final Reflection reflection;\n static final BuiltInFactories builtInFactories;\n\n static {\n switch (System.getProperty(\"java.vm.name\")) {\n case \"Dalvik\":\n callbackExecutor = new AndroidMainExecutor();\n if (SDK_INT >= 24) {\n reflection = new Reflection.Android24();\n builtInFactories = new BuiltInFactories.Java8();\n } else {\n reflection = new Reflection();\n builtInFactories = new BuiltInFactories();\n }\n break;\n\n case \"RoboVM\":\n callbackExecutor = null;\n reflection = new Reflection();\n builtInFactories = new BuiltInFactories();\n break;\n\n default:\n callbackExecutor = null;\n reflection = new Reflection.Java8();\n builtInFactories = new BuiltInFactories.Java8();\n break;\n }\n }\n\n private Platform() {}\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/Reflection.java", "content": "/*\n * Copyright (C) 2024 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport android.annotation.TargetApi;\nimport android.os.Build;\nimport java.lang.reflect.Method;\nimport java.lang.reflect.Parameter;\nimport javax.annotation.Nullable;\nimport org.codehaus.mojo.animal_sniffer.IgnoreJRERequirement;\n\nclass Reflection {\n boolean isDefaultMethod(Method method) {\n return false;\n }\n\n @Nullable\n Object invokeDefaultMethod(\n Method method, Class declaringClass, Object proxy, @Nullable Object[] args)\n throws Throwable {\n throw new AssertionError();\n }\n\n String describeMethodParameter(Method method, int index) {\n return \"parameter #\" + (index + 1);\n }\n\n @IgnoreJRERequirement // Only used on JVM.\n static class Java8 extends Reflection {\n @Override\n boolean isDefaultMethod(Method method) {\n return method.isDefault();\n }\n\n @Override\n Object invokeDefaultMethod(\n Method method, Class declaringClass, Object proxy, @Nullable Object[] args)\n throws Throwable {\n return DefaultMethodSupport.invoke(method, declaringClass, proxy, args);\n }\n\n @Override\n String describeMethodParameter(Method method, int index) {\n Parameter parameter = method.getParameters()[index];\n if (parameter.isNamePresent()) {\n return \"parameter '\" + parameter.getName() + '\\'';\n }\n return super.describeMethodParameter(method, index);\n }\n }\n\n /**\n * Android does not support MR jars, so this uses the Java 8 support class.\n * Default methods and the reflection API to detect them were added to API 24\n * as part of the initial Java 8 set. MethodHandle, our means of invoking the default method\n * through the proxy, was not added until API 26.\n */\n @TargetApi(24)\n @IgnoreJRERequirement // Only used on Android API 24+.\n static final class Android24 extends Reflection {\n @Override\n boolean isDefaultMethod(Method method) {\n return method.isDefault();\n }\n\n @Override\n Object invokeDefaultMethod(\n Method method, Class declaringClass, Object proxy, @Nullable Object[] args)\n throws Throwable {\n if (Build.VERSION.SDK_INT < 26) {\n throw new UnsupportedOperationException(\n \"Calling default methods on API 24 and 25 is not supported\");\n }\n return DefaultMethodSupport.invoke(method, declaringClass, proxy, args);\n }\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/RequestBuilder.java", "content": "/*\n * Copyright (C) 2012 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.io.IOException;\nimport java.util.regex.Pattern;\nimport javax.annotation.Nullable;\nimport okhttp3.FormBody;\nimport okhttp3.Headers;\nimport okhttp3.HttpUrl;\nimport okhttp3.MediaType;\nimport okhttp3.MultipartBody;\nimport okhttp3.Request;\nimport okhttp3.RequestBody;\nimport okio.Buffer;\nimport okio.BufferedSink;\n\nfinal class RequestBuilder {\n private static final char[] HEX_DIGITS = {\n '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'\n };\n private static final String PATH_SEGMENT_ALWAYS_ENCODE_SET = \" \\\"<>^`{}|\\\\?#\";\n\n /**\n * Matches strings that contain {@code .} or {@code ..} as a complete path segment. This also\n * matches dots in their percent-encoded form, {@code %2E}.\n *\n *

It is okay to have these strings within a larger path segment (like {@code a..z} or {@code\n * index.html}) but when alone they have a special meaning. A single dot resolves to no path\n * segment so {@code /one/./three/} becomes {@code /one/three/}. A double-dot pops the preceding\n * directory, so {@code /one/../three/} becomes {@code /three/}.\n *\n *

We forbid these in Retrofit paths because they're likely to have the unintended effect. For\n * example, passing {@code ..} to {@code DELETE /account/book/{isbn}/} yields {@code DELETE\n * /account/}.\n */\n private static final Pattern PATH_TRAVERSAL = Pattern.compile(\"(.*/)?(\\\\.|%2e|%2E){1,2}(/.*)?\");\n\n private final String method;\n\n private final HttpUrl baseUrl;\n private @Nullable String relativeUrl;\n private @Nullable HttpUrl.Builder urlBuilder;\n\n private final Request.Builder requestBuilder;\n private final Headers.Builder headersBuilder;\n private @Nullable MediaType contentType;\n\n private final boolean hasBody;\n private @Nullable MultipartBody.Builder multipartBuilder;\n private @Nullable FormBody.Builder formBuilder;\n private @Nullable RequestBody body;\n\n RequestBuilder(\n String method,\n HttpUrl baseUrl,\n @Nullable String relativeUrl,\n @Nullable Headers headers,\n @Nullable MediaType contentType,\n boolean hasBody,\n boolean isFormEncoded,\n boolean isMultipart) {\n this.method = method;\n this.baseUrl = baseUrl;\n this.relativeUrl = relativeUrl;\n this.requestBuilder = new Request.Builder();\n this.contentType = contentType;\n this.hasBody = hasBody;\n\n if (headers != null) {\n headersBuilder = headers.newBuilder();\n } else {\n headersBuilder = new Headers.Builder();\n }\n\n if (isFormEncoded) {\n // Will be set to 'body' in 'build'.\n formBuilder = new FormBody.Builder();\n } else if (isMultipart) {\n // Will be set to 'body' in 'build'.\n multipartBuilder = new MultipartBody.Builder();\n multipartBuilder.setType(MultipartBody.FORM);\n }\n }\n\n void setRelativeUrl(Object relativeUrl) {\n this.relativeUrl = relativeUrl.toString();\n }\n\n void addHeader(String name, String value, boolean allowUnsafeNonAsciiValues) {\n if (\"Content-Type\".equalsIgnoreCase(name)) {\n try {\n contentType = MediaType.get(value);\n } catch (IllegalArgumentException e) {\n throw new IllegalArgumentException(\"Malformed content type: \" + value, e);\n }\n } else if (allowUnsafeNonAsciiValues) {\n headersBuilder.addUnsafeNonAscii(name, value);\n } else {\n headersBuilder.add(name, value);\n }\n }\n\n void addHeaders(Headers headers) {\n headersBuilder.addAll(headers);\n }\n\n void addPathParam(String name, String value, boolean encoded) {\n if (relativeUrl == null) {\n // The relative URL is cleared when the first query parameter is set.\n throw new AssertionError();\n }\n String replacement = canonicalizeForPath(value, encoded);\n String newRelativeUrl = relativeUrl.replace(\"{\" + name + \"}\", replacement);\n if (PATH_TRAVERSAL.matcher(newRelativeUrl).matches()) {\n throw new IllegalArgumentException(\n \"@Path parameters shouldn't perform path traversal ('.' or '..'): \" + value);\n }\n relativeUrl = newRelativeUrl;\n }\n\n private static String canonicalizeForPath(String input, boolean alreadyEncoded) {\n int codePoint;\n for (int i = 0, limit = input.length(); i < limit; i += Character.charCount(codePoint)) {\n codePoint = input.codePointAt(i);\n if (codePoint < 0x20\n || codePoint >= 0x7f\n || PATH_SEGMENT_ALWAYS_ENCODE_SET.indexOf(codePoint) != -1\n || (!alreadyEncoded && (codePoint == '/' || codePoint == '%'))) {\n // Slow path: the character at i requires encoding!\n Buffer out = new Buffer();\n out.writeUtf8(input, 0, i);\n canonicalizeForPath(out, input, i, limit, alreadyEncoded);\n return out.readUtf8();\n }\n }\n\n // Fast path: no characters required encoding.\n return input;\n }\n\n private static void canonicalizeForPath(\n Buffer out, String input, int pos, int limit, boolean alreadyEncoded) {\n Buffer utf8Buffer = null; // Lazily allocated.\n int codePoint;\n for (int i = pos; i < limit; i += Character.charCount(codePoint)) {\n codePoint = input.codePointAt(i);\n if (alreadyEncoded\n && (codePoint == '\\t' || codePoint == '\\n' || codePoint == '\\f' || codePoint == '\\r')) {\n // Skip this character.\n } else if (codePoint < 0x20\n || codePoint >= 0x7f\n || PATH_SEGMENT_ALWAYS_ENCODE_SET.indexOf(codePoint) != -1\n || (!alreadyEncoded && (codePoint == '/' || codePoint == '%'))) {\n // Percent encode this character.\n if (utf8Buffer == null) {\n utf8Buffer = new Buffer();\n }\n utf8Buffer.writeUtf8CodePoint(codePoint);\n for (long j = 0, size = utf8Buffer.size(); j < size; j++) {\n int b = utf8Buffer.getByte(j) & 0xff;\n out.writeByte('%');\n out.writeByte(HEX_DIGITS[(b >> 4) & 0xf]);\n out.writeByte(HEX_DIGITS[b & 0xf]);\n }\n utf8Buffer.clear();\n } else {\n // This character doesn't need encoding. Just copy it over.\n out.writeUtf8CodePoint(codePoint);\n }\n }\n }\n\n void addQueryParam(String name, @Nullable String value, boolean encoded) {\n if (relativeUrl != null) {\n // Do a one-time combination of the built relative URL and the base URL.\n urlBuilder = baseUrl.newBuilder(relativeUrl);\n if (urlBuilder == null) {\n throw new IllegalArgumentException(\n \"Malformed URL. Base: \" + baseUrl + \", Relative: \" + relativeUrl);\n }\n relativeUrl = null;\n }\n\n if (encoded) {\n //noinspection ConstantConditions Checked to be non-null by above 'if' block.\n urlBuilder.addEncodedQueryParameter(name, value);\n } else {\n //noinspection ConstantConditions Checked to be non-null by above 'if' block.\n urlBuilder.addQueryParameter(name, value);\n }\n }\n\n @SuppressWarnings(\"ConstantConditions\") // Only called when isFormEncoded was true.\n void addFormField(String name, String value, boolean encoded) {\n if (encoded) {\n formBuilder.addEncoded(name, value);\n } else {\n formBuilder.add(name, value);\n }\n }\n\n @SuppressWarnings(\"ConstantConditions\") // Only called when isMultipart was true.\n void addPart(Headers headers, RequestBody body) {\n multipartBuilder.addPart(headers, body);\n }\n\n @SuppressWarnings(\"ConstantConditions\") // Only called when isMultipart was true.\n void addPart(MultipartBody.Part part) {\n multipartBuilder.addPart(part);\n }\n\n void setBody(RequestBody body) {\n this.body = body;\n }\n\n void addTag(Class cls, @Nullable T value) {\n requestBuilder.tag(cls, value);\n }\n\n Request.Builder get() {\n HttpUrl url;\n HttpUrl.Builder urlBuilder = this.urlBuilder;\n if (urlBuilder != null) {\n url = urlBuilder.build();\n } else {\n // No query parameters triggered builder creation, just combine the relative URL and base URL.\n //noinspection ConstantConditions Non-null if urlBuilder is null.\n url = baseUrl.resolve(relativeUrl);\n if (url == null) {\n throw new IllegalArgumentException(\n \"Malformed URL. Base: \" + baseUrl + \", Relative: \" + relativeUrl);\n }\n }\n\n RequestBody body = this.body;\n if (body == null) {\n // Try to pull from one of the builders.\n if (formBuilder != null) {\n body = formBuilder.build();\n } else if (multipartBuilder != null) {\n body = multipartBuilder.build();\n } else if (hasBody) {\n // Body is absent, make an empty body.\n body = RequestBody.create(null, new byte[0]);\n }\n }\n\n MediaType contentType = this.contentType;\n if (contentType != null) {\n if (body != null) {\n body = new ContentTypeOverridingRequestBody(body, contentType);\n } else {\n headersBuilder.add(\"Content-Type\", contentType.toString());\n }\n }\n\n return requestBuilder.url(url).headers(headersBuilder.build()).method(method, body);\n }\n\n private static class ContentTypeOverridingRequestBody extends RequestBody {\n private final RequestBody delegate;\n private final MediaType contentType;\n\n ContentTypeOverridingRequestBody(RequestBody delegate, MediaType contentType) {\n this.delegate = delegate;\n this.contentType = contentType;\n }\n\n @Override\n public MediaType contentType() {\n return contentType;\n }\n\n @Override\n public long contentLength() throws IOException {\n return delegate.contentLength();\n }\n\n @Override\n public void writeTo(BufferedSink sink) throws IOException {\n delegate.writeTo(sink);\n }\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/RequestFactory.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static retrofit2.Utils.methodError;\nimport static retrofit2.Utils.parameterError;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Method;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport java.net.URI;\nimport java.util.ArrayList;\nimport java.util.LinkedHashSet;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Set;\nimport java.util.regex.Matcher;\nimport java.util.regex.Pattern;\nimport javax.annotation.Nullable;\nimport kotlin.coroutines.Continuation;\nimport okhttp3.Headers;\nimport okhttp3.HttpUrl;\nimport okhttp3.MediaType;\nimport okhttp3.MultipartBody;\nimport okhttp3.RequestBody;\nimport retrofit2.http.Body;\nimport retrofit2.http.DELETE;\nimport retrofit2.http.Field;\nimport retrofit2.http.FieldMap;\nimport retrofit2.http.FormUrlEncoded;\nimport retrofit2.http.GET;\nimport retrofit2.http.HEAD;\nimport retrofit2.http.HTTP;\nimport retrofit2.http.Header;\nimport retrofit2.http.HeaderMap;\nimport retrofit2.http.Multipart;\nimport retrofit2.http.OPTIONS;\nimport retrofit2.http.PATCH;\nimport retrofit2.http.POST;\nimport retrofit2.http.PUT;\nimport retrofit2.http.Part;\nimport retrofit2.http.PartMap;\nimport retrofit2.http.Path;\nimport retrofit2.http.Query;\nimport retrofit2.http.QueryMap;\nimport retrofit2.http.QueryName;\nimport retrofit2.http.Tag;\nimport retrofit2.http.Url;\n\nfinal class RequestFactory {\n static RequestFactory parseAnnotations(Retrofit retrofit, Class service, Method method) {\n return new Builder(retrofit, service, method).build();\n }\n\n private final Class service;\n private final Method method;\n private final HttpUrl baseUrl;\n final String httpMethod;\n private final @Nullable String relativeUrl;\n private final @Nullable Headers headers;\n private final @Nullable MediaType contentType;\n private final boolean hasBody;\n private final boolean isFormEncoded;\n private final boolean isMultipart;\n private final ParameterHandler[] parameterHandlers;\n final boolean isKotlinSuspendFunction;\n\n RequestFactory(Builder builder) {\n service = builder.service;\n method = builder.method;\n baseUrl = builder.retrofit.baseUrl;\n httpMethod = builder.httpMethod;\n relativeUrl = builder.relativeUrl;\n headers = builder.headers;\n contentType = builder.contentType;\n hasBody = builder.hasBody;\n isFormEncoded = builder.isFormEncoded;\n isMultipart = builder.isMultipart;\n parameterHandlers = builder.parameterHandlers;\n isKotlinSuspendFunction = builder.isKotlinSuspendFunction;\n }\n\n okhttp3.Request create(@Nullable Object instance, Object[] args) throws IOException {\n @SuppressWarnings(\"unchecked\") // It is an error to invoke a method with the wrong arg types.\n ParameterHandler[] handlers = (ParameterHandler[]) parameterHandlers;\n\n int argumentCount = args.length;\n if (argumentCount != handlers.length) {\n throw new IllegalArgumentException(\n \"Argument count (\"\n + argumentCount\n + \") doesn't match expected count (\"\n + handlers.length\n + \")\");\n }\n\n RequestBuilder requestBuilder =\n new RequestBuilder(\n httpMethod,\n baseUrl,\n relativeUrl,\n headers,\n contentType,\n hasBody,\n isFormEncoded,\n isMultipart);\n\n if (isKotlinSuspendFunction) {\n // The Continuation is the last parameter and the handlers array contains null at that index.\n argumentCount--;\n }\n\n List argumentList = new ArrayList<>(argumentCount);\n for (int p = 0; p < argumentCount; p++) {\n argumentList.add(args[p]);\n handlers[p].apply(requestBuilder, args[p]);\n }\n\n return requestBuilder\n .get()\n .tag(Invocation.class, new Invocation(service, instance, method, argumentList, relativeUrl))\n .build();\n }\n\n /**\n * Inspects the annotations on an interface method to construct a reusable service method. This\n * requires potentially-expensive reflection so it is best to build each service method only once\n * and reuse it. Builders cannot be reused.\n */\n static final class Builder {\n // Upper and lower characters, digits, underscores, and hyphens, starting with a character.\n private static final String PARAM = \"[a-zA-Z][a-zA-Z0-9_-]*\";\n private static final Pattern PARAM_URL_REGEX = Pattern.compile(\"\\\\{(\" + PARAM + \")\\\\}\");\n private static final Pattern PARAM_NAME_REGEX = Pattern.compile(PARAM);\n\n final Retrofit retrofit;\n final Class service;\n final Method method;\n final Annotation[] methodAnnotations;\n final Annotation[][] parameterAnnotationsArray;\n final Type[] parameterTypes;\n\n boolean gotField;\n boolean gotPart;\n boolean gotBody;\n boolean gotPath;\n boolean gotQuery;\n boolean gotQueryName;\n boolean gotQueryMap;\n boolean gotUrl;\n @Nullable String httpMethod;\n boolean hasBody;\n boolean isFormEncoded;\n boolean isMultipart;\n @Nullable String relativeUrl;\n @Nullable Headers headers;\n @Nullable MediaType contentType;\n @Nullable Set relativeUrlParamNames;\n @Nullable ParameterHandler[] parameterHandlers;\n boolean isKotlinSuspendFunction;\n\n Builder(Retrofit retrofit, Class service, Method method) {\n this.retrofit = retrofit;\n this.service = service;\n this.method = method;\n this.methodAnnotations = method.getAnnotations();\n this.parameterTypes = method.getGenericParameterTypes();\n this.parameterAnnotationsArray = method.getParameterAnnotations();\n }\n\n RequestFactory build() {\n for (Annotation annotation : methodAnnotations) {\n parseMethodAnnotation(annotation);\n }\n\n if (httpMethod == null) {\n throw methodError(method, \"HTTP method annotation is required (e.g., @GET, @POST, etc.).\");\n }\n\n if (!hasBody) {\n if (isMultipart) {\n throw methodError(\n method,\n \"Multipart can only be specified on HTTP methods with request body (e.g., @POST).\");\n }\n if (isFormEncoded) {\n throw methodError(\n method,\n \"FormUrlEncoded can only be specified on HTTP methods with \"\n + \"request body (e.g., @POST).\");\n }\n }\n\n int parameterCount = parameterAnnotationsArray.length;\n parameterHandlers = new ParameterHandler[parameterCount];\n for (int p = 0, lastParameter = parameterCount - 1; p < parameterCount; p++) {\n parameterHandlers[p] =\n parseParameter(p, parameterTypes[p], parameterAnnotationsArray[p], p == lastParameter);\n }\n\n if (relativeUrl == null && !gotUrl) {\n throw methodError(method, \"Missing either @%s URL or @Url parameter.\", httpMethod);\n }\n if (!isFormEncoded && !isMultipart && !hasBody && gotBody) {\n throw methodError(method, \"Non-body HTTP method cannot contain @Body.\");\n }\n if (isFormEncoded && !gotField) {\n throw methodError(method, \"Form-encoded method must contain at least one @Field.\");\n }\n if (isMultipart && !gotPart) {\n throw methodError(method, \"Multipart method must contain at least one @Part.\");\n }\n\n return new RequestFactory(this);\n }\n\n private void parseMethodAnnotation(Annotation annotation) {\n if (annotation instanceof DELETE) {\n parseHttpMethodAndPath(\"DELETE\", ((DELETE) annotation).value(), false);\n } else if (annotation instanceof GET) {\n parseHttpMethodAndPath(\"GET\", ((GET) annotation).value(), false);\n } else if (annotation instanceof HEAD) {\n parseHttpMethodAndPath(\"HEAD\", ((HEAD) annotation).value(), false);\n } else if (annotation instanceof PATCH) {\n parseHttpMethodAndPath(\"PATCH\", ((PATCH) annotation).value(), true);\n } else if (annotation instanceof POST) {\n parseHttpMethodAndPath(\"POST\", ((POST) annotation).value(), true);\n } else if (annotation instanceof PUT) {\n parseHttpMethodAndPath(\"PUT\", ((PUT) annotation).value(), true);\n } else if (annotation instanceof OPTIONS) {\n parseHttpMethodAndPath(\"OPTIONS\", ((OPTIONS) annotation).value(), false);\n } else if (annotation instanceof HTTP) {\n HTTP http = (HTTP) annotation;\n parseHttpMethodAndPath(http.method(), http.path(), http.hasBody());\n } else if (annotation instanceof retrofit2.http.Headers) {\n retrofit2.http.Headers headers = (retrofit2.http.Headers) annotation;\n String[] headersToParse = headers.value();\n if (headersToParse.length == 0) {\n throw methodError(method, \"@Headers annotation is empty.\");\n }\n this.headers = parseHeaders(headersToParse, headers.allowUnsafeNonAsciiValues());\n } else if (annotation instanceof Multipart) {\n if (isFormEncoded) {\n throw methodError(method, \"Only one encoding annotation is allowed.\");\n }\n isMultipart = true;\n } else if (annotation instanceof FormUrlEncoded) {\n if (isMultipart) {\n throw methodError(method, \"Only one encoding annotation is allowed.\");\n }\n isFormEncoded = true;\n }\n }\n\n private void parseHttpMethodAndPath(String httpMethod, String value, boolean hasBody) {\n if (this.httpMethod != null) {\n throw methodError(\n method,\n \"Only one HTTP method is allowed. Found: %s and %s.\",\n this.httpMethod,\n httpMethod);\n }\n this.httpMethod = httpMethod;\n this.hasBody = hasBody;\n\n if (value.isEmpty()) {\n return;\n }\n\n // Get the relative URL path and existing query string, if present.\n int question = value.indexOf('?');\n if (question != -1 && question < value.length() - 1) {\n // Ensure the query string does not have any named parameters.\n String queryParams = value.substring(question + 1);\n Matcher queryParamMatcher = PARAM_URL_REGEX.matcher(queryParams);\n if (queryParamMatcher.find()) {\n throw methodError(\n method,\n \"URL query string \\\"%s\\\" must not have replace block. \"\n + \"For dynamic query parameters use @Query.\",\n queryParams);\n }\n }\n\n this.relativeUrl = value;\n this.relativeUrlParamNames = parsePathParameters(value);\n }\n\n private Headers parseHeaders(String[] headers, boolean allowUnsafeNonAsciiValues) {\n Headers.Builder builder = new Headers.Builder();\n for (String header : headers) {\n int colon = header.indexOf(':');\n if (colon == -1 || colon == 0 || colon == header.length() - 1) {\n throw methodError(\n method, \"@Headers value must be in the form \\\"Name: Value\\\". Found: \\\"%s\\\"\", header);\n }\n String headerName = header.substring(0, colon);\n String headerValue = header.substring(colon + 1).trim();\n if (\"Content-Type\".equalsIgnoreCase(headerName)) {\n try {\n contentType = MediaType.get(headerValue);\n } catch (IllegalArgumentException e) {\n throw methodError(method, e, \"Malformed content type: %s\", headerValue);\n }\n } else if (allowUnsafeNonAsciiValues) {\n builder.addUnsafeNonAscii(headerName, headerValue);\n } else {\n builder.add(headerName, headerValue);\n }\n }\n return builder.build();\n }\n\n private @Nullable ParameterHandler parseParameter(\n int p, Type parameterType, @Nullable Annotation[] annotations, boolean allowContinuation) {\n ParameterHandler result = null;\n if (annotations != null) {\n for (Annotation annotation : annotations) {\n ParameterHandler annotationAction =\n parseParameterAnnotation(p, parameterType, annotations, annotation);\n\n if (annotationAction == null) {\n continue;\n }\n\n if (result != null) {\n throw parameterError(\n method, p, \"Multiple Retrofit annotations found, only one allowed.\");\n }\n\n result = annotationAction;\n }\n }\n\n if (result == null) {\n if (allowContinuation) {\n try {\n if (Utils.getRawType(parameterType) == Continuation.class) {\n isKotlinSuspendFunction = true;\n return null;\n }\n } catch (NoClassDefFoundError ignored) {\n // Ignored\n }\n }\n throw parameterError(method, p, \"No Retrofit annotation found.\");\n }\n\n return result;\n }\n\n @Nullable\n private ParameterHandler parseParameterAnnotation(\n int p, Type type, Annotation[] annotations, Annotation annotation) {\n if (annotation instanceof Url) {\n validateResolvableType(p, type);\n if (gotUrl) {\n throw parameterError(method, p, \"Multiple @Url method annotations found.\");\n }\n if (gotPath) {\n throw parameterError(method, p, \"@Path parameters may not be used with @Url.\");\n }\n if (gotQuery) {\n throw parameterError(method, p, \"A @Url parameter must not come after a @Query.\");\n }\n if (gotQueryName) {\n throw parameterError(method, p, \"A @Url parameter must not come after a @QueryName.\");\n }\n if (gotQueryMap) {\n throw parameterError(method, p, \"A @Url parameter must not come after a @QueryMap.\");\n }\n if (relativeUrl != null) {\n throw parameterError(method, p, \"@Url cannot be used with @%s URL\", httpMethod);\n }\n\n gotUrl = true;\n\n if (type == HttpUrl.class\n || type == String.class\n || type == URI.class\n || (type instanceof Class && \"android.net.Uri\".equals(((Class) type).getName()))) {\n return new ParameterHandler.RelativeUrl(method, p);\n } else {\n throw parameterError(\n method,\n p,\n \"@Url must be okhttp3.HttpUrl, String, java.net.URI, or android.net.Uri type.\");\n }\n\n } else if (annotation instanceof Path) {\n validateResolvableType(p, type);\n if (gotQuery) {\n throw parameterError(method, p, \"A @Path parameter must not come after a @Query.\");\n }\n if (gotQueryName) {\n throw parameterError(method, p, \"A @Path parameter must not come after a @QueryName.\");\n }\n if (gotQueryMap) {\n throw parameterError(method, p, \"A @Path parameter must not come after a @QueryMap.\");\n }\n if (gotUrl) {\n throw parameterError(method, p, \"@Path parameters may not be used with @Url.\");\n }\n if (relativeUrl == null) {\n throw parameterError(\n method, p, \"@Path can only be used with relative url on @%s\", httpMethod);\n }\n gotPath = true;\n\n Path path = (Path) annotation;\n String name = path.value();\n validatePathName(p, name);\n\n Converter converter = retrofit.stringConverter(type, annotations);\n return new ParameterHandler.Path<>(method, p, name, converter, path.encoded());\n\n } else if (annotation instanceof Query) {\n validateResolvableType(p, type);\n Query query = (Query) annotation;\n String name = query.value();\n boolean encoded = query.encoded();\n\n Class rawParameterType = Utils.getRawType(type);\n gotQuery = true;\n if (Iterable.class.isAssignableFrom(rawParameterType)) {\n if (!(type instanceof ParameterizedType)) {\n throw parameterError(\n method,\n p,\n rawParameterType.getSimpleName()\n + \" must include generic type (e.g., \"\n + rawParameterType.getSimpleName()\n + \")\");\n }\n ParameterizedType parameterizedType = (ParameterizedType) type;\n Type iterableType = Utils.getParameterUpperBound(0, parameterizedType);\n Converter converter = retrofit.stringConverter(iterableType, annotations);\n return new ParameterHandler.Query<>(name, converter, encoded).iterable();\n } else if (rawParameterType.isArray()) {\n Class arrayComponentType = boxIfPrimitive(rawParameterType.getComponentType());\n Converter converter =\n retrofit.stringConverter(arrayComponentType, annotations);\n return new ParameterHandler.Query<>(name, converter, encoded).array();\n } else {\n Converter converter = retrofit.stringConverter(type, annotations);\n return new ParameterHandler.Query<>(name, converter, encoded);\n }\n\n } else if (annotation instanceof QueryName) {\n validateResolvableType(p, type);\n QueryName query = (QueryName) annotation;\n boolean encoded = query.encoded();\n\n Class rawParameterType = Utils.getRawType(type);\n gotQueryName = true;\n if (Iterable.class.isAssignableFrom(rawParameterType)) {\n if (!(type instanceof ParameterizedType)) {\n throw parameterError(\n method,\n p,\n rawParameterType.getSimpleName()\n + \" must include generic type (e.g., \"\n + rawParameterType.getSimpleName()\n + \")\");\n }\n ParameterizedType parameterizedType = (ParameterizedType) type;\n Type iterableType = Utils.getParameterUpperBound(0, parameterizedType);\n Converter converter = retrofit.stringConverter(iterableType, annotations);\n return new ParameterHandler.QueryName<>(converter, encoded).iterable();\n } else if (rawParameterType.isArray()) {\n Class arrayComponentType = boxIfPrimitive(rawParameterType.getComponentType());\n Converter converter =\n retrofit.stringConverter(arrayComponentType, annotations);\n return new ParameterHandler.QueryName<>(converter, encoded).array();\n } else {\n Converter converter = retrofit.stringConverter(type, annotations);\n return new ParameterHandler.QueryName<>(converter, encoded);\n }\n\n } else if (annotation instanceof QueryMap) {\n validateResolvableType(p, type);\n Class rawParameterType = Utils.getRawType(type);\n gotQueryMap = true;\n if (!Map.class.isAssignableFrom(rawParameterType)) {\n throw parameterError(method, p, \"@QueryMap parameter type must be Map.\");\n }\n Type mapType = Utils.getSupertype(type, rawParameterType, Map.class);\n if (!(mapType instanceof ParameterizedType)) {\n throw parameterError(\n method, p, \"Map must include generic types (e.g., Map)\");\n }\n ParameterizedType parameterizedType = (ParameterizedType) mapType;\n Type keyType = Utils.getParameterUpperBound(0, parameterizedType);\n if (String.class != keyType) {\n throw parameterError(method, p, \"@QueryMap keys must be of type String: \" + keyType);\n }\n Type valueType = Utils.getParameterUpperBound(1, parameterizedType);\n Converter valueConverter = retrofit.stringConverter(valueType, annotations);\n\n return new ParameterHandler.QueryMap<>(\n method, p, valueConverter, ((QueryMap) annotation).encoded());\n\n } else if (annotation instanceof Header) {\n validateResolvableType(p, type);\n Header header = (Header) annotation;\n String name = header.value();\n\n Class rawParameterType = Utils.getRawType(type);\n if (Iterable.class.isAssignableFrom(rawParameterType)) {\n if (!(type instanceof ParameterizedType)) {\n throw parameterError(\n method,\n p,\n rawParameterType.getSimpleName()\n + \" must include generic type (e.g., \"\n + rawParameterType.getSimpleName()\n + \")\");\n }\n ParameterizedType parameterizedType = (ParameterizedType) type;\n Type iterableType = Utils.getParameterUpperBound(0, parameterizedType);\n Converter converter = retrofit.stringConverter(iterableType, annotations);\n return new ParameterHandler.Header<>(name, converter, header.allowUnsafeNonAsciiValues())\n .iterable();\n } else if (rawParameterType.isArray()) {\n Class arrayComponentType = boxIfPrimitive(rawParameterType.getComponentType());\n Converter converter =\n retrofit.stringConverter(arrayComponentType, annotations);\n return new ParameterHandler.Header<>(name, converter, header.allowUnsafeNonAsciiValues())\n .array();\n } else {\n Converter converter = retrofit.stringConverter(type, annotations);\n return new ParameterHandler.Header<>(name, converter, header.allowUnsafeNonAsciiValues());\n }\n\n } else if (annotation instanceof HeaderMap) {\n if (type == Headers.class) {\n return new ParameterHandler.Headers(method, p);\n }\n\n validateResolvableType(p, type);\n Class rawParameterType = Utils.getRawType(type);\n if (!Map.class.isAssignableFrom(rawParameterType)) {\n throw parameterError(method, p, \"@HeaderMap parameter type must be Map or Headers.\");\n }\n Type mapType = Utils.getSupertype(type, rawParameterType, Map.class);\n if (!(mapType instanceof ParameterizedType)) {\n throw parameterError(\n method, p, \"Map must include generic types (e.g., Map)\");\n }\n ParameterizedType parameterizedType = (ParameterizedType) mapType;\n Type keyType = Utils.getParameterUpperBound(0, parameterizedType);\n if (String.class != keyType) {\n throw parameterError(method, p, \"@HeaderMap keys must be of type String: \" + keyType);\n }\n Type valueType = Utils.getParameterUpperBound(1, parameterizedType);\n Converter valueConverter = retrofit.stringConverter(valueType, annotations);\n\n return new ParameterHandler.HeaderMap<>(\n method, p, valueConverter, ((HeaderMap) annotation).allowUnsafeNonAsciiValues());\n\n } else if (annotation instanceof Field) {\n validateResolvableType(p, type);\n if (!isFormEncoded) {\n throw parameterError(method, p, \"@Field parameters can only be used with form encoding.\");\n }\n Field field = (Field) annotation;\n String name = field.value();\n boolean encoded = field.encoded();\n\n gotField = true;\n\n Class rawParameterType = Utils.getRawType(type);\n if (Iterable.class.isAssignableFrom(rawParameterType)) {\n if (!(type instanceof ParameterizedType)) {\n throw parameterError(\n method,\n p,\n rawParameterType.getSimpleName()\n + \" must include generic type (e.g., \"\n + rawParameterType.getSimpleName()\n + \")\");\n }\n ParameterizedType parameterizedType = (ParameterizedType) type;\n Type iterableType = Utils.getParameterUpperBound(0, parameterizedType);\n Converter converter = retrofit.stringConverter(iterableType, annotations);\n return new ParameterHandler.Field<>(name, converter, encoded).iterable();\n } else if (rawParameterType.isArray()) {\n Class arrayComponentType = boxIfPrimitive(rawParameterType.getComponentType());\n Converter converter =\n retrofit.stringConverter(arrayComponentType, annotations);\n return new ParameterHandler.Field<>(name, converter, encoded).array();\n } else {\n Converter converter = retrofit.stringConverter(type, annotations);\n return new ParameterHandler.Field<>(name, converter, encoded);\n }\n\n } else if (annotation instanceof FieldMap) {\n validateResolvableType(p, type);\n if (!isFormEncoded) {\n throw parameterError(\n method, p, \"@FieldMap parameters can only be used with form encoding.\");\n }\n Class rawParameterType = Utils.getRawType(type);\n if (!Map.class.isAssignableFrom(rawParameterType)) {\n throw parameterError(method, p, \"@FieldMap parameter type must be Map.\");\n }\n Type mapType = Utils.getSupertype(type, rawParameterType, Map.class);\n if (!(mapType instanceof ParameterizedType)) {\n throw parameterError(\n method, p, \"Map must include generic types (e.g., Map)\");\n }\n ParameterizedType parameterizedType = (ParameterizedType) mapType;\n Type keyType = Utils.getParameterUpperBound(0, parameterizedType);\n if (String.class != keyType) {\n throw parameterError(method, p, \"@FieldMap keys must be of type String: \" + keyType);\n }\n Type valueType = Utils.getParameterUpperBound(1, parameterizedType);\n Converter valueConverter = retrofit.stringConverter(valueType, annotations);\n\n gotField = true;\n return new ParameterHandler.FieldMap<>(\n method, p, valueConverter, ((FieldMap) annotation).encoded());\n\n } else if (annotation instanceof Part) {\n validateResolvableType(p, type);\n if (!isMultipart) {\n throw parameterError(\n method, p, \"@Part parameters can only be used with multipart encoding.\");\n }\n Part part = (Part) annotation;\n gotPart = true;\n\n String partName = part.value();\n Class rawParameterType = Utils.getRawType(type);\n if (partName.isEmpty()) {\n if (Iterable.class.isAssignableFrom(rawParameterType)) {\n if (!(type instanceof ParameterizedType)) {\n throw parameterError(\n method,\n p,\n rawParameterType.getSimpleName()\n + \" must include generic type (e.g., \"\n + rawParameterType.getSimpleName()\n + \")\");\n }\n ParameterizedType parameterizedType = (ParameterizedType) type;\n Type iterableType = Utils.getParameterUpperBound(0, parameterizedType);\n if (!MultipartBody.Part.class.isAssignableFrom(Utils.getRawType(iterableType))) {\n throw parameterError(\n method,\n p,\n \"@Part annotation must supply a name or use MultipartBody.Part parameter type.\");\n }\n return ParameterHandler.RawPart.INSTANCE.iterable();\n } else if (rawParameterType.isArray()) {\n Class arrayComponentType = rawParameterType.getComponentType();\n if (!MultipartBody.Part.class.isAssignableFrom(arrayComponentType)) {\n throw parameterError(\n method,\n p,\n \"@Part annotation must supply a name or use MultipartBody.Part parameter type.\");\n }\n return ParameterHandler.RawPart.INSTANCE.array();\n } else if (MultipartBody.Part.class.isAssignableFrom(rawParameterType)) {\n return ParameterHandler.RawPart.INSTANCE;\n } else {\n throw parameterError(\n method,\n p,\n \"@Part annotation must supply a name or use MultipartBody.Part parameter type.\");\n }\n } else {\n Headers headers =\n Headers.of(\n \"Content-Disposition\",\n \"form-data; name=\\\"\" + partName + \"\\\"\",\n \"Content-Transfer-Encoding\",\n part.encoding());\n\n if (Iterable.class.isAssignableFrom(rawParameterType)) {\n if (!(type instanceof ParameterizedType)) {\n throw parameterError(\n method,\n p,\n rawParameterType.getSimpleName()\n + \" must include generic type (e.g., \"\n + rawParameterType.getSimpleName()\n + \")\");\n }\n ParameterizedType parameterizedType = (ParameterizedType) type;\n Type iterableType = Utils.getParameterUpperBound(0, parameterizedType);\n if (MultipartBody.Part.class.isAssignableFrom(Utils.getRawType(iterableType))) {\n throw parameterError(\n method,\n p,\n \"@Part parameters using the MultipartBody.Part must not \"\n + \"include a part name in the annotation.\");\n }\n Converter converter =\n retrofit.requestBodyConverter(iterableType, annotations, methodAnnotations);\n return new ParameterHandler.Part<>(method, p, headers, converter).iterable();\n } else if (rawParameterType.isArray()) {\n Class arrayComponentType = boxIfPrimitive(rawParameterType.getComponentType());\n if (MultipartBody.Part.class.isAssignableFrom(arrayComponentType)) {\n throw parameterError(\n method,\n p,\n \"@Part parameters using the MultipartBody.Part must not \"\n + \"include a part name in the annotation.\");\n }\n Converter converter =\n retrofit.requestBodyConverter(arrayComponentType, annotations, methodAnnotations);\n return new ParameterHandler.Part<>(method, p, headers, converter).array();\n } else if (MultipartBody.Part.class.isAssignableFrom(rawParameterType)) {\n throw parameterError(\n method,\n p,\n \"@Part parameters using the MultipartBody.Part must not \"\n + \"include a part name in the annotation.\");\n } else {\n Converter converter =\n retrofit.requestBodyConverter(type, annotations, methodAnnotations);\n return new ParameterHandler.Part<>(method, p, headers, converter);\n }\n }\n\n } else if (annotation instanceof PartMap) {\n validateResolvableType(p, type);\n if (!isMultipart) {\n throw parameterError(\n method, p, \"@PartMap parameters can only be used with multipart encoding.\");\n }\n gotPart = true;\n Class rawParameterType = Utils.getRawType(type);\n if (!Map.class.isAssignableFrom(rawParameterType)) {\n throw parameterError(method, p, \"@PartMap parameter type must be Map.\");\n }\n Type mapType = Utils.getSupertype(type, rawParameterType, Map.class);\n if (!(mapType instanceof ParameterizedType)) {\n throw parameterError(\n method, p, \"Map must include generic types (e.g., Map)\");\n }\n ParameterizedType parameterizedType = (ParameterizedType) mapType;\n\n Type keyType = Utils.getParameterUpperBound(0, parameterizedType);\n if (String.class != keyType) {\n throw parameterError(method, p, \"@PartMap keys must be of type String: \" + keyType);\n }\n\n Type valueType = Utils.getParameterUpperBound(1, parameterizedType);\n if (MultipartBody.Part.class.isAssignableFrom(Utils.getRawType(valueType))) {\n throw parameterError(\n method,\n p,\n \"@PartMap values cannot be MultipartBody.Part. \"\n + \"Use @Part List or a different value type instead.\");\n }\n\n Converter valueConverter =\n retrofit.requestBodyConverter(valueType, annotations, methodAnnotations);\n\n PartMap partMap = (PartMap) annotation;\n return new ParameterHandler.PartMap<>(method, p, valueConverter, partMap.encoding());\n\n } else if (annotation instanceof Body) {\n validateResolvableType(p, type);\n if (isFormEncoded || isMultipart) {\n throw parameterError(\n method, p, \"@Body parameters cannot be used with form or multi-part encoding.\");\n }\n if (gotBody) {\n throw parameterError(method, p, \"Multiple @Body method annotations found.\");\n }\n\n Converter converter;\n try {\n converter = retrofit.requestBodyConverter(type, annotations, methodAnnotations);\n } catch (RuntimeException e) {\n // Wide exception range because factories are user code.\n throw parameterError(method, e, p, \"Unable to create @Body converter for %s\", type);\n }\n gotBody = true;\n return new ParameterHandler.Body<>(method, p, converter);\n\n } else if (annotation instanceof Tag) {\n validateResolvableType(p, type);\n\n Class tagType = boxIfPrimitive(Utils.getRawType(type));\n for (int i = p - 1; i >= 0; i--) {\n ParameterHandler otherHandler = parameterHandlers[i];\n if (otherHandler instanceof ParameterHandler.Tag\n && ((ParameterHandler.Tag) otherHandler).cls.equals(tagType)) {\n throw parameterError(\n method,\n p,\n \"@Tag type \"\n + tagType.getName()\n + \" is duplicate of \"\n + Platform.reflection.describeMethodParameter(method, i)\n + \" and would always overwrite its value.\");\n }\n }\n\n return new ParameterHandler.Tag<>(tagType);\n }\n\n return null; // Not a Retrofit annotation.\n }\n\n private void validateResolvableType(int p, Type type) {\n if (Utils.hasUnresolvableType(type)) {\n throw parameterError(\n method, p, \"Parameter type must not include a type variable or wildcard: %s\", type);\n }\n }\n\n private void validatePathName(int p, String name) {\n if (!PARAM_NAME_REGEX.matcher(name).matches()) {\n throw parameterError(\n method,\n p,\n \"@Path parameter name must match %s. Found: %s\",\n PARAM_URL_REGEX.pattern(),\n name);\n }\n // Verify URL replacement name is actually present in the URL path.\n if (!relativeUrlParamNames.contains(name)) {\n throw parameterError(method, p, \"URL \\\"%s\\\" does not contain \\\"{%s}\\\".\", relativeUrl, name);\n }\n }\n\n /**\n * Gets the set of unique path parameters used in the given URI. If a parameter is used twice in\n * the URI, it will only show up once in the set.\n */\n static Set parsePathParameters(String path) {\n Matcher m = PARAM_URL_REGEX.matcher(path);\n Set patterns = new LinkedHashSet<>();\n while (m.find()) {\n patterns.add(m.group(1));\n }\n return patterns;\n }\n\n private static Class boxIfPrimitive(Class type) {\n if (boolean.class == type) return Boolean.class;\n if (byte.class == type) return Byte.class;\n if (char.class == type) return Character.class;\n if (double.class == type) return Double.class;\n if (float.class == type) return Float.class;\n if (int.class == type) return Integer.class;\n if (long.class == type) return Long.class;\n if (short.class == type) return Short.class;\n return type;\n }\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/Response.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.util.Objects;\nimport javax.annotation.Nullable;\nimport okhttp3.Headers;\nimport okhttp3.Protocol;\nimport okhttp3.Request;\nimport okhttp3.ResponseBody;\n\n/** An HTTP response. */\npublic final class Response {\n /** Create a synthetic successful response with {@code body} as the deserialized body. */\n public static Response success(@Nullable T body) {\n return success(\n body,\n new okhttp3.Response.Builder() //\n .code(200)\n .message(\"OK\")\n .protocol(Protocol.HTTP_1_1)\n .request(new Request.Builder().url(\"http://localhost/\").build())\n .build());\n }\n\n /**\n * Create a synthetic successful response with an HTTP status code of {@code code} and {@code\n * body} as the deserialized body.\n */\n public static Response success(int code, @Nullable T body) {\n if (code < 200 || code >= 300) {\n throw new IllegalArgumentException(\"code < 200 or >= 300: \" + code);\n }\n return success(\n body,\n new okhttp3.Response.Builder() //\n .code(code)\n .message(\"Response.success()\")\n .protocol(Protocol.HTTP_1_1)\n .request(new Request.Builder().url(\"http://localhost/\").build())\n .build());\n }\n\n /**\n * Create a synthetic successful response using {@code headers} with {@code body} as the\n * deserialized body.\n */\n public static Response success(@Nullable T body, Headers headers) {\n Objects.requireNonNull(headers, \"headers == null\");\n return success(\n body,\n new okhttp3.Response.Builder() //\n .code(200)\n .message(\"OK\")\n .protocol(Protocol.HTTP_1_1)\n .headers(headers)\n .request(new Request.Builder().url(\"http://localhost/\").build())\n .build());\n }\n\n /**\n * Create a successful response from {@code rawResponse} with {@code body} as the deserialized\n * body.\n */\n public static Response success(@Nullable T body, okhttp3.Response rawResponse) {\n Objects.requireNonNull(rawResponse, \"rawResponse == null\");\n if (!rawResponse.isSuccessful()) {\n throw new IllegalArgumentException(\"rawResponse must be successful response\");\n }\n return new Response<>(rawResponse, body, null);\n }\n\n /**\n * Create a synthetic error response with an HTTP status code of {@code code} and {@code body} as\n * the error body.\n */\n public static Response error(int code, ResponseBody body) {\n Objects.requireNonNull(body, \"body == null\");\n if (code < 400) throw new IllegalArgumentException(\"code < 400: \" + code);\n return error(\n body,\n new okhttp3.Response.Builder() //\n .body(new OkHttpCall.NoContentResponseBody(body.contentType(), body.contentLength()))\n .code(code)\n .message(\"Response.error()\")\n .protocol(Protocol.HTTP_1_1)\n .request(new Request.Builder().url(\"http://localhost/\").build())\n .build());\n }\n\n /** Create an error response from {@code rawResponse} with {@code body} as the error body. */\n public static Response error(ResponseBody body, okhttp3.Response rawResponse) {\n Objects.requireNonNull(body, \"body == null\");\n Objects.requireNonNull(rawResponse, \"rawResponse == null\");\n if (rawResponse.isSuccessful()) {\n throw new IllegalArgumentException(\"rawResponse should not be successful response\");\n }\n return new Response<>(rawResponse, null, body);\n }\n\n private final okhttp3.Response rawResponse;\n private final @Nullable T body;\n private final @Nullable ResponseBody errorBody;\n\n private Response(\n okhttp3.Response rawResponse, @Nullable T body, @Nullable ResponseBody errorBody) {\n this.rawResponse = rawResponse;\n this.body = body;\n this.errorBody = errorBody;\n }\n\n /** The raw response from the HTTP client. */\n public okhttp3.Response raw() {\n return rawResponse;\n }\n\n /** HTTP status code. */\n public int code() {\n return rawResponse.code();\n }\n\n /** HTTP status message or null if unknown. */\n public String message() {\n return rawResponse.message();\n }\n\n /** HTTP headers. */\n public Headers headers() {\n return rawResponse.headers();\n }\n\n /** Returns true if {@link #code()} is in the range [200..300). */\n public boolean isSuccessful() {\n return rawResponse.isSuccessful();\n }\n\n /** The deserialized response body of a {@linkplain #isSuccessful() successful} response. */\n public @Nullable T body() {\n return body;\n }\n\n /** The raw response body of an {@linkplain #isSuccessful() unsuccessful} response. */\n public @Nullable ResponseBody errorBody() {\n return errorBody;\n }\n\n @Override\n public String toString() {\n return rawResponse.toString();\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/Retrofit.java", "content": "/*\n * Copyright (C) 2012 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static java.util.Collections.unmodifiableList;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.InvocationHandler;\nimport java.lang.reflect.Method;\nimport java.lang.reflect.Modifier;\nimport java.lang.reflect.Proxy;\nimport java.lang.reflect.Type;\nimport java.net.URL;\nimport java.util.ArrayDeque;\nimport java.util.ArrayList;\nimport java.util.Collections;\nimport java.util.Deque;\nimport java.util.List;\nimport java.util.Objects;\nimport java.util.concurrent.ConcurrentHashMap;\nimport java.util.concurrent.Executor;\nimport javax.annotation.Nullable;\nimport okhttp3.HttpUrl;\nimport okhttp3.OkHttpClient;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.http.GET;\nimport retrofit2.http.HTTP;\nimport retrofit2.http.Header;\nimport retrofit2.http.Url;\n\n/**\n * Retrofit adapts a Java interface to HTTP calls by using annotations on the declared methods to\n * define how requests are made. Create instances using {@linkplain Builder the builder} and pass\n * your interface to {@link #create} to generate an implementation.\n *\n *

For example,\n *\n * 

\n * Retrofit retrofit = new Retrofit.Builder()\n *     .baseUrl(\"https://api.example.com/\")\n *     .addConverterFactory(GsonConverterFactory.create())\n *     .build();\n *\n * MyApi api = retrofit.create(MyApi.class);\n * Response<User> user = api.getUser().execute();\n *
\n *\n * @author Bob Lee (bob@squareup.com)\n * @author Jake Wharton (jw@squareup.com)\n */\npublic final class Retrofit {\n /**\n * Method associations in this map will be in one of three states, and may only progress forward\n * to higher-numbered states.\n *
    \n *
  1. No value - no one has started or completed parsing annotations for the method.
    2. \n *
  2. Lock object - a thread has started parsing annotations on the method. Once the lock is\n * available the map will have been updated with the parsed model.
    3. \n *
  3. {@code ServiceMethod} - annotations for the method have been fully parsed.
    4. \n *
\n * This map should only be accessed through {@link #loadServiceMethod} which contains the state\n * transition logic.\n */\n private final ConcurrentHashMap serviceMethodCache = new ConcurrentHashMap<>();\n\n final okhttp3.Call.Factory callFactory;\n final HttpUrl baseUrl;\n final List converterFactories;\n final int defaultConverterFactoriesSize;\n final List callAdapterFactories;\n final int defaultCallAdapterFactoriesSize;\n final @Nullable Executor callbackExecutor;\n final boolean validateEagerly;\n\n Retrofit(\n okhttp3.Call.Factory callFactory,\n HttpUrl baseUrl,\n List converterFactories,\n int defaultConverterFactoriesSize,\n List callAdapterFactories,\n int defaultCallAdapterFactoriesSize,\n @Nullable Executor callbackExecutor,\n boolean validateEagerly) {\n this.callFactory = callFactory;\n this.baseUrl = baseUrl;\n this.converterFactories = converterFactories; // Copy+unmodifiable at call site.\n this.defaultConverterFactoriesSize = defaultConverterFactoriesSize;\n this.callAdapterFactories = callAdapterFactories; // Copy+unmodifiable at call site.\n this.defaultCallAdapterFactoriesSize = defaultCallAdapterFactoriesSize;\n this.callbackExecutor = callbackExecutor;\n this.validateEagerly = validateEagerly;\n }\n\n /**\n * Create an implementation of the API endpoints defined by the {@code service} interface.\n *\n *

The relative path for a given method is obtained from an annotation on the method describing\n * the request type. The built-in methods are {@link retrofit2.http.GET GET}, {@link\n * retrofit2.http.PUT PUT}, {@link retrofit2.http.POST POST}, {@link retrofit2.http.PATCH PATCH},\n * {@link retrofit2.http.HEAD HEAD}, {@link retrofit2.http.DELETE DELETE} and {@link\n * retrofit2.http.OPTIONS OPTIONS}. You can use a custom HTTP method with {@link HTTP @HTTP}. For\n * a dynamic URL, omit the path on the annotation and annotate the first parameter with {@link\n * Url @Url}.\n *\n *

Method parameters can be used to replace parts of the URL by annotating them with {@link\n * retrofit2.http.Path @Path}. Replacement sections are denoted by an identifier surrounded by\n * curly braces (e.g., \"{foo}\"). To add items to the query string of a URL use {@link\n * retrofit2.http.Query @Query}.\n *\n *

The body of a request is denoted by the {@link retrofit2.http.Body @Body} annotation. The\n * object will be converted to request representation by one of the {@link Converter.Factory}\n * instances. A {@link RequestBody} can also be used for a raw representation.\n *\n *

Alternative request body formats are supported by method annotations and corresponding\n * parameter annotations:\n *\n *

    \n *
  • {@link retrofit2.http.FormUrlEncoded @FormUrlEncoded} - Form-encoded data with key-value\n * pairs specified by the {@link retrofit2.http.Field @Field} parameter annotation.\n *
  • {@link retrofit2.http.Multipart @Multipart} - RFC 2388-compliant multipart data with\n * parts specified by the {@link retrofit2.http.Part @Part} parameter annotation.\n *
\n *\n *

Additional static headers can be added for an endpoint using the {@link\n * retrofit2.http.Headers @Headers} method annotation. For per-request control over a header\n * annotate a parameter with {@link Header @Header}.\n *\n *

By default, methods return a {@link Call} which represents the HTTP request. The generic\n * parameter of the call is the response body type and will be converted by one of the {@link\n * Converter.Factory} instances. {@link ResponseBody} can also be used for a raw representation.\n * {@link Void} can be used if you do not care about the body contents.\n *\n *

For example:\n *\n * 

\n   * public interface CategoryService {\n   *   @POST(\"category/{cat}/\")\n   *   Call<List<Item>> categoryList(@Path(\"cat\") String a, @Query(\"page\") int b);\n   * }\n   *
\n */\n @SuppressWarnings(\"unchecked\") // Single-interface proxy creation guarded by parameter safety.\n public T create(final Class service) {\n validateServiceInterface(service);\n return (T)\n Proxy.newProxyInstance(\n service.getClassLoader(),\n new Class[] {service},\n new InvocationHandler() {\n private final Object[] emptyArgs = new Object[0];\n\n @Override\n public @Nullable Object invoke(Object proxy, Method method, @Nullable Object[] args)\n throws Throwable {\n // If the method is a method from Object then defer to normal invocation.\n if (method.getDeclaringClass() == Object.class) {\n return method.invoke(this, args);\n }\n args = args != null ? args : emptyArgs;\n Reflection reflection = Platform.reflection;\n return reflection.isDefaultMethod(method)\n ? reflection.invokeDefaultMethod(method, service, proxy, args)\n : loadServiceMethod(service, method).invoke(proxy, args);\n }\n });\n }\n\n private void validateServiceInterface(Class service) {\n if (!service.isInterface()) {\n throw new IllegalArgumentException(\"API declarations must be interfaces.\");\n }\n\n Deque> check = new ArrayDeque<>(1);\n check.add(service);\n while (!check.isEmpty()) {\n Class candidate = check.removeFirst();\n if (candidate.getTypeParameters().length != 0) {\n StringBuilder message =\n new StringBuilder(\"Type parameters are unsupported on \").append(candidate.getName());\n if (candidate != service) {\n message.append(\" which is an interface of \").append(service.getName());\n }\n throw new IllegalArgumentException(message.toString());\n }\n Collections.addAll(check, candidate.getInterfaces());\n }\n\n if (validateEagerly) {\n Reflection reflection = Platform.reflection;\n for (Method method : service.getDeclaredMethods()) {\n if (!reflection.isDefaultMethod(method)\n && !Modifier.isStatic(method.getModifiers())\n && !method.isSynthetic()) {\n loadServiceMethod(service, method);\n }\n }\n }\n }\n\n ServiceMethod loadServiceMethod(Class service, Method method) {\n while (true) {\n // Note: Once we are minSdk 24 this whole method can be replaced by computeIfAbsent.\n Object lookup = serviceMethodCache.get(method);\n\n if (lookup instanceof ServiceMethod) {\n // Happy path: method is already parsed into the model.\n return (ServiceMethod) lookup;\n }\n\n if (lookup == null) {\n // Map does not contain any value. Try to put in a lock for this method. We MUST synchronize\n // on the lock before it is visible to others via the map to signal we are doing the work.\n Object lock = new Object();\n synchronized (lock) {\n lookup = serviceMethodCache.putIfAbsent(method, lock);\n if (lookup == null) {\n // On successful lock insertion, perform the work and update the map before releasing.\n // Other threads may be waiting on lock now and will expect the parsed model.\n ServiceMethod result;\n try {\n result = ServiceMethod.parseAnnotations(this, service, method);\n } catch (Throwable e) {\n // Remove the lock on failure. Any other locked threads will retry as a result.\n serviceMethodCache.remove(method);\n throw e;\n }\n serviceMethodCache.put(method, result);\n return result;\n }\n }\n }\n\n // Either the initial lookup or the attempt to put our lock in the map has returned someone\n // else's lock. This means they are doing the parsing, and will update the map before\n // releasing\n // the lock. Once we can take the lock, the map is guaranteed to contain the model or null.\n // Note: There's a chance that our effort to put a lock into the map has actually returned a\n // finished model instead of a lock. In that case this code will perform a pointless lock and\n // redundant lookup in the map of the same instance. This is rare, and ultimately harmless.\n synchronized (lookup) {\n Object result = serviceMethodCache.get(method);\n if (result == null) {\n // The other thread failed its parsing. We will retry (and probably also fail).\n continue;\n }\n return (ServiceMethod) result;\n }\n }\n }\n\n /**\n * The factory used to create {@linkplain okhttp3.Call OkHttp calls} for sending a HTTP requests.\n * Typically an instance of {@link OkHttpClient}.\n */\n public okhttp3.Call.Factory callFactory() {\n return callFactory;\n }\n\n /** The API base URL. */\n public HttpUrl baseUrl() {\n return baseUrl;\n }\n\n /**\n * Returns a list of the factories tried when creating a {@linkplain #callAdapter(Type,\n * Annotation[])} call adapter}.\n */\n public List callAdapterFactories() {\n return callAdapterFactories;\n }\n\n /**\n * Returns the {@link CallAdapter} for {@code returnType} from the available {@linkplain\n * #callAdapterFactories() factories}.\n *\n * @throws IllegalArgumentException if no call adapter available for {@code type}.\n */\n public CallAdapter callAdapter(Type returnType, Annotation[] annotations) {\n return nextCallAdapter(null, returnType, annotations);\n }\n\n /**\n * Returns the {@link CallAdapter} for {@code returnType} from the available {@linkplain\n * #callAdapterFactories() factories} except {@code skipPast}.\n *\n * @throws IllegalArgumentException if no call adapter available for {@code type}.\n */\n public CallAdapter nextCallAdapter(\n @Nullable CallAdapter.Factory skipPast, Type returnType, Annotation[] annotations) {\n Objects.requireNonNull(returnType, \"returnType == null\");\n Objects.requireNonNull(annotations, \"annotations == null\");\n\n int start = callAdapterFactories.indexOf(skipPast) + 1;\n for (int i = start, count = callAdapterFactories.size(); i < count; i++) {\n CallAdapter adapter = callAdapterFactories.get(i).get(returnType, annotations, this);\n if (adapter != null) {\n return adapter;\n }\n }\n\n StringBuilder builder =\n new StringBuilder(\"Could not locate call adapter for \").append(returnType).append(\".\\n\");\n if (skipPast != null) {\n builder.append(\" Skipped:\");\n for (int i = 0; i < start; i++) {\n builder.append(\"\\n * \").append(callAdapterFactories.get(i).getClass().getName());\n }\n builder.append('\\n');\n }\n builder.append(\" Tried:\");\n for (int i = start, count = callAdapterFactories.size(); i < count; i++) {\n builder.append(\"\\n * \").append(callAdapterFactories.get(i).getClass().getName());\n }\n throw new IllegalArgumentException(builder.toString());\n }\n\n /**\n * Returns an unmodifiable list of the factories tried when creating a {@linkplain\n * #requestBodyConverter(Type, Annotation[], Annotation[]) request body converter}, a {@linkplain\n * #responseBodyConverter(Type, Annotation[]) response body converter}, or a {@linkplain\n * #stringConverter(Type, Annotation[]) string converter}.\n */\n public List converterFactories() {\n return converterFactories;\n }\n\n /**\n * Returns a {@link Converter} for {@code type} to {@link RequestBody} from the available\n * {@linkplain #converterFactories() factories}.\n *\n * @throws IllegalArgumentException if no converter available for {@code type}.\n */\n public Converter requestBodyConverter(\n Type type, Annotation[] parameterAnnotations, Annotation[] methodAnnotations) {\n return nextRequestBodyConverter(null, type, parameterAnnotations, methodAnnotations);\n }\n\n /**\n * Returns a {@link Converter} for {@code type} to {@link RequestBody} from the available\n * {@linkplain #converterFactories() factories} except {@code skipPast}.\n *\n * @throws IllegalArgumentException if no converter available for {@code type}.\n */\n public Converter nextRequestBodyConverter(\n @Nullable Converter.Factory skipPast,\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations) {\n Objects.requireNonNull(type, \"type == null\");\n Objects.requireNonNull(parameterAnnotations, \"parameterAnnotations == null\");\n Objects.requireNonNull(methodAnnotations, \"methodAnnotations == null\");\n\n int start = converterFactories.indexOf(skipPast) + 1;\n for (int i = start, count = converterFactories.size(); i < count; i++) {\n Converter.Factory factory = converterFactories.get(i);\n Converter converter =\n factory.requestBodyConverter(type, parameterAnnotations, methodAnnotations, this);\n if (converter != null) {\n //noinspection unchecked\n return (Converter) converter;\n }\n }\n\n StringBuilder builder =\n new StringBuilder(\"Could not locate RequestBody converter for \").append(type).append(\".\\n\");\n if (skipPast != null) {\n builder.append(\" Skipped:\");\n for (int i = 0; i < start; i++) {\n builder.append(\"\\n * \").append(converterFactories.get(i).getClass().getName());\n }\n builder.append('\\n');\n }\n builder.append(\" Tried:\");\n for (int i = start, count = converterFactories.size(); i < count; i++) {\n builder.append(\"\\n * \").append(converterFactories.get(i).getClass().getName());\n }\n throw new IllegalArgumentException(builder.toString());\n }\n\n /**\n * Returns a {@link Converter} for {@link ResponseBody} to {@code type} from the available\n * {@linkplain #converterFactories() factories}.\n *\n * @throws IllegalArgumentException if no converter available for {@code type}.\n */\n public Converter responseBodyConverter(Type type, Annotation[] annotations) {\n return nextResponseBodyConverter(null, type, annotations);\n }\n\n /**\n * Returns a {@link Converter} for {@link ResponseBody} to {@code type} from the available\n * {@linkplain #converterFactories() factories} except {@code skipPast}.\n *\n * @throws IllegalArgumentException if no converter available for {@code type}.\n */\n public Converter nextResponseBodyConverter(\n @Nullable Converter.Factory skipPast, Type type, Annotation[] annotations) {\n Objects.requireNonNull(type, \"type == null\");\n Objects.requireNonNull(annotations, \"annotations == null\");\n\n int start = converterFactories.indexOf(skipPast) + 1;\n for (int i = start, count = converterFactories.size(); i < count; i++) {\n Converter converter =\n converterFactories.get(i).responseBodyConverter(type, annotations, this);\n if (converter != null) {\n //noinspection unchecked\n return (Converter) converter;\n }\n }\n\n StringBuilder builder =\n new StringBuilder(\"Could not locate ResponseBody converter for \")\n .append(type)\n .append(\".\\n\");\n if (skipPast != null) {\n builder.append(\" Skipped:\");\n for (int i = 0; i < start; i++) {\n builder.append(\"\\n * \").append(converterFactories.get(i).getClass().getName());\n }\n builder.append('\\n');\n }\n builder.append(\" Tried:\");\n for (int i = start, count = converterFactories.size(); i < count; i++) {\n builder.append(\"\\n * \").append(converterFactories.get(i).getClass().getName());\n }\n throw new IllegalArgumentException(builder.toString());\n }\n\n /**\n * Returns a {@link Converter} for {@code type} to {@link String} from the available {@linkplain\n * #converterFactories() factories}.\n */\n public Converter stringConverter(Type type, Annotation[] annotations) {\n Objects.requireNonNull(type, \"type == null\");\n Objects.requireNonNull(annotations, \"annotations == null\");\n\n for (int i = 0, count = converterFactories.size(); i < count; i++) {\n Converter converter =\n converterFactories.get(i).stringConverter(type, annotations, this);\n if (converter != null) {\n //noinspection unchecked\n return (Converter) converter;\n }\n }\n\n // Nothing matched. Resort to default converter which just calls toString().\n //noinspection unchecked\n return (Converter) BuiltInConverters.ToStringConverter.INSTANCE;\n }\n\n /**\n * The executor used for {@link Callback} methods on a {@link Call}. This may be {@code null}, in\n * which case callbacks should be made synchronously on the background thread.\n */\n public @Nullable Executor callbackExecutor() {\n return callbackExecutor;\n }\n\n public Builder newBuilder() {\n return new Builder(this);\n }\n\n /**\n * Build a new {@link Retrofit}.\n *\n *

Calling {@link #baseUrl} is required before calling {@link #build()}. All other methods are\n * optional.\n */\n public static final class Builder {\n private @Nullable okhttp3.Call.Factory callFactory;\n private @Nullable HttpUrl baseUrl;\n private final List converterFactories = new ArrayList<>();\n private final List callAdapterFactories = new ArrayList<>();\n private @Nullable Executor callbackExecutor;\n private boolean validateEagerly;\n\n public Builder() {}\n\n Builder(Retrofit retrofit) {\n callFactory = retrofit.callFactory;\n baseUrl = retrofit.baseUrl;\n\n // Do not add the default BuiltIntConverters and platform-aware converters added by build().\n for (int i = 1,\n size = retrofit.converterFactories.size() - retrofit.defaultConverterFactoriesSize;\n i < size;\n i++) {\n converterFactories.add(retrofit.converterFactories.get(i));\n }\n\n // Do not add the default, platform-aware call adapters added by build().\n for (int i = 0,\n size =\n retrofit.callAdapterFactories.size() - retrofit.defaultCallAdapterFactoriesSize;\n i < size;\n i++) {\n callAdapterFactories.add(retrofit.callAdapterFactories.get(i));\n }\n\n callbackExecutor = retrofit.callbackExecutor;\n validateEagerly = retrofit.validateEagerly;\n }\n\n /**\n * The HTTP client used for requests.\n *\n *

This is a convenience method for calling {@link #callFactory}.\n */\n public Builder client(OkHttpClient client) {\n return callFactory(Objects.requireNonNull(client, \"client == null\"));\n }\n\n /**\n * Specify a custom call factory for creating {@link Call} instances.\n *\n *

Note: Calling {@link #client} automatically sets this value.\n */\n public Builder callFactory(okhttp3.Call.Factory factory) {\n this.callFactory = Objects.requireNonNull(factory, \"factory == null\");\n return this;\n }\n\n /**\n * Set the API base URL.\n *\n * @see #baseUrl(HttpUrl)\n */\n public Builder baseUrl(URL baseUrl) {\n Objects.requireNonNull(baseUrl, \"baseUrl == null\");\n return baseUrl(HttpUrl.get(baseUrl.toString()));\n }\n\n /**\n * Set the API base URL.\n *\n * @see #baseUrl(HttpUrl)\n */\n public Builder baseUrl(String baseUrl) {\n Objects.requireNonNull(baseUrl, \"baseUrl == null\");\n return baseUrl(HttpUrl.get(baseUrl));\n }\n\n /**\n * Set the API base URL.\n *\n *

The specified endpoint values (such as with {@link GET @GET}) are resolved against this\n * value using {@link HttpUrl#resolve(String)}. The behavior of this matches that of an {@code\n * } link on a website resolving on the current URL.\n *\n *

Base URLs should always end in {@code /}.\n *\n *

A trailing {@code /} ensures that endpoints values which are relative paths will correctly\n * append themselves to a base which has path components.\n *\n *

Correct:
\n * Base URL: http://example.com/api/
\n * Endpoint: foo/bar/
\n * Result: http://example.com/api/foo/bar/\n *\n *

Incorrect:
\n * Base URL: http://example.com/api
\n * Endpoint: foo/bar/
\n * Result: http://example.com/foo/bar/\n *\n *

This method enforces that {@code baseUrl} has a trailing {@code /}.\n *\n *

Endpoint values which contain a leading {@code /} are absolute.\n *\n *

Absolute values retain only the host from {@code baseUrl} and ignore any specified path\n * components.\n *\n *

Base URL: http://example.com/api/
\n * Endpoint: /foo/bar/
\n * Result: http://example.com/foo/bar/\n *\n *

Base URL: http://example.com/
\n * Endpoint: /foo/bar/
\n * Result: http://example.com/foo/bar/\n *\n *

Endpoint values may be a full URL.\n *\n *

Values which have a host replace the host of {@code baseUrl} and values also with a scheme\n * replace the scheme of {@code baseUrl}.\n *\n *

Base URL: http://example.com/
\n * Endpoint: https://github.com/square/retrofit/
\n * Result: https://github.com/square/retrofit/\n *\n *

Base URL: http://example.com
\n * Endpoint: //github.com/square/retrofit/
\n * Result: http://github.com/square/retrofit/ (note the scheme stays 'http')\n */\n public Builder baseUrl(HttpUrl baseUrl) {\n Objects.requireNonNull(baseUrl, \"baseUrl == null\");\n List pathSegments = baseUrl.pathSegments();\n if (!\"\".equals(pathSegments.get(pathSegments.size() - 1))) {\n throw new IllegalArgumentException(\"baseUrl must end in /: \" + baseUrl);\n }\n this.baseUrl = baseUrl;\n return this;\n }\n\n /** Add converter factory for serialization and deserialization of objects. */\n public Builder addConverterFactory(Converter.Factory factory) {\n converterFactories.add(Objects.requireNonNull(factory, \"factory == null\"));\n return this;\n }\n\n /**\n * Add a call adapter factory for supporting service method return types other than {@link\n * Call}.\n */\n public Builder addCallAdapterFactory(CallAdapter.Factory factory) {\n callAdapterFactories.add(Objects.requireNonNull(factory, \"factory == null\"));\n return this;\n }\n\n /**\n * The executor on which {@link Callback} methods are invoked when returning {@link Call} from\n * your service method.\n *\n *

Note: {@code executor} is not used for {@linkplain #addCallAdapterFactory custom method\n * return types}.\n */\n public Builder callbackExecutor(Executor executor) {\n this.callbackExecutor = Objects.requireNonNull(executor, \"executor == null\");\n return this;\n }\n\n /** Returns a modifiable list of call adapter factories. */\n public List callAdapterFactories() {\n return this.callAdapterFactories;\n }\n\n /** Returns a modifiable list of converter factories. */\n public List converterFactories() {\n return this.converterFactories;\n }\n\n /**\n * When calling {@link #create} on the resulting {@link Retrofit} instance, eagerly validate the\n * configuration of all methods in the supplied interface.\n */\n public Builder validateEagerly(boolean validateEagerly) {\n this.validateEagerly = validateEagerly;\n return this;\n }\n\n /**\n * Create the {@link Retrofit} instance using the configured values.\n *\n *

Note: If neither {@link #client} nor {@link #callFactory} is called a default {@link\n * OkHttpClient} will be created and used.\n */\n public Retrofit build() {\n if (baseUrl == null) {\n throw new IllegalStateException(\"Base URL required.\");\n }\n\n okhttp3.Call.Factory callFactory = this.callFactory;\n if (callFactory == null) {\n callFactory = new OkHttpClient();\n }\n\n Executor callbackExecutor = this.callbackExecutor;\n if (callbackExecutor == null) {\n callbackExecutor = Platform.callbackExecutor;\n }\n\n BuiltInFactories builtInFactories = Platform.builtInFactories;\n\n // Make a defensive copy of the adapters and add the default Call adapter.\n List callAdapterFactories = new ArrayList<>(this.callAdapterFactories);\n List defaultCallAdapterFactories =\n builtInFactories.createDefaultCallAdapterFactories(callbackExecutor);\n callAdapterFactories.addAll(defaultCallAdapterFactories);\n\n // Make a defensive copy of the converters.\n List defaultConverterFactories =\n builtInFactories.createDefaultConverterFactories();\n int defaultConverterFactoriesSize = defaultConverterFactories.size();\n List converterFactories =\n new ArrayList<>(1 + this.converterFactories.size() + defaultConverterFactoriesSize);\n\n // Add the built-in converter factory first. This prevents overriding its behavior but also\n // ensures correct behavior when using converters that consume all types.\n converterFactories.add(new BuiltInConverters());\n converterFactories.addAll(this.converterFactories);\n converterFactories.addAll(defaultConverterFactories);\n\n return new Retrofit(\n callFactory,\n baseUrl,\n unmodifiableList(converterFactories),\n defaultConverterFactoriesSize,\n unmodifiableList(callAdapterFactories),\n defaultCallAdapterFactories.size(),\n callbackExecutor,\n validateEagerly);\n }\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/ServiceMethod.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static retrofit2.Utils.methodError;\n\nimport java.lang.reflect.Method;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\n\nabstract class ServiceMethod {\n static ServiceMethod parseAnnotations(Retrofit retrofit, Class service, Method method) {\n RequestFactory requestFactory = RequestFactory.parseAnnotations(retrofit, service, method);\n\n Type returnType = method.getGenericReturnType();\n if (Utils.hasUnresolvableType(returnType)) {\n throw methodError(\n method,\n \"Method return type must not include a type variable or wildcard: %s\",\n returnType);\n }\n if (returnType == void.class) {\n throw methodError(method, \"Service methods cannot return void.\");\n }\n\n return HttpServiceMethod.parseAnnotations(retrofit, method, requestFactory);\n }\n\n abstract @Nullable T invoke(Object instance, Object[] args);\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/SkipCallbackExecutor.java", "content": "/*\n * Copyright (C) 2019 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport static java.lang.annotation.ElementType.METHOD;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport java.lang.reflect.Type;\n\n/**\n * Change the behavior of a {@code Call} return type to not use the {@linkplain\n * Retrofit#callbackExecutor() callback executor} for invoking the {@link Callback#onResponse(Call,\n * Response) onResponse} or {@link Callback#onFailure(Call, Throwable) onFailure} methods.\n *\n * 

\n * @SkipCallbackExecutor\n * @GET(\"user/{id}/token\")\n * Call<String> getToken(@Path(\"id\") long id);\n *
\n *\n * This annotation can also be used when a {@link CallAdapter.Factory} explicitly delegates\n * to the built-in factory for {@link Call} via {@link Retrofit#nextCallAdapter(CallAdapter.Factory,\n * Type, Annotation[])} in order for the returned {@link Call} to skip the executor. (Note: by\n * default, a {@link Call} supplied directly to a {@link CallAdapter} will already skip the callback\n * executor. The annotation is only useful when looking up the built-in adapter.)\n */\n@Documented\n@Target(METHOD)\n@Retention(RUNTIME)\npublic @interface SkipCallbackExecutor {}\n" }, { "path": "retrofit/src/main/java/retrofit2/SkipCallbackExecutorImpl.java", "content": "/*\n * Copyright (C) 2019 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.lang.annotation.Annotation;\n\n// This class conforms to the annotation requirements documented on Annotation.\nfinal class SkipCallbackExecutorImpl implements SkipCallbackExecutor {\n private static final SkipCallbackExecutor INSTANCE = new SkipCallbackExecutorImpl();\n\n static Annotation[] ensurePresent(Annotation[] annotations) {\n if (Utils.isAnnotationPresent(annotations, SkipCallbackExecutor.class)) {\n return annotations;\n }\n\n Annotation[] newAnnotations = new Annotation[annotations.length + 1];\n // Place the skip annotation first since we're guaranteed to check for it in the call adapter.\n newAnnotations[0] = SkipCallbackExecutorImpl.INSTANCE;\n System.arraycopy(annotations, 0, newAnnotations, 1, annotations.length);\n return newAnnotations;\n }\n\n @Override\n public Class annotationType() {\n return SkipCallbackExecutor.class;\n }\n\n @Override\n public boolean equals(Object obj) {\n return obj instanceof SkipCallbackExecutor;\n }\n\n @Override\n public int hashCode() {\n return 0;\n }\n\n @Override\n public String toString() {\n return \"@\" + SkipCallbackExecutor.class.getName() + \"()\";\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/Utils.java", "content": "/*\n * Copyright (C) 2008 Google Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Array;\nimport java.lang.reflect.GenericArrayType;\nimport java.lang.reflect.GenericDeclaration;\nimport java.lang.reflect.Method;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport java.lang.reflect.TypeVariable;\nimport java.lang.reflect.WildcardType;\nimport java.util.Arrays;\nimport java.util.NoSuchElementException;\nimport java.util.Objects;\nimport javax.annotation.Nullable;\nimport kotlin.Unit;\nimport okhttp3.ResponseBody;\nimport okio.Buffer;\n\nfinal class Utils {\n static final Type[] EMPTY_TYPE_ARRAY = new Type[0];\n\n private Utils() {\n // No instances.\n }\n\n static RuntimeException methodError(Method method, String message, Object... args) {\n return methodError(method, null, message, args);\n }\n\n @SuppressWarnings(\"AnnotateFormatMethod\")\n static RuntimeException methodError(\n Method method, @Nullable Throwable cause, String message, Object... args) {\n message = String.format(message, args);\n return new IllegalArgumentException(\n message\n + \"\\n for method \"\n + method.getDeclaringClass().getSimpleName()\n + \".\"\n + method.getName(),\n cause);\n }\n\n static RuntimeException parameterError(\n Method method, Throwable cause, int p, String message, Object... args) {\n String paramDesc = Platform.reflection.describeMethodParameter(method, p);\n return methodError(method, cause, message + \" (\" + paramDesc + \")\", args);\n }\n\n static RuntimeException parameterError(Method method, int p, String message, Object... args) {\n String paramDesc = Platform.reflection.describeMethodParameter(method, p);\n return methodError(method, message + \" (\" + paramDesc + \")\", args);\n }\n\n static Class getRawType(Type type) {\n Objects.requireNonNull(type, \"type == null\");\n\n if (type instanceof Class) {\n // Type is a normal class.\n return (Class) type;\n }\n if (type instanceof ParameterizedType) {\n ParameterizedType parameterizedType = (ParameterizedType) type;\n\n // I'm not exactly sure why getRawType() returns Type instead of Class. Neal isn't either but\n // suspects some pathological case related to nested classes exists.\n Type rawType = parameterizedType.getRawType();\n if (!(rawType instanceof Class)) throw new IllegalArgumentException();\n return (Class) rawType;\n }\n if (type instanceof GenericArrayType) {\n Type componentType = ((GenericArrayType) type).getGenericComponentType();\n return Array.newInstance(getRawType(componentType), 0).getClass();\n }\n if (type instanceof TypeVariable) {\n // We could use the variable's bounds, but that won't work if there are multiple. Having a raw\n // type that's more general than necessary is okay.\n return Object.class;\n }\n if (type instanceof WildcardType) {\n return getRawType(((WildcardType) type).getUpperBounds()[0]);\n }\n\n throw new IllegalArgumentException(\n \"Expected a Class, ParameterizedType, or \"\n + \"GenericArrayType, but <\"\n + type\n + \"> is of type \"\n + type.getClass().getName());\n }\n\n /** Returns true if {@code a} and {@code b} are equal. */\n static boolean equals(Type a, Type b) {\n if (a == b) {\n return true; // Also handles (a == null && b == null).\n\n } else if (a instanceof Class) {\n return a.equals(b); // Class already specifies equals().\n\n } else if (a instanceof ParameterizedType) {\n if (!(b instanceof ParameterizedType)) return false;\n ParameterizedType pa = (ParameterizedType) a;\n ParameterizedType pb = (ParameterizedType) b;\n Object ownerA = pa.getOwnerType();\n Object ownerB = pb.getOwnerType();\n boolean ownersAreEqual = ownerA == ownerB || (ownerA != null && ownerA.equals(ownerB));\n boolean rawTypesAreEqual = pa.getRawType().equals(pb.getRawType());\n boolean typeArgumentsAreEqual =\n Arrays.equals(pa.getActualTypeArguments(), pb.getActualTypeArguments());\n\n return ownersAreEqual && rawTypesAreEqual && typeArgumentsAreEqual;\n\n } else if (a instanceof GenericArrayType) {\n if (!(b instanceof GenericArrayType)) return false;\n GenericArrayType ga = (GenericArrayType) a;\n GenericArrayType gb = (GenericArrayType) b;\n return equals(ga.getGenericComponentType(), gb.getGenericComponentType());\n\n } else if (a instanceof WildcardType) {\n if (!(b instanceof WildcardType)) return false;\n WildcardType wa = (WildcardType) a;\n WildcardType wb = (WildcardType) b;\n return Arrays.equals(wa.getUpperBounds(), wb.getUpperBounds())\n && Arrays.equals(wa.getLowerBounds(), wb.getLowerBounds());\n\n } else if (a instanceof TypeVariable) {\n if (!(b instanceof TypeVariable)) return false;\n TypeVariable va = (TypeVariable) a;\n TypeVariable vb = (TypeVariable) b;\n return va.getGenericDeclaration() == vb.getGenericDeclaration()\n && va.getName().equals(vb.getName());\n\n } else {\n return false; // This isn't a type we support!\n }\n }\n\n /**\n * Returns the generic supertype for {@code supertype}. For example, given a class {@code\n * IntegerSet}, the result for when supertype is {@code Set.class} is {@code Set} and the\n * result when the supertype is {@code Collection.class} is {@code Collection}.\n */\n static Type getGenericSupertype(Type context, Class rawType, Class toResolve) {\n if (toResolve == rawType) return context;\n\n // We skip searching through interfaces if unknown is an interface.\n if (toResolve.isInterface()) {\n Class[] interfaces = rawType.getInterfaces();\n for (int i = 0, length = interfaces.length; i < length; i++) {\n if (interfaces[i] == toResolve) {\n return rawType.getGenericInterfaces()[i];\n } else if (toResolve.isAssignableFrom(interfaces[i])) {\n return getGenericSupertype(rawType.getGenericInterfaces()[i], interfaces[i], toResolve);\n }\n }\n }\n\n // Check our supertypes.\n if (!rawType.isInterface()) {\n while (rawType != Object.class) {\n Class rawSupertype = rawType.getSuperclass();\n if (rawSupertype == toResolve) {\n return rawType.getGenericSuperclass();\n } else if (toResolve.isAssignableFrom(rawSupertype)) {\n return getGenericSupertype(rawType.getGenericSuperclass(), rawSupertype, toResolve);\n }\n rawType = rawSupertype;\n }\n }\n\n // We can't resolve this further.\n return toResolve;\n }\n\n private static int indexOf(Object[] array, Object toFind) {\n for (int i = 0; i < array.length; i++) {\n if (toFind.equals(array[i])) return i;\n }\n throw new NoSuchElementException();\n }\n\n static String typeToString(Type type) {\n return type instanceof Class ? ((Class) type).getName() : type.toString();\n }\n\n /**\n * Returns the generic form of {@code supertype}. For example, if this is {@code\n * ArrayList}, this returns {@code Iterable} given the input {@code\n * Iterable.class}.\n *\n * @param supertype a superclass of, or interface implemented by, this.\n */\n static Type getSupertype(Type context, Class contextRawType, Class supertype) {\n if (!supertype.isAssignableFrom(contextRawType)) throw new IllegalArgumentException();\n return resolve(\n context, contextRawType, getGenericSupertype(context, contextRawType, supertype));\n }\n\n static Type resolve(Type context, Class contextRawType, Type toResolve) {\n // This implementation is made a little more complicated in an attempt to avoid object-creation.\n while (true) {\n if (toResolve instanceof TypeVariable) {\n TypeVariable typeVariable = (TypeVariable) toResolve;\n toResolve = resolveTypeVariable(context, contextRawType, typeVariable);\n if (toResolve == typeVariable) {\n return toResolve;\n }\n\n } else if (toResolve instanceof Class && ((Class) toResolve).isArray()) {\n Class original = (Class) toResolve;\n Type componentType = original.getComponentType();\n Type newComponentType = resolve(context, contextRawType, componentType);\n return componentType == newComponentType\n ? original\n : new GenericArrayTypeImpl(newComponentType);\n\n } else if (toResolve instanceof GenericArrayType) {\n GenericArrayType original = (GenericArrayType) toResolve;\n Type componentType = original.getGenericComponentType();\n Type newComponentType = resolve(context, contextRawType, componentType);\n return componentType == newComponentType\n ? original\n : new GenericArrayTypeImpl(newComponentType);\n\n } else if (toResolve instanceof ParameterizedType) {\n ParameterizedType original = (ParameterizedType) toResolve;\n Type ownerType = original.getOwnerType();\n Type newOwnerType = resolve(context, contextRawType, ownerType);\n boolean changed = newOwnerType != ownerType;\n\n Type[] args = original.getActualTypeArguments();\n for (int t = 0, length = args.length; t < length; t++) {\n Type resolvedTypeArgument = resolve(context, contextRawType, args[t]);\n if (resolvedTypeArgument != args[t]) {\n if (!changed) {\n args = args.clone();\n changed = true;\n }\n args[t] = resolvedTypeArgument;\n }\n }\n\n return changed\n ? new ParameterizedTypeImpl(newOwnerType, original.getRawType(), args)\n : original;\n\n } else if (toResolve instanceof WildcardType) {\n WildcardType original = (WildcardType) toResolve;\n Type[] originalLowerBound = original.getLowerBounds();\n Type[] originalUpperBound = original.getUpperBounds();\n\n if (originalLowerBound.length == 1) {\n Type lowerBound = resolve(context, contextRawType, originalLowerBound[0]);\n if (lowerBound != originalLowerBound[0]) {\n return new WildcardTypeImpl(new Type[] {Object.class}, new Type[] {lowerBound});\n }\n } else if (originalUpperBound.length == 1) {\n Type upperBound = resolve(context, contextRawType, originalUpperBound[0]);\n if (upperBound != originalUpperBound[0]) {\n return new WildcardTypeImpl(new Type[] {upperBound}, EMPTY_TYPE_ARRAY);\n }\n }\n return original;\n\n } else {\n return toResolve;\n }\n }\n }\n\n private static Type resolveTypeVariable(\n Type context, Class contextRawType, TypeVariable unknown) {\n Class declaredByRaw = declaringClassOf(unknown);\n\n // We can't reduce this further.\n if (declaredByRaw == null) return unknown;\n\n Type declaredBy = getGenericSupertype(context, contextRawType, declaredByRaw);\n if (declaredBy instanceof ParameterizedType) {\n int index = indexOf(declaredByRaw.getTypeParameters(), unknown);\n return ((ParameterizedType) declaredBy).getActualTypeArguments()[index];\n }\n\n return unknown;\n }\n\n /**\n * Returns the declaring class of {@code typeVariable}, or {@code null} if it was not declared by\n * a class.\n */\n private static @Nullable Class declaringClassOf(TypeVariable typeVariable) {\n GenericDeclaration genericDeclaration = typeVariable.getGenericDeclaration();\n return genericDeclaration instanceof Class ? (Class) genericDeclaration : null;\n }\n\n static void checkNotPrimitive(Type type) {\n if (type instanceof Class && ((Class) type).isPrimitive()) {\n throw new IllegalArgumentException();\n }\n }\n\n /** Returns true if {@code annotations} contains an instance of {@code cls}. */\n static boolean isAnnotationPresent(Annotation[] annotations, Class cls) {\n for (Annotation annotation : annotations) {\n if (cls.isInstance(annotation)) {\n return true;\n }\n }\n return false;\n }\n\n static ResponseBody buffer(final ResponseBody body) throws IOException {\n Buffer buffer = new Buffer();\n body.source().readAll(buffer);\n return ResponseBody.create(body.contentType(), body.contentLength(), buffer);\n }\n\n static Type getParameterUpperBound(int index, ParameterizedType type) {\n Type[] types = type.getActualTypeArguments();\n if (index < 0 || index >= types.length) {\n throw new IllegalArgumentException(\n \"Index \" + index + \" not in range [0,\" + types.length + \") for \" + type);\n }\n Type paramType = types[index];\n if (paramType instanceof WildcardType) {\n return ((WildcardType) paramType).getUpperBounds()[0];\n }\n return paramType;\n }\n\n static Type getParameterLowerBound(int index, ParameterizedType type) {\n Type paramType = type.getActualTypeArguments()[index];\n if (paramType instanceof WildcardType) {\n return ((WildcardType) paramType).getLowerBounds()[0];\n }\n return paramType;\n }\n\n static boolean hasUnresolvableType(@Nullable Type type) {\n if (type instanceof Class) {\n return false;\n }\n if (type instanceof ParameterizedType) {\n ParameterizedType parameterizedType = (ParameterizedType) type;\n for (Type typeArgument : parameterizedType.getActualTypeArguments()) {\n if (hasUnresolvableType(typeArgument)) {\n return true;\n }\n }\n return false;\n }\n if (type instanceof GenericArrayType) {\n return hasUnresolvableType(((GenericArrayType) type).getGenericComponentType());\n }\n if (type instanceof TypeVariable) {\n return true;\n }\n if (type instanceof WildcardType) {\n return true;\n }\n String className = type == null ? \"null\" : type.getClass().getName();\n throw new IllegalArgumentException(\n \"Expected a Class, ParameterizedType, or \"\n + \"GenericArrayType, but <\"\n + type\n + \"> is of type \"\n + className);\n }\n\n static final class ParameterizedTypeImpl implements ParameterizedType {\n private final @Nullable Type ownerType;\n private final Type rawType;\n private final Type[] typeArguments;\n\n ParameterizedTypeImpl(@Nullable Type ownerType, Type rawType, Type... typeArguments) {\n // Require an owner type if the raw type needs it.\n if (rawType instanceof Class\n && (ownerType == null) != (((Class) rawType).getEnclosingClass() == null)) {\n throw new IllegalArgumentException();\n }\n\n for (Type typeArgument : typeArguments) {\n Objects.requireNonNull(typeArgument, \"typeArgument == null\");\n checkNotPrimitive(typeArgument);\n }\n\n this.ownerType = ownerType;\n this.rawType = rawType;\n this.typeArguments = typeArguments.clone();\n }\n\n @Override\n public Type[] getActualTypeArguments() {\n return typeArguments.clone();\n }\n\n @Override\n public Type getRawType() {\n return rawType;\n }\n\n @Override\n public @Nullable Type getOwnerType() {\n return ownerType;\n }\n\n @Override\n public boolean equals(Object other) {\n return other instanceof ParameterizedType && Utils.equals(this, (ParameterizedType) other);\n }\n\n @Override\n public int hashCode() {\n return Arrays.hashCode(typeArguments)\n ^ rawType.hashCode()\n ^ (ownerType != null ? ownerType.hashCode() : 0);\n }\n\n @Override\n public String toString() {\n if (typeArguments.length == 0) return typeToString(rawType);\n StringBuilder result = new StringBuilder(30 * (typeArguments.length + 1));\n result.append(typeToString(rawType));\n result.append(\"<\").append(typeToString(typeArguments[0]));\n for (int i = 1; i < typeArguments.length; i++) {\n result.append(\", \").append(typeToString(typeArguments[i]));\n }\n return result.append(\">\").toString();\n }\n }\n\n private static final class GenericArrayTypeImpl implements GenericArrayType {\n private final Type componentType;\n\n GenericArrayTypeImpl(Type componentType) {\n this.componentType = componentType;\n }\n\n @Override\n public Type getGenericComponentType() {\n return componentType;\n }\n\n @Override\n public boolean equals(Object o) {\n return o instanceof GenericArrayType && Utils.equals(this, (GenericArrayType) o);\n }\n\n @Override\n public int hashCode() {\n return componentType.hashCode();\n }\n\n @Override\n public String toString() {\n return typeToString(componentType) + \"[]\";\n }\n }\n\n /**\n * The WildcardType interface supports multiple upper bounds and multiple lower bounds. We only\n * support what the Java 6 language needs - at most one bound. If a lower bound is set, the upper\n * bound must be Object.class.\n */\n private static final class WildcardTypeImpl implements WildcardType {\n private final Type upperBound;\n private final @Nullable Type lowerBound;\n\n WildcardTypeImpl(Type[] upperBounds, Type[] lowerBounds) {\n if (lowerBounds.length > 1) throw new IllegalArgumentException();\n if (upperBounds.length != 1) throw new IllegalArgumentException();\n\n if (lowerBounds.length == 1) {\n if (lowerBounds[0] == null) throw new NullPointerException();\n checkNotPrimitive(lowerBounds[0]);\n if (upperBounds[0] != Object.class) throw new IllegalArgumentException();\n this.lowerBound = lowerBounds[0];\n this.upperBound = Object.class;\n } else {\n if (upperBounds[0] == null) throw new NullPointerException();\n checkNotPrimitive(upperBounds[0]);\n this.lowerBound = null;\n this.upperBound = upperBounds[0];\n }\n }\n\n @Override\n public Type[] getUpperBounds() {\n return new Type[] {upperBound};\n }\n\n @Override\n public Type[] getLowerBounds() {\n return lowerBound != null ? new Type[] {lowerBound} : EMPTY_TYPE_ARRAY;\n }\n\n @Override\n public boolean equals(Object other) {\n return other instanceof WildcardType && Utils.equals(this, (WildcardType) other);\n }\n\n @Override\n public int hashCode() {\n // This equals Arrays.hashCode(getLowerBounds()) ^ Arrays.hashCode(getUpperBounds()).\n return (lowerBound != null ? 31 + lowerBound.hashCode() : 1) ^ (31 + upperBound.hashCode());\n }\n\n @Override\n public String toString() {\n if (lowerBound != null) return \"? super \" + typeToString(lowerBound);\n if (upperBound == Object.class) return \"?\";\n return \"? extends \" + typeToString(upperBound);\n }\n }\n\n // https://github.com/ReactiveX/RxJava/blob/6a44e5d0543a48f1c378dc833a155f3f71333bc2/\n // src/main/java/io/reactivex/exceptions/Exceptions.java#L66\n static void throwIfFatal(Throwable t) {\n if (t instanceof VirtualMachineError) {\n throw (VirtualMachineError) t;\n } else if (t instanceof ThreadDeath) {\n throw (ThreadDeath) t;\n } else if (t instanceof LinkageError) {\n throw (LinkageError) t;\n }\n }\n\n /** Not volatile because we don't mind multiple threads discovering this. */\n private static boolean checkForKotlinUnit = true;\n\n static boolean isUnit(Type type) {\n if (checkForKotlinUnit) {\n try {\n return type == Unit.class;\n } catch (NoClassDefFoundError ignored) {\n checkForKotlinUnit = false;\n }\n }\n return false;\n }\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/Body.java", "content": "/*\n * Copyright (C) 2011 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.PARAMETER;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\n/**\n * Use this annotation on a service method param when you want to directly control the request body\n * of a POST/PUT request (instead of sending in as request parameters or form-style request body).\n * The object will be serialized using the {@link Retrofit Retrofit} instance {@link Converter\n * Converter} and the result will be set directly as the request body.\n *\n *

Body parameters may not be {@code null}.\n */\n@Documented\n@Target(PARAMETER)\n@Retention(RUNTIME)\npublic @interface Body {}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/DELETE.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.METHOD;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport okhttp3.HttpUrl;\n\n/** Make a DELETE request. */\n@Documented\n@Target(METHOD)\n@Retention(RUNTIME)\npublic @interface DELETE {\n /**\n * A relative or absolute path, or full URL of the endpoint. This value is optional if the first\n * parameter of the method is annotated with {@link Url @Url}.\n *\n *

See {@linkplain retrofit2.Retrofit.Builder#baseUrl(HttpUrl) base URL} for details of how\n * this is resolved against a base URL to create the full endpoint URL.\n */\n String value() default \"\";\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/Field.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.PARAMETER;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport java.lang.reflect.Type;\nimport retrofit2.Retrofit;\n\n/**\n * Named pair for a form-encoded request.\n *\n *

Values are converted to strings using {@link Retrofit#stringConverter(Type, Annotation[])} (or\n * {@link Object#toString()}, if no matching string converter is installed) and then form URL\n * encoded. {@code null} values are ignored. Passing a {@link java.util.List List} or array will\n * result in a field pair for each non-{@code null} item.\n *\n *

Simple Example:\n *\n * 

\n * @FormUrlEncoded\n * @POST(\"/\")\n * Call<ResponseBody> example(\n *     @Field(\"name\") String name,\n *     @Field(\"occupation\") String occupation);\n *
\n *\n * Calling with {@code foo.example(\"Bob Smith\", \"President\")} yields a request body of {@code\n * name=Bob+Smith&occupation=President}.\n *\n *

Array/Varargs Example:\n *\n * 

\n * @FormUrlEncoded\n * @POST(\"/list\")\n * Call<ResponseBody> example(@Field(\"name\") String... names);\n *
\n *\n * Calling with {@code foo.example(\"Bob Smith\", \"Jane Doe\")} yields a request body of {@code\n * name=Bob+Smith&name=Jane+Doe}.\n *\n * @see FormUrlEncoded\n * @see FieldMap\n */\n@Documented\n@Target(PARAMETER)\n@Retention(RUNTIME)\npublic @interface Field {\n String value();\n\n /** Specifies whether the {@linkplain #value() name} and value are already URL encoded. */\n boolean encoded() default false;\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/FieldMap.java", "content": "/*\n * Copyright (C) 2014 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.PARAMETER;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\n\n/**\n * Named key/value pairs for a form-encoded request.\n *\n *

Simple Example:\n *\n * 

\n * @FormUrlEncoded\n * @POST(\"/things\")\n * Call<ResponseBody> things(@FieldMap Map<String, String> fields);\n *
\n *\n * Calling with {@code foo.things(ImmutableMap.of(\"foo\", \"bar\", \"kit\", \"kat\")} yields a request body\n * of {@code foo=bar&kit=kat}.\n *\n *

A {@code null} value for the map, as a key, or as a value is not allowed.\n *\n * @see FormUrlEncoded\n * @see Field\n */\n@Documented\n@Target(PARAMETER)\n@Retention(RUNTIME)\npublic @interface FieldMap {\n /** Specifies whether the names and values are already URL encoded. */\n boolean encoded() default false;\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/FormUrlEncoded.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.METHOD;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\n\n/**\n * Denotes that the request body will use form URL encoding. Fields should be declared as parameters\n * and annotated with {@link Field @Field}.\n *\n *

Requests made with this annotation will have {@code application/x-www-form-urlencoded} MIME\n * type. Field names and values will be UTF-8 encoded before being URI-encoded in accordance to RFC-3986.\n */\n@Documented\n@Target(METHOD)\n@Retention(RUNTIME)\npublic @interface FormUrlEncoded {}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/GET.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.METHOD;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport okhttp3.HttpUrl;\n\n/** Make a GET request. */\n@Documented\n@Target(METHOD)\n@Retention(RUNTIME)\npublic @interface GET {\n /**\n * A relative or absolute path, or full URL of the endpoint. This value is optional if the first\n * parameter of the method is annotated with {@link Url @Url}.\n *\n *

See {@linkplain retrofit2.Retrofit.Builder#baseUrl(HttpUrl) base URL} for details of how\n * this is resolved against a base URL to create the full endpoint URL.\n */\n String value() default \"\";\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/HEAD.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.METHOD;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport okhttp3.HttpUrl;\n\n/** Make a HEAD request. */\n@Documented\n@Target(METHOD)\n@Retention(RUNTIME)\npublic @interface HEAD {\n /**\n * A relative or absolute path, or full URL of the endpoint. This value is optional if the first\n * parameter of the method is annotated with {@link Url @Url}.\n *\n *

See {@linkplain retrofit2.Retrofit.Builder#baseUrl(HttpUrl) base URL} for details of how\n * this is resolved against a base URL to create the full endpoint URL.\n */\n String value() default \"\";\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/HTTP.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.METHOD;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport okhttp3.HttpUrl;\n\n/**\n * Use a custom HTTP verb for a request.\n *\n * 

\n * interface Service {\n *   @HTTP(method = \"CUSTOM\", path = \"custom/endpoint/\")\n *   Call<ResponseBody> customEndpoint();\n * }\n *
\n *\n * This annotation can also used for sending {@code DELETE} with a request body:\n *\n * 
\n * interface Service {\n *   @HTTP(method = \"DELETE\", path = \"remove/\", hasBody = true)\n *   Call<ResponseBody> deleteObject(@Body RequestBody object);\n * }\n *
\n */\n@Documented\n@Target(METHOD)\n@Retention(RUNTIME)\npublic @interface HTTP {\n String method();\n\n /**\n * A relative or absolute path, or full URL of the endpoint. This value is optional if the first\n * parameter of the method is annotated with {@link Url @Url}.\n *\n *

See {@linkplain retrofit2.Retrofit.Builder#baseUrl(HttpUrl) base URL} for details of how\n * this is resolved against a base URL to create the full endpoint URL.\n */\n String path() default \"\";\n\n boolean hasBody() default false;\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/Header.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.PARAMETER;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\n\n/**\n * Replaces the header with the value of its target.\n *\n * 

\n * @GET(\"/\")\n * Call<ResponseBody> foo(@Header(\"Accept-Language\") String lang);\n *
\n *\n * Header parameters may be {@code null} which will omit them from the request. Passing a {@link\n * java.util.List List} or array will result in a header for each non-{@code null} item.\n *\n *

Parameter keys and values only allows ascii values by default. Specify {@link\n * #allowUnsafeNonAsciiValues() allowUnsafeNonAsciiValues=true} to change this behavior.\n *\n * 

\n * @GET(\"/\")\n * Call<ResponseBody> foo(@Header(\"Accept-Language\", allowUnsafeNonAsciiValues=true) String lang);\n *
\n *\n *

Note: Headers do not overwrite each other. All headers with the same name\n * will be included in the request.\n *\n * @see Headers\n * @see HeaderMap\n */\n@Documented\n@Retention(RUNTIME)\n@Target(PARAMETER)\npublic @interface Header {\n\n /** The query parameter name. */\n String value();\n\n /**\n * Specifies whether the parameter {@linkplain #value() name} and value are already URL encoded.\n */\n boolean allowUnsafeNonAsciiValues() default false;\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/HeaderMap.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.PARAMETER;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport java.lang.reflect.Type;\nimport java.util.Map;\nimport retrofit2.Retrofit;\n\n/**\n * Adds headers specified in the {@link Map} or {@link okhttp3.Headers}.\n *\n *

Values in the map are converted to strings using {@link Retrofit#stringConverter(Type,\n * Annotation[])} (or {@link Object#toString()}, if no matching string converter is installed).\n *\n *

Simple Example:\n *\n * 

\n * @GET(\"/search\")\n * void list(@HeaderMap Map<String, String> headers);\n *\n * ...\n *\n * // The following call yields /search with headers\n * // Accept: text/plain and Accept-Charset: utf-8\n * foo.list(ImmutableMap.of(\"Accept\", \"text/plain\", \"Accept-Charset\", \"utf-8\"));\n *
\n *\n *

Map keys and values representing parameter values allow only ascii values by default.\n * Specify {@link #allowUnsafeNonAsciiValues() allowUnsafeNonAsciiValues=true} to change this behavior.\n *\n * 

\n * @GET(\"/search\")\n * void list(@HeaderMap(allowUnsafeNonAsciiValues=true) Map<String, String> headers);\n *
\n *\n * @see Header\n * @see Headers\n */\n@Documented\n@Target(PARAMETER)\n@Retention(RUNTIME)\npublic @interface HeaderMap {\n /** Specifies whether the parameter values are allowed with unsafe non ascii values. */\n boolean allowUnsafeNonAsciiValues() default false;\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/Headers.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.METHOD;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\n\n/**\n * Adds headers literally supplied in the {@code value}.\n *\n * 
\n * @Headers(\"Cache-Control: max-age=640000\")\n * @GET(\"/\")\n * ...\n *\n * @Headers({\n *   \"X-Foo: Bar\",\n *   \"X-Ping: Pong\"\n * })\n * @GET(\"/\")\n * ...\n *
\n *\n *

Parameter keys and values only allows ascii values by default. Specify {@link\n * #allowUnsafeNonAsciiValues() allowUnsafeNonAsciiValues=true} to change this behavior.\n *\n *

@Headers({ \"X-Foo: Bar\", \"X-Ping: Pong\" }, allowUnsafeNonAsciiValues=true) @GET(\"/\")\n *\n *

Note: Headers do not overwrite each other. All headers with the same name\n * will be included in the request.\n *\n * @see Header\n * @see HeaderMap\n */\n@Documented\n@Target(METHOD)\n@Retention(RUNTIME)\npublic @interface Headers {\n\n /** The query parameter name. */\n String[] value();\n\n /**\n * Specifies whether the parameter {@linkplain #value() name} and value are already URL encoded.\n */\n boolean allowUnsafeNonAsciiValues() default false;\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/Multipart.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.METHOD;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\n\n/**\n * Denotes that the request body is multi-part. Parts should be declared as parameters and annotated\n * with {@link Part @Part}.\n */\n@Documented\n@Target(METHOD)\n@Retention(RUNTIME)\npublic @interface Multipart {}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/OPTIONS.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.METHOD;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport okhttp3.HttpUrl;\n\n/** Make an OPTIONS request. */\n@Documented\n@Target(METHOD)\n@Retention(RUNTIME)\npublic @interface OPTIONS {\n /**\n * A relative or absolute path, or full URL of the endpoint. This value is optional if the first\n * parameter of the method is annotated with {@link Url @Url}.\n *\n *

See {@linkplain retrofit2.Retrofit.Builder#baseUrl(HttpUrl) base URL} for details of how\n * this is resolved against a base URL to create the full endpoint URL.\n */\n String value() default \"\";\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/PATCH.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.METHOD;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport okhttp3.HttpUrl;\n\n/** Make a PATCH request. */\n@Documented\n@Target(METHOD)\n@Retention(RUNTIME)\npublic @interface PATCH {\n /**\n * A relative or absolute path, or full URL of the endpoint. This value is optional if the first\n * parameter of the method is annotated with {@link Url @Url}.\n *\n *

See {@linkplain retrofit2.Retrofit.Builder#baseUrl(HttpUrl) base URL} for details of how\n * this is resolved against a base URL to create the full endpoint URL.\n */\n String value() default \"\";\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/POST.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.METHOD;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport okhttp3.HttpUrl;\n\n/** Make a POST request. */\n@Documented\n@Target(METHOD)\n@Retention(RUNTIME)\npublic @interface POST {\n /**\n * A relative or absolute path, or full URL of the endpoint. This value is optional if the first\n * parameter of the method is annotated with {@link Url @Url}.\n *\n *

See {@linkplain retrofit2.Retrofit.Builder#baseUrl(HttpUrl) base URL} for details of how\n * this is resolved against a base URL to create the full endpoint URL.\n */\n String value() default \"\";\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/PUT.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.METHOD;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport okhttp3.HttpUrl;\n\n/** Make a PUT request. */\n@Documented\n@Target(METHOD)\n@Retention(RUNTIME)\npublic @interface PUT {\n /**\n * A relative or absolute path, or full URL of the endpoint. This value is optional if the first\n * parameter of the method is annotated with {@link Url @Url}.\n *\n *

See {@linkplain retrofit2.Retrofit.Builder#baseUrl(HttpUrl) base URL} for details of how\n * this is resolved against a base URL to create the full endpoint URL.\n */\n String value() default \"\";\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/Part.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.PARAMETER;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport retrofit2.Converter;\n\n/**\n * Denotes a single part of a multi-part request.\n *\n *

The parameter type on which this annotation exists will be processed in one of three ways:\n *\n *

    \n *
  • If the type is {@link okhttp3.MultipartBody.Part} the contents will be used directly. Omit\n * the name from the annotation (i.e., {@code @Part MultipartBody.Part part}).\n *
  • If the type is {@link okhttp3.RequestBody RequestBody} the value will be used directly with\n * its content type. Supply the part name in the annotation (e.g., {@code @Part(\"foo\")\n * RequestBody foo}).\n *
  • Other object types will be converted to an appropriate representation by using {@linkplain\n * Converter a converter}. Supply the part name in the annotation (e.g., {@code @Part(\"foo\")\n * Image photo}).\n *
\n *\n *

Values may be {@code null} which will omit them from the request body.\n *\n *

\n *\n * 

\n * @Multipart\n * @POST(\"/\")\n * Call<ResponseBody> example(\n *     @Part(\"description\") String description,\n *     @Part(value = \"image\", encoding = \"8-bit\") RequestBody image);\n *
\n *\n *

Part parameters may not be {@code null}.\n */\n@Documented\n@Target(PARAMETER)\n@Retention(RUNTIME)\npublic @interface Part {\n /**\n * The name of the part. Required for all parameter types except {@link\n * okhttp3.MultipartBody.Part}.\n */\n String value() default \"\";\n\n /** The {@code Content-Transfer-Encoding} of this part. */\n String encoding() default \"binary\";\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/PartMap.java", "content": "/*\n * Copyright (C) 2014 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.PARAMETER;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport retrofit2.Converter;\n\n/**\n * Denotes name and value parts of a multi-part request.\n *\n *

Values of the map on which this annotation exists will be processed in one of two ways:\n *\n *

    \n *
  • If the type is {@link okhttp3.RequestBody RequestBody} the value will be used directly with\n * its content type.\n *
  • Other object types will be converted to an appropriate representation by using {@linkplain\n * Converter a converter}.\n *
\n *\n *

\n *\n * 

\n * @Multipart\n * @POST(\"/upload\")\n * Call<ResponseBody> upload(\n *     @Part(\"file\") RequestBody file,\n *     @PartMap Map<String, RequestBody> params);\n *
\n *\n *

A {@code null} value for the map, as a key, or as a value is not allowed.\n *\n * @see Multipart\n * @see Part\n */\n@Documented\n@Target(PARAMETER)\n@Retention(RUNTIME)\npublic @interface PartMap {\n /** The {@code Content-Transfer-Encoding} of the parts. */\n String encoding() default \"binary\";\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/Path.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.PARAMETER;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport java.lang.reflect.Type;\nimport retrofit2.Retrofit;\n\n/**\n * Named replacement in a URL path segment. Values are converted to strings using {@link\n * Retrofit#stringConverter(Type, Annotation[])} (or {@link Object#toString()}, if no matching\n * string converter is installed) and then URL encoded.\n *\n *

Simple example:\n *\n * 

\n * @GET(\"/image/{id}\")\n * Call<ResponseBody> example(@Path(\"id\") int id);\n *
\n *\n * Calling with {@code foo.example(1)} yields {@code /image/1}.\n *\n *

Values are URL encoded by default. Disable with {@code encoded=true}.\n *\n * 

\n * @GET(\"/user/{name}\")\n * Call<ResponseBody> encoded(@Path(\"name\") String name);\n *\n * @GET(\"/user/{name}\")\n * Call<ResponseBody> notEncoded(@Path(value=\"name\", encoded=true) String name);\n *
\n *\n * Calling {@code foo.encoded(\"John%Doe\")} yields {@code /user/John%25Doe} whereas {@code\n * foo.notEncoded(\"John%Doe\")} yields {@code /user/John%Doe}.\n *\n *

Path parameters may not be {@code null}.\n */\n@Documented\n@Retention(RUNTIME)\n@Target(PARAMETER)\npublic @interface Path {\n String value();\n\n /**\n * Specifies whether the argument value to the annotated method parameter is already URL encoded.\n */\n boolean encoded() default false;\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/Query.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.PARAMETER;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport java.lang.reflect.Type;\nimport retrofit2.Retrofit;\n\n/**\n * Query parameter appended to the URL.\n *\n *

Values are converted to strings using {@link Retrofit#stringConverter(Type, Annotation[])} (or\n * {@link Object#toString()}, if no matching string converter is installed) and then URL encoded.\n * {@code null} values are ignored. Passing a {@link java.util.List List} or array will result in a\n * query parameter for each non-{@code null} item.\n *\n *

Simple Example:\n *\n * 

\n * @GET(\"/friends\")\n * Call<ResponseBody> friends(@Query(\"page\") int page);\n *
\n *\n * Calling with {@code foo.friends(1)} yields {@code /friends?page=1}.\n *\n *

Example with {@code null}:\n *\n * 

\n * @GET(\"/friends\")\n * Call<ResponseBody> friends(@Query(\"group\") String group);\n *
\n *\n * Calling with {@code foo.friends(null)} yields {@code /friends}.\n *\n *

Array/Varargs Example:\n *\n * 

\n * @GET(\"/friends\")\n * Call<ResponseBody> friends(@Query(\"group\") String... groups);\n *
\n *\n * Calling with {@code foo.friends(\"coworker\", \"bowling\")} yields {@code\n * /friends?group=coworker&group=bowling}.\n *\n *

Parameter names and values are URL encoded by default. Specify {@link #encoded() encoded=true}\n * to change this behavior.\n *\n * 

\n * @GET(\"/friends\")\n * Call<ResponseBody> friends(@Query(value=\"group\", encoded=true) String group);\n *
\n *\n * Calling with {@code foo.friends(\"foo+bar\"))} yields {@code /friends?group=foo+bar}.\n *\n * @see QueryMap\n * @see QueryName\n */\n@Documented\n@Target(PARAMETER)\n@Retention(RUNTIME)\npublic @interface Query {\n /** The query parameter name. */\n String value();\n\n /**\n * Specifies whether the parameter {@linkplain #value() name} and value are already URL encoded.\n */\n boolean encoded() default false;\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/QueryMap.java", "content": "/*\n * Copyright (C) 2014 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.PARAMETER;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport java.lang.reflect.Type;\nimport retrofit2.Retrofit;\n\n/**\n * Query parameter keys and values appended to the URL.\n *\n *

Values are converted to strings using {@link Retrofit#stringConverter(Type, Annotation[])} (or\n * {@link Object#toString()}, if no matching string converter is installed).\n *\n *

Simple Example:\n *\n * 

\n * @GET(\"/friends\")\n * Call<ResponseBody> friends(@QueryMap Map<String, String> filters);\n *
\n *\n * Calling with {@code foo.friends(ImmutableMap.of(\"group\", \"coworker\", \"age\", \"42\"))} yields {@code\n * /friends?group=coworker&age=42}.\n *\n *

Map keys and values representing parameter values are URL encoded by default. Specify {@link\n * #encoded() encoded=true} to change this behavior.\n *\n * 

\n * @GET(\"/friends\")\n * Call<ResponseBody> friends(@QueryMap(encoded=true) Map<String, String> filters);\n *
\n *\n * Calling with {@code foo.list(ImmutableMap.of(\"group\", \"coworker+bowling\"))} yields {@code\n * /friends?group=coworker+bowling}.\n *\n *

A {@code null} value for the map, as a key, or as a value is not allowed.\n *\n * @see Query\n * @see QueryName\n */\n@Documented\n@Target(PARAMETER)\n@Retention(RUNTIME)\npublic @interface QueryMap {\n /** Specifies whether parameter names and values are already URL encoded. */\n boolean encoded() default false;\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/QueryName.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.PARAMETER;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\n\n/**\n * Query parameter appended to the URL that has no value.\n *\n *

Passing a {@link java.util.List List} or array will result in a query parameter for each\n * non-{@code null} item.\n *\n *

Simple Example:\n *\n * 

\n * @GET(\"/friends\")\n * Call<ResponseBody> friends(@QueryName String filter);\n *
\n *\n * Calling with {@code foo.friends(\"contains(Bob)\")} yields {@code /friends?contains(Bob)}.\n *\n *

Array/Varargs Example:\n *\n * 

\n * @GET(\"/friends\")\n * Call<ResponseBody> friends(@QueryName String... filters);\n *
\n *\n * Calling with {@code foo.friends(\"contains(Bob)\", \"age(42)\")} yields {@code\n * /friends?contains(Bob)&age(42)}.\n *\n *

Parameter names are URL encoded by default. Specify {@link #encoded() encoded=true} to change\n * this behavior.\n *\n * 

\n * @GET(\"/friends\")\n * Call<ResponseBody> friends(@QueryName(encoded=true) String filter);\n *
\n *\n * Calling with {@code foo.friends(\"name+age\"))} yields {@code /friends?name+age}.\n *\n * @see Query\n * @see QueryMap\n */\n@Documented\n@Target(PARAMETER)\n@Retention(RUNTIME)\npublic @interface QueryName {\n /** Specifies whether the parameter is already URL encoded. */\n boolean encoded() default false;\n}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/Streaming.java", "content": "/*\n * Copyright (C) 2014 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.METHOD;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport okhttp3.ResponseBody;\n\n/**\n * Treat the response body on methods returning {@link ResponseBody ResponseBody} as is, i.e.\n * without converting the body to {@code byte[]}.\n */\n@Documented\n@Target(METHOD)\n@Retention(RUNTIME)\npublic @interface Streaming {}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/Tag.java", "content": "/*\n * Copyright (C) 2019 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.PARAMETER;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\n\n/**\n * Adds the argument instance as a request tag using the type as the key.\n *\n * 
\n * @GET(\"/\")\n * Call<ResponseBody> foo(@Tag String tag);\n *
\n *\n * Tag arguments may be {@code null} which will omit them from the request. Passing a parameterized\n * type will use the raw type as the key (e.g., {@code List} uses {@code List.class}).\n * Primitive types will be boxed and stored using the boxed type\n * (e.g., {@code long} uses {@code Long.class}).\n * Duplicate tag types are not allowed.\n */\n@Documented\n@Target(PARAMETER)\n@Retention(RUNTIME)\npublic @interface Tag {}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/Url.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.http;\n\nimport static java.lang.annotation.ElementType.PARAMETER;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport okhttp3.HttpUrl;\nimport retrofit2.Retrofit;\n\n/**\n * URL resolved against the {@linkplain Retrofit#baseUrl() base URL}.\n *\n * 
\n * @GET\n * Call<ResponseBody> list(@Url String url);\n *
\n *\n *

See {@linkplain retrofit2.Retrofit.Builder#baseUrl(HttpUrl) base URL} for details of how the\n * value will be resolved against a base URL to create the full endpoint URL.\n */\n@Documented\n@Target(PARAMETER)\n@Retention(RUNTIME)\npublic @interface Url {}\n" }, { "path": "retrofit/src/main/java/retrofit2/http/package-info.java", "content": "// Copyright 2014 Square, Inc.\n\n/** Annotations for interface methods to control the HTTP request behavior. */\npackage retrofit2.http;\n" }, { "path": "retrofit/src/main/java/retrofit2/internal/EverythingIsNonNull.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.internal;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.ElementType;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.RetentionPolicy;\nimport javax.annotation.Nonnull;\nimport javax.annotation.meta.TypeQualifierDefault;\n\n/**\n * Extends {@code ParametersAreNonnullByDefault} to also apply to Method results and fields.\n *\n * @see javax.annotation.ParametersAreNonnullByDefault\n */\n@Documented\n@Nonnull\n@TypeQualifierDefault({ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER})\n@Retention(RetentionPolicy.RUNTIME)\npublic @interface EverythingIsNonNull {}\n" }, { "path": "retrofit/src/main/java/retrofit2/package-info.java", "content": "// Copyright 2014 Square, Inc.\n\n/**\n * Retrofit turns your REST API into a Java interface.\n *\n * 

\n * public interface GitHubService {\n *   @GET(\"/users/{user}/repos\")\n *   List<Repo> listRepos(@Path(\"user\") String user);\n * }\n *
\n */\n@retrofit2.internal.EverythingIsNonNull\npackage retrofit2;\n" }, { "path": "retrofit/src/main/java14/retrofit2/DefaultMethodSupport.java", "content": "/*\n * Copyright (C) 2024 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.lang.invoke.MethodHandles;\nimport java.lang.reflect.Method;\nimport javax.annotation.Nullable;\n\n/**\n * Java 14 allows a regular (i.e., non-trusted) lookup to succeed for invoking default methods.\n *

\n * https://bugs.openjdk.java.net/browse/JDK-8209005\n */\nfinal class DefaultMethodSupport {\n @Nullable\n static Object invoke(\n Method method, Class declaringClass, Object proxy, @Nullable Object[] args)\n throws Throwable {\n return MethodHandles.lookup()\n .unreflectSpecial(method, declaringClass)\n .bindTo(proxy)\n .invokeWithArguments(args);\n }\n\n private DefaultMethodSupport() {}\n}\n" }, { "path": "retrofit/src/main/java16/retrofit2/DefaultMethodSupport.java", "content": "/*\n * Copyright (C) 2024 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.lang.reflect.InvocationHandler;\nimport java.lang.reflect.Method;\nimport javax.annotation.Nullable;\n\n/** Java 16 finally has a public API for invoking default methods on a proxy. */\nfinal class DefaultMethodSupport {\n @Nullable\n static Object invoke(\n Method method, Class declaringClass, Object proxy, @Nullable Object[] args)\n throws Throwable {\n return InvocationHandler.invokeDefault(proxy, method, args);\n }\n\n private DefaultMethodSupport() {}\n}\n" }, { "path": "retrofit/src/main/resources/META-INF/proguard/retrofit2.pro", "content": "# Retrofit does reflection on generic parameters. InnerClasses is required to use Signature and\n# EnclosingMethod is required to use InnerClasses.\n-keepattributes Signature, InnerClasses, EnclosingMethod\n\n# Retrofit does reflection on method and parameter annotations.\n-keepattributes RuntimeVisibleAnnotations, RuntimeVisibleParameterAnnotations\n\n# Keep annotation default values (e.g., retrofit2.http.Field.encoded).\n-keepattributes AnnotationDefault\n\n# Retain service method parameters when optimizing.\n-keepclassmembers,allowshrinking,allowobfuscation interface * {\n @retrofit2.http.* ;\n}\n\n# Ignore annotation used for build tooling.\n-dontwarn org.codehaus.mojo.animal_sniffer.IgnoreJRERequirement\n\n# Ignore JSR 305 annotations for embedding nullability information.\n-dontwarn javax.annotation.**\n\n# Guarded by a NoClassDefFoundError try/catch and only used when on the classpath.\n-dontwarn kotlin.Unit\n\n# Top-level functions that can only be used by Kotlin.\n-dontwarn retrofit2.KotlinExtensions\n-dontwarn retrofit2.KotlinExtensions$*\n\n# With R8 full mode, it sees no subtypes of Retrofit interfaces since they are created with a Proxy\n# and replaces all potential values with null. Explicitly keeping the interfaces prevents this.\n-if interface * { @retrofit2.http.* ; }\n-keep,allowobfuscation interface <1>\n\n# Keep inherited services.\n-if interface * { @retrofit2.http.* ; }\n-keep,allowobfuscation interface * extends <1>\n\n# With R8 full mode generic signatures are stripped for classes that are not\n# kept. Suspend functions are wrapped in continuations where the type argument\n# is used.\n-keep,allowoptimization,allowshrinking,allowobfuscation class kotlin.coroutines.Continuation\n\n# R8 full mode strips generic signatures from return types if not kept.\n-if interface * { @retrofit2.http.* public *** *(...); }\n-keep,allowoptimization,allowshrinking,allowobfuscation class <3>\n\n# With R8 full mode generic signatures are stripped for classes that are not kept.\n-keep,allowoptimization,allowshrinking,allowobfuscation class retrofit2.Response\n" }, { "path": "retrofit/test-helpers/build.gradle", "content": "apply plugin: 'java-library'\n\ndependencies {\n api projects.retrofit\n\n compileOnly libs.findBugsAnnotations\n}\n" }, { "path": "retrofit/test-helpers/src/main/java/retrofit2/TestingUtils.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2;\n\nimport java.lang.reflect.Method;\nimport java.util.Arrays;\nimport okhttp3.Request;\nimport retrofit2.helpers.ToStringConverterFactory;\n\nfinal class TestingUtils {\n static Request buildRequest(Class cls, Retrofit.Builder builder, Object... args) {\n okhttp3.Call.Factory callFactory =\n request -> {\n throw new UnsupportedOperationException(\"Not implemented\");\n };\n\n Retrofit retrofit = builder.callFactory(callFactory).build();\n\n Method method = onlyMethod(cls);\n try {\n return RequestFactory.parseAnnotations(retrofit, cls, method).create(null, args);\n } catch (RuntimeException e) {\n throw e;\n } catch (Exception e) {\n throw new AssertionError(e);\n }\n }\n\n static Request buildRequest(Class cls, Object... args) {\n Retrofit.Builder retrofitBuilder =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com/\")\n .addConverterFactory(new ToStringConverterFactory());\n\n return buildRequest(cls, retrofitBuilder, args);\n }\n\n static Method onlyMethod(Class c) {\n Method[] declaredMethods = c.getDeclaredMethods();\n if (declaredMethods.length == 1) {\n return declaredMethods[0];\n }\n throw new IllegalArgumentException(\"More than one method declared.\");\n }\n\n static String repeat(char c, int times) {\n char[] cs = new char[times];\n Arrays.fill(cs, c);\n return new String(cs);\n }\n}\n" }, { "path": "retrofit/test-helpers/src/main/java/retrofit2/helpers/DelegatingCallAdapterFactory.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.helpers;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport retrofit2.CallAdapter;\nimport retrofit2.Retrofit;\n\npublic final class DelegatingCallAdapterFactory extends CallAdapter.Factory {\n public boolean called;\n\n @Override\n public CallAdapter get(Type returnType, Annotation[] annotations, Retrofit retrofit) {\n called = true;\n return retrofit.nextCallAdapter(this, returnType, annotations);\n }\n}\n" }, { "path": "retrofit/test-helpers/src/main/java/retrofit2/helpers/ExampleWithoutParameterNames.java", "content": "/*\n * Copyright (C) 2024 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.helpers;\n\nimport okhttp3.ResponseBody;\nimport retrofit2.Call;\nimport retrofit2.http.GET;\n\n/** This module is compiled without parameter names embedded in the class file. */\npublic interface ExampleWithoutParameterNames {\n @GET(\"/\")\n Call method(String theFirstParameter);\n}\n" }, { "path": "retrofit/test-helpers/src/main/java/retrofit2/helpers/NonMatchingCallAdapterFactory.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.helpers;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport retrofit2.CallAdapter;\nimport retrofit2.Retrofit;\n\npublic final class NonMatchingCallAdapterFactory extends CallAdapter.Factory {\n public boolean called;\n\n @Override\n public @Nullable CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n called = true;\n return null;\n }\n}\n" }, { "path": "retrofit/test-helpers/src/main/java/retrofit2/helpers/NonMatchingConverterFactory.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.helpers;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\npublic final class NonMatchingConverterFactory extends Converter.Factory {\n public boolean called;\n\n @Override\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n called = true;\n return null;\n }\n\n @Override\n public @Nullable Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n called = true;\n return null;\n }\n\n @Override\n public @Nullable Converter stringConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n called = true;\n return null;\n }\n}\n" }, { "path": "retrofit/test-helpers/src/main/java/retrofit2/helpers/NullObjectConverterFactory.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.helpers;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\n/** Always converts to null. */\npublic final class NullObjectConverterFactory extends Converter.Factory {\n @Override\n public Converter stringConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return new Converter() {\n @Override\n public String convert(Object value) throws IOException {\n return null;\n }\n };\n }\n}\n" }, { "path": "retrofit/test-helpers/src/main/java/retrofit2/helpers/ObjectInstanceConverterFactory.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.helpers;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\npublic final class ObjectInstanceConverterFactory extends Converter.Factory {\n public static final Object VALUE = new Object();\n\n @Override\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n if (type != Object.class) {\n return null;\n }\n return value -> VALUE;\n }\n}\n" }, { "path": "retrofit/test-helpers/src/main/java/retrofit2/helpers/ToStringConverterFactory.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.helpers;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\npublic class ToStringConverterFactory extends Converter.Factory {\n static final MediaType MEDIA_TYPE = MediaType.get(\"text/plain\");\n\n @Override\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n if (String.class.equals(type)) {\n return ResponseBody::string;\n }\n return null;\n }\n\n @Override\n public @Nullable Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n if (String.class.equals(type)) {\n return value -> RequestBody.create(MEDIA_TYPE, value);\n }\n return null;\n }\n}\n" }, { "path": "retrofit-adapters/README.md", "content": "Retrofit Adapters\n=================\n\nRetrofit ships with a default adapter for executing `Call` instances. The child modules contained\nherein are additional adapters for other popular execution mechanisms.\n\nTo use, supply an instance of your desired adapter when building your `Retrofit` instance.\n\n```java\nRetrofit retrofit = new Retrofit.Builder()\n .baseUrl(\"https://api.example.com\")\n .addCallAdapterFactory(RxJavaCallAdapterFactory.create())\n .build();\n```\n" }, { "path": "retrofit-adapters/guava/README.md", "content": "Guava Adapter\n==============\n\nAn `Adapter` for adapting [Guava][1] `ListenableFuture`.\n\n\nUsage\n-----\n\nAdd `GuavaCallAdapterFactory` as a `Call` adapter when building your `Retrofit` instance:\n```java\nRetrofit retrofit = new Retrofit.Builder()\n .baseUrl(\"https://example.com/\")\n .addCallAdapterFactory(GuavaCallAdapterFactory.create())\n .build();\n```\n\nYour service methods can now use `ListenableFuture` as their return type.\n```java\ninterface MyService {\n @GET(\"/user\")\n ListenableFuture getUser();\n}\n```\n\n\nDownload\n--------\n\nDownload [the latest JAR][2] or grab via [Maven][3]:\n```xml\n\n com.squareup.retrofit2\n adapter-guava\n latest.version\n\n```\nor [Gradle][3]:\n```groovy\nimplementation 'com.squareup.retrofit2:adapter-guava:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n\n [1]: https://github.com/google/guava\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=adapter-guava&v=LATEST\n [3]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22adapter-guava%22\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-adapters/guava/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n api libs.guava\n\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.okhttp.mockwebserver\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.adapter.guava'\n }\n}\n" }, { "path": "retrofit-adapters/guava/gradle.properties", "content": "POM_ARTIFACT_ID=adapter-guava\nPOM_NAME=Adapter: Guava\nPOM_DESCRIPTION=A Retrofit CallAdapter for Guava's ListenableFuture.\n" }, { "path": "retrofit-adapters/guava/src/main/java/retrofit2/adapter/guava/GuavaCallAdapterFactory.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.guava;\n\nimport com.google.common.util.concurrent.AbstractFuture;\nimport com.google.common.util.concurrent.ListenableFuture;\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport retrofit2.Call;\nimport retrofit2.CallAdapter;\nimport retrofit2.Callback;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\n\n/**\n * A {@linkplain CallAdapter.Factory call adapter} which creates Guava futures.\n *\n *

Adding this class to {@link Retrofit} allows you to return {@link ListenableFuture} from\n * service methods.\n *\n * 

\n * interface MyService {\n *   @GET(\"user/me\")\n *   ListenableFuture<User> getUser()\n * }\n *
\n *\n * There are two configurations supported for the {@code ListenableFuture} type parameter:\n *\n *
    \n *
  • Direct body (e.g., {@code ListenableFuture}) returns the deserialized body for 2XX\n * responses, sets {@link retrofit2.HttpException HttpException} errors for non-2XX responses,\n * and sets {@link IOException} for network errors.\n *
  • Response wrapped body (e.g., {@code ListenableFuture>}) returns a {@link\n * Response} object for all HTTP responses and sets {@link IOException} for network errors\n *
\n */\npublic final class GuavaCallAdapterFactory extends CallAdapter.Factory {\n public static GuavaCallAdapterFactory create() {\n return new GuavaCallAdapterFactory();\n }\n\n private GuavaCallAdapterFactory() {}\n\n @Override\n public @Nullable CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n if (getRawType(returnType) != ListenableFuture.class) {\n return null;\n }\n if (!(returnType instanceof ParameterizedType)) {\n throw new IllegalStateException(\n \"ListenableFuture return type must be parameterized\"\n + \" as ListenableFuture or ListenableFuture\");\n }\n Type innerType = getParameterUpperBound(0, (ParameterizedType) returnType);\n\n if (getRawType(innerType) != Response.class) {\n // Generic type is not Response. Use it for body-only adapter.\n return new BodyCallAdapter<>(innerType);\n }\n\n // Generic type is Response. Extract T and create the Response version of the adapter.\n if (!(innerType instanceof ParameterizedType)) {\n throw new IllegalStateException(\n \"Response must be parameterized\" + \" as Response or Response\");\n }\n Type responseType = getParameterUpperBound(0, (ParameterizedType) innerType);\n return new ResponseCallAdapter<>(responseType);\n }\n\n private static final class BodyCallAdapter implements CallAdapter> {\n private final Type responseType;\n\n BodyCallAdapter(Type responseType) {\n this.responseType = responseType;\n }\n\n @Override\n public Type responseType() {\n return responseType;\n }\n\n @Override\n public ListenableFuture adapt(final Call call) {\n CallCancelListenableFuture future = new CallCancelListenableFuture<>(call);\n\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n if (response.isSuccessful()) {\n future.set(response.body());\n } else {\n future.setException(new HttpException(response));\n }\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n future.setException(t);\n }\n });\n\n return future;\n }\n }\n\n private static final class ResponseCallAdapter\n implements CallAdapter>> {\n private final Type responseType;\n\n ResponseCallAdapter(Type responseType) {\n this.responseType = responseType;\n }\n\n @Override\n public Type responseType() {\n return responseType;\n }\n\n @Override\n public ListenableFuture> adapt(final Call call) {\n CallCancelListenableFuture> future = new CallCancelListenableFuture<>(call);\n\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n future.set(response);\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n future.setException(t);\n }\n });\n\n return future;\n }\n }\n\n private static final class CallCancelListenableFuture extends AbstractFuture {\n private final Call call;\n\n CallCancelListenableFuture(Call call) {\n this.call = call;\n }\n\n @Override\n public boolean set(T value) {\n return super.set(value);\n }\n\n @Override\n public boolean setException(Throwable throwable) {\n return super.setException(throwable);\n }\n\n @Override\n protected void interruptTask() {\n call.cancel();\n }\n }\n}\n" }, { "path": "retrofit-adapters/guava/src/main/java/retrofit2/adapter/guava/HttpException.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.guava;\n\nimport retrofit2.Response;\n\n/** @deprecated Use {@link retrofit2.HttpException}. */\n@Deprecated\npublic final class HttpException extends retrofit2.HttpException {\n public HttpException(Response response) {\n super(response);\n }\n}\n" }, { "path": "retrofit-adapters/guava/src/main/java/retrofit2/adapter/guava/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.adapter.guava;\n" }, { "path": "retrofit-adapters/guava/src/test/java/retrofit2/adapter/guava/GuavaCallAdapterFactoryTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.guava;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport com.google.common.reflect.TypeToken;\nimport com.google.common.util.concurrent.ListenableFuture;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport java.util.List;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.CallAdapter;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\n\npublic final class GuavaCallAdapterFactoryTest {\n private static final Annotation[] NO_ANNOTATIONS = new Annotation[0];\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private final CallAdapter.Factory factory = GuavaCallAdapterFactory.create();\n private Retrofit retrofit;\n\n @Before\n public void setUp() {\n retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(factory)\n .build();\n }\n\n @Test\n public void responseType() {\n Type bodyClass = new TypeToken>() {}.getType();\n assertThat(factory.get(bodyClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type bodyWildcard = new TypeToken>() {}.getType();\n assertThat(factory.get(bodyWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type bodyGeneric = new TypeToken>>() {}.getType();\n assertThat(factory.get(bodyGeneric, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(new TypeToken>() {}.getType());\n Type responseClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(responseClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type responseWildcard =\n new TypeToken>>() {}.getType();\n assertThat(factory.get(responseWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type resultClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(resultClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type resultWildcard =\n new TypeToken>>() {}.getType();\n assertThat(factory.get(resultWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n }\n\n @Test\n public void nonListenableFutureReturnsNull() {\n CallAdapter adapter = factory.get(String.class, NO_ANNOTATIONS, retrofit);\n assertThat(adapter).isNull();\n }\n\n @Test\n public void rawTypeThrows() {\n Type observableType = new TypeToken() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"ListenableFuture return type must be parameterized as ListenableFuture or ListenableFuture\");\n }\n }\n\n @Test\n public void rawResponseTypeThrows() {\n Type observableType = new TypeToken>() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Response must be parameterized as Response or Response\");\n }\n }\n}\n" }, { "path": "retrofit-adapters/guava/src/test/java/retrofit2/adapter/guava/ListenableFutureTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.guava;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\nimport static org.junit.Assert.fail;\n\nimport com.google.common.util.concurrent.ListenableFuture;\nimport java.io.IOException;\nimport java.util.concurrent.ExecutionException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class ListenableFutureTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\")\n ListenableFuture body();\n\n @GET(\"/\")\n ListenableFuture> response();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(GuavaCallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodySuccess200() throws Exception {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n ListenableFuture future = service.body();\n assertThat(future.get()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void bodySuccess404() throws Exception {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n ListenableFuture future = service.body();\n try {\n future.get();\n fail();\n } catch (ExecutionException e) {\n Throwable cause = e.getCause();\n assertThat(cause).isInstanceOf(HttpException.class); // Required for backwards compatibility.\n assertThat(cause).isInstanceOf(retrofit2.HttpException.class);\n assertThat(cause).hasMessageThat().isEqualTo(\"HTTP 404 Client Error\");\n }\n }\n\n @Test\n public void bodyFailure() throws Exception {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n ListenableFuture future = service.body();\n try {\n future.get();\n fail();\n } catch (ExecutionException e) {\n assertThat(e).hasCauseThat().isInstanceOf(IOException.class);\n }\n }\n\n @Test\n public void responseSuccess200() throws Exception {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n ListenableFuture> future = service.response();\n Response response = future.get();\n assertThat(response.isSuccessful()).isTrue();\n assertThat(response.body()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void responseSuccess404() throws Exception {\n server.enqueue(new MockResponse().setResponseCode(404).setBody(\"Hi\"));\n\n ListenableFuture> future = service.response();\n Response response = future.get();\n assertThat(response.isSuccessful()).isFalse();\n assertThat(response.errorBody().string()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void responseFailure() throws Exception {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n ListenableFuture> future = service.response();\n try {\n future.get();\n fail();\n } catch (ExecutionException e) {\n assertThat(e).hasCauseThat().isInstanceOf(IOException.class);\n }\n }\n}\n" }, { "path": "retrofit-adapters/guava/src/test/java/retrofit2/adapter/guava/StringConverterFactory.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.guava;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\nfinal class StringConverterFactory extends Converter.Factory {\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return ResponseBody::string;\n }\n\n @Override\n public Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n return value -> RequestBody.create(MediaType.get(\"text/plain\"), value);\n }\n}\n" }, { "path": "retrofit-adapters/java8/README.md", "content": "Java 8 Adapter (Deprecated)\n===========================\n\nA call adapter [Java 8's `CompletableFuture`][1].\n\nThis adapter is no longer needed. Support for `CompletableFuture` is built-in to Retrofit and now\nworks without configuration.\n\n\n [1]: http://www.oracle.com/technetwork/java/javase/jdk-8-readme-2095712.html\n" }, { "path": "retrofit-adapters/java8/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.guava\n testImplementation libs.okhttp.mockwebserver\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.adapter.java8'\n }\n}\n" }, { "path": "retrofit-adapters/java8/gradle.properties", "content": "POM_ARTIFACT_ID=adapter-java8\nPOM_NAME=Adapter: Java 8\nPOM_DESCRIPTION=A Retrofit CallAdapter for Java 8's CompletableFuture.\n" }, { "path": "retrofit-adapters/java8/src/main/java/retrofit2/adapter/java8/HttpException.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.java8;\n\nimport retrofit2.Response;\n\n/** @deprecated Use {@link retrofit2.HttpException}. */\n@Deprecated\npublic final class HttpException extends retrofit2.HttpException {\n public HttpException(Response response) {\n super(response);\n }\n}\n" }, { "path": "retrofit-adapters/java8/src/main/java/retrofit2/adapter/java8/Java8CallAdapterFactory.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.java8;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport java.util.concurrent.CompletableFuture;\nimport javax.annotation.Nullable;\nimport retrofit2.Call;\nimport retrofit2.CallAdapter;\nimport retrofit2.Callback;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\n\n/**\n * @deprecated Retrofit includes support for CompletableFuture. This no longer needs to be added to\n * the Retrofit instance explicitly.\n *

A {@linkplain CallAdapter.Factory call adapter} which creates Java 8 futures.\n *

Adding this class to {@link Retrofit} allows you to return {@link CompletableFuture} from\n * service methods.\n * 

\n * interface MyService {\n *   @GET(\"user/me\")\n *   CompletableFuture<User> getUser()\n * }\n *
\n * There are two configurations supported for the {@code CompletableFuture} type parameter:\n *
    \n *
  • Direct body (e.g., {@code CompletableFuture}) returns the deserialized body for\n * 2XX responses, sets {@link retrofit2.HttpException HttpException} errors for non-2XX\n * responses, and sets {@link IOException} for network errors.\n *
  • Response wrapped body (e.g., {@code CompletableFuture>}) returns a\n * {@link Response} object for all HTTP responses and sets {@link IOException} for network\n * errors\n *
\n */\n@Deprecated\npublic final class Java8CallAdapterFactory extends CallAdapter.Factory {\n public static Java8CallAdapterFactory create() {\n return new Java8CallAdapterFactory();\n }\n\n private Java8CallAdapterFactory() {}\n\n @Override\n public @Nullable CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n if (getRawType(returnType) != CompletableFuture.class) {\n return null;\n }\n if (!(returnType instanceof ParameterizedType)) {\n throw new IllegalStateException(\n \"CompletableFuture return type must be parameterized\"\n + \" as CompletableFuture or CompletableFuture\");\n }\n Type innerType = getParameterUpperBound(0, (ParameterizedType) returnType);\n\n if (getRawType(innerType) != Response.class) {\n // Generic type is not Response. Use it for body-only adapter.\n return new BodyCallAdapter<>(innerType);\n }\n\n // Generic type is Response. Extract T and create the Response version of the adapter.\n if (!(innerType instanceof ParameterizedType)) {\n throw new IllegalStateException(\n \"Response must be parameterized\" + \" as Response or Response\");\n }\n Type responseType = getParameterUpperBound(0, (ParameterizedType) innerType);\n return new ResponseCallAdapter<>(responseType);\n }\n\n private static final class BodyCallAdapter implements CallAdapter> {\n private final Type responseType;\n\n BodyCallAdapter(Type responseType) {\n this.responseType = responseType;\n }\n\n @Override\n public Type responseType() {\n return responseType;\n }\n\n @Override\n public CompletableFuture adapt(final Call call) {\n final CompletableFuture future =\n new CompletableFuture() {\n @Override\n public boolean cancel(boolean mayInterruptIfRunning) {\n if (mayInterruptIfRunning) {\n call.cancel();\n }\n return super.cancel(mayInterruptIfRunning);\n }\n };\n\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n if (response.isSuccessful()) {\n future.complete(response.body());\n } else {\n future.completeExceptionally(new HttpException(response));\n }\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n future.completeExceptionally(t);\n }\n });\n\n return future;\n }\n }\n\n private static final class ResponseCallAdapter\n implements CallAdapter>> {\n private final Type responseType;\n\n ResponseCallAdapter(Type responseType) {\n this.responseType = responseType;\n }\n\n @Override\n public Type responseType() {\n return responseType;\n }\n\n @Override\n public CompletableFuture> adapt(final Call call) {\n final CompletableFuture> future =\n new CompletableFuture>() {\n @Override\n public boolean cancel(boolean mayInterruptIfRunning) {\n if (mayInterruptIfRunning) {\n call.cancel();\n }\n return super.cancel(mayInterruptIfRunning);\n }\n };\n\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n future.complete(response);\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n future.completeExceptionally(t);\n }\n });\n\n return future;\n }\n }\n}\n" }, { "path": "retrofit-adapters/java8/src/main/java/retrofit2/adapter/java8/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.adapter.java8;\n" }, { "path": "retrofit-adapters/java8/src/test/java/retrofit2/adapter/java8/CompletableFutureTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.java8;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\nimport static org.junit.Assert.fail;\n\nimport java.io.IOException;\nimport java.util.concurrent.CompletableFuture;\nimport java.util.concurrent.ExecutionException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class CompletableFutureTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\")\n CompletableFuture body();\n\n @GET(\"/\")\n CompletableFuture> response();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(Java8CallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodySuccess200() throws Exception {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n CompletableFuture future = service.body();\n assertThat(future.get()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void bodySuccess404() throws Exception {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n CompletableFuture future = service.body();\n try {\n future.get();\n fail();\n } catch (ExecutionException e) {\n Throwable cause = e.getCause();\n assertThat(cause).isInstanceOf(HttpException.class); // Required for backwards compatibility.\n assertThat(cause).isInstanceOf(retrofit2.HttpException.class);\n assertThat(cause).hasMessageThat().isEqualTo(\"HTTP 404 Client Error\");\n }\n }\n\n @Test\n public void bodyFailure() throws Exception {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n CompletableFuture future = service.body();\n try {\n future.get();\n fail();\n } catch (ExecutionException e) {\n assertThat(e).hasCauseThat().isInstanceOf(IOException.class);\n }\n }\n\n @Test\n public void responseSuccess200() throws Exception {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n CompletableFuture> future = service.response();\n Response response = future.get();\n assertThat(response.isSuccessful()).isTrue();\n assertThat(response.body()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void responseSuccess404() throws Exception {\n server.enqueue(new MockResponse().setResponseCode(404).setBody(\"Hi\"));\n\n CompletableFuture> future = service.response();\n Response response = future.get();\n assertThat(response.isSuccessful()).isFalse();\n assertThat(response.errorBody().string()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void responseFailure() throws Exception {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n CompletableFuture> future = service.response();\n try {\n future.get();\n fail();\n } catch (ExecutionException e) {\n assertThat(e).hasCauseThat().isInstanceOf(IOException.class);\n }\n }\n}\n" }, { "path": "retrofit-adapters/java8/src/test/java/retrofit2/adapter/java8/Java8CallAdapterFactoryTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.java8;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport com.google.common.reflect.TypeToken;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport java.util.List;\nimport java.util.concurrent.CompletableFuture;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.CallAdapter;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\n\npublic final class Java8CallAdapterFactoryTest {\n private static final Annotation[] NO_ANNOTATIONS = new Annotation[0];\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private final CallAdapter.Factory factory = Java8CallAdapterFactory.create();\n private Retrofit retrofit;\n\n @Before\n public void setUp() {\n retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(factory)\n .build();\n }\n\n @Test\n public void responseType() {\n Type bodyClass = new TypeToken>() {}.getType();\n assertThat(factory.get(bodyClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type bodyWildcard = new TypeToken>() {}.getType();\n assertThat(factory.get(bodyWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type bodyGeneric = new TypeToken>>() {}.getType();\n assertThat(factory.get(bodyGeneric, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(new TypeToken>() {}.getType());\n Type responseClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(responseClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type responseWildcard =\n new TypeToken>>() {}.getType();\n assertThat(factory.get(responseWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type resultClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(resultClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type resultWildcard =\n new TypeToken>>() {}.getType();\n assertThat(factory.get(resultWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n }\n\n @Test\n public void nonListenableFutureReturnsNull() {\n CallAdapter adapter = factory.get(String.class, NO_ANNOTATIONS, retrofit);\n assertThat(adapter).isNull();\n }\n\n @Test\n public void rawTypeThrows() {\n Type observableType = new TypeToken() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"CompletableFuture return type must be parameterized as CompletableFuture or CompletableFuture\");\n }\n }\n\n @Test\n public void rawResponseTypeThrows() {\n Type observableType = new TypeToken>() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Response must be parameterized as Response or Response\");\n }\n }\n}\n" }, { "path": "retrofit-adapters/java8/src/test/java/retrofit2/adapter/java8/StringConverterFactory.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.java8;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\nfinal class StringConverterFactory extends Converter.Factory {\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return ResponseBody::string;\n }\n\n @Override\n public Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n return value -> RequestBody.create(MediaType.get(\"text/plain\"), value);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/README.md", "content": "RxJava Adapter\n==============\n\nAn `Adapter` for adapting [RxJava 1.x][1] types.\n\nAvailable types:\n\n * `Observable`, `Observable>`, and `Observable>` where `T` is the body type.\n * `Single`, `Single>`, and `Single>` where `T` is the body type.\n * `Completable` where response bodies are discarded.\n\n\nUsage\n-----\n\nAdd `RxJavaCallAdapterFactory` as a `Call` adapter when building your `Retrofit` instance:\n```java\nRetrofit retrofit = new Retrofit.Builder()\n .baseUrl(\"https://example.com/\")\n .addCallAdapterFactory(RxJavaCallAdapterFactory.create())\n .build();\n```\n\nYour service methods can now use any of the above types as their return type.\n```java\ninterface MyService {\n @GET(\"/user\")\n Observable getUser();\n}\n```\n\nBy default all reactive types execute their requests synchronously. There are multiple ways to\ncontrol the threading on which a request occurs:\n\n * Call `subscribeOn` on the returned reactive type with a `Scheduler` of your choice.\n * Use `createAsync()` when creating the factory which will use OkHttp's internal thread pool.\n * Use `createWithScheduler(Scheduler)` to supply a default subscription `Scheduler`.\n\n\nDownload\n--------\n\nDownload [the latest JAR][2] or grab via [Maven][3]:\n```xml\n\n com.squareup.retrofit2\n adapter-rxjava\n latest.version\n\n```\nor [Gradle][3]:\n```groovy\nimplementation 'com.squareup.retrofit2:adapter-rxjava:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n\n [1]: https://github.com/ReactiveX/RxJava/tree/1.x\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=adapter-rxjava&v=LATEST\n [3]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22adapter-rxjava%22\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-adapters/rxjava/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n api libs.rxjava\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.guava\n testImplementation libs.okhttp.mockwebserver\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.adapter.rxjava'\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/gradle.properties", "content": "POM_ARTIFACT_ID=adapter-rxjava\nPOM_NAME=Adapter: RxJava\nPOM_DESCRIPTION=A Retrofit CallAdapter for RxJava's stream types." }, { "path": "retrofit-adapters/rxjava/src/main/java/retrofit2/adapter/rxjava/BodyOnSubscribe.java", "content": "/*\n * Copyright (C) 2016 Jake Wharton\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport retrofit2.Response;\nimport rx.Observable.OnSubscribe;\nimport rx.Subscriber;\nimport rx.exceptions.CompositeException;\nimport rx.exceptions.Exceptions;\nimport rx.exceptions.OnCompletedFailedException;\nimport rx.exceptions.OnErrorFailedException;\nimport rx.exceptions.OnErrorNotImplementedException;\nimport rx.plugins.RxJavaPlugins;\n\nfinal class BodyOnSubscribe implements OnSubscribe {\n private final OnSubscribe> upstream;\n\n BodyOnSubscribe(OnSubscribe> upstream) {\n this.upstream = upstream;\n }\n\n @Override\n public void call(Subscriber subscriber) {\n upstream.call(new BodySubscriber(subscriber));\n }\n\n private static class BodySubscriber extends Subscriber> {\n private final Subscriber subscriber;\n\n /** Indicates whether a terminal event has been sent to {@link #subscriber}. */\n private boolean subscriberTerminated;\n\n BodySubscriber(Subscriber subscriber) {\n super(subscriber);\n this.subscriber = subscriber;\n }\n\n @Override\n public void onNext(Response response) {\n if (response.isSuccessful()) {\n subscriber.onNext(response.body());\n } else {\n subscriberTerminated = true;\n Throwable t = new HttpException(response);\n try {\n subscriber.onError(t);\n } catch (OnCompletedFailedException\n | OnErrorFailedException\n | OnErrorNotImplementedException e) {\n RxJavaPlugins.getInstance().getErrorHandler().handleError(e);\n } catch (Throwable inner) {\n Exceptions.throwIfFatal(inner);\n CompositeException composite = new CompositeException(t, inner);\n RxJavaPlugins.getInstance().getErrorHandler().handleError(composite);\n }\n }\n }\n\n @Override\n public void onError(Throwable throwable) {\n if (!subscriberTerminated) {\n subscriber.onError(throwable);\n } else {\n // This should never happen! onNext handles and forwards errors automatically.\n Throwable broken =\n new AssertionError(\n \"This should never happen! Report as a Retrofit bug with the full stacktrace.\");\n //noinspection UnnecessaryInitCause Two-arg AssertionError constructor is 1.7+ only.\n broken.initCause(throwable);\n RxJavaPlugins.getInstance().getErrorHandler().handleError(broken);\n }\n }\n\n @Override\n public void onCompleted() {\n if (!subscriberTerminated) {\n subscriber.onCompleted();\n }\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/main/java/retrofit2/adapter/rxjava/CallArbiter.java", "content": "/*\n * Copyright (C) 2016 Jake Wharton\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport java.util.concurrent.atomic.AtomicInteger;\nimport retrofit2.Call;\nimport retrofit2.Response;\nimport rx.Producer;\nimport rx.Subscriber;\nimport rx.Subscription;\nimport rx.exceptions.CompositeException;\nimport rx.exceptions.Exceptions;\nimport rx.exceptions.OnCompletedFailedException;\nimport rx.exceptions.OnErrorFailedException;\nimport rx.exceptions.OnErrorNotImplementedException;\nimport rx.plugins.RxJavaPlugins;\n\nfinal class CallArbiter extends AtomicInteger implements Subscription, Producer {\n private static final int STATE_WAITING = 0;\n private static final int STATE_REQUESTED = 1;\n private static final int STATE_HAS_RESPONSE = 2;\n private static final int STATE_TERMINATED = 3;\n\n private final Call call;\n private final Subscriber> subscriber;\n\n private volatile boolean unsubscribed;\n private volatile Response response;\n\n CallArbiter(Call call, Subscriber> subscriber) {\n super(STATE_WAITING);\n\n this.call = call;\n this.subscriber = subscriber;\n }\n\n @Override\n public void unsubscribe() {\n unsubscribed = true;\n call.cancel();\n }\n\n @Override\n public boolean isUnsubscribed() {\n return unsubscribed;\n }\n\n @Override\n public void request(long amount) {\n if (amount == 0) {\n return;\n }\n while (true) {\n int state = get();\n switch (state) {\n case STATE_WAITING:\n if (compareAndSet(STATE_WAITING, STATE_REQUESTED)) {\n return;\n }\n break; // State transition failed. Try again.\n\n case STATE_HAS_RESPONSE:\n if (compareAndSet(STATE_HAS_RESPONSE, STATE_TERMINATED)) {\n deliverResponse(response);\n return;\n }\n break; // State transition failed. Try again.\n\n case STATE_REQUESTED:\n case STATE_TERMINATED:\n return; // Nothing to do.\n\n default:\n throw new IllegalStateException(\"Unknown state: \" + state);\n }\n }\n }\n\n void emitResponse(Response response) {\n while (true) {\n int state = get();\n switch (state) {\n case STATE_WAITING:\n this.response = response;\n if (compareAndSet(STATE_WAITING, STATE_HAS_RESPONSE)) {\n return;\n }\n break; // State transition failed. Try again.\n\n case STATE_REQUESTED:\n if (compareAndSet(STATE_REQUESTED, STATE_TERMINATED)) {\n deliverResponse(response);\n return;\n }\n break; // State transition failed. Try again.\n\n case STATE_HAS_RESPONSE:\n case STATE_TERMINATED:\n throw new AssertionError();\n\n default:\n throw new IllegalStateException(\"Unknown state: \" + state);\n }\n }\n }\n\n private void deliverResponse(Response response) {\n try {\n if (!isUnsubscribed()) {\n subscriber.onNext(response);\n }\n } catch (OnCompletedFailedException\n | OnErrorFailedException\n | OnErrorNotImplementedException e) {\n RxJavaPlugins.getInstance().getErrorHandler().handleError(e);\n return;\n } catch (Throwable t) {\n Exceptions.throwIfFatal(t);\n try {\n subscriber.onError(t);\n } catch (OnCompletedFailedException\n | OnErrorFailedException\n | OnErrorNotImplementedException e) {\n RxJavaPlugins.getInstance().getErrorHandler().handleError(e);\n } catch (Throwable inner) {\n Exceptions.throwIfFatal(inner);\n CompositeException composite = new CompositeException(t, inner);\n RxJavaPlugins.getInstance().getErrorHandler().handleError(composite);\n }\n return;\n }\n try {\n if (!isUnsubscribed()) {\n subscriber.onCompleted();\n }\n } catch (OnCompletedFailedException\n | OnErrorFailedException\n | OnErrorNotImplementedException e) {\n RxJavaPlugins.getInstance().getErrorHandler().handleError(e);\n } catch (Throwable t) {\n Exceptions.throwIfFatal(t);\n RxJavaPlugins.getInstance().getErrorHandler().handleError(t);\n }\n }\n\n void emitError(Throwable t) {\n set(STATE_TERMINATED);\n\n if (!isUnsubscribed()) {\n try {\n subscriber.onError(t);\n } catch (OnCompletedFailedException\n | OnErrorFailedException\n | OnErrorNotImplementedException e) {\n RxJavaPlugins.getInstance().getErrorHandler().handleError(e);\n } catch (Throwable inner) {\n Exceptions.throwIfFatal(inner);\n CompositeException composite = new CompositeException(t, inner);\n RxJavaPlugins.getInstance().getErrorHandler().handleError(composite);\n }\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/main/java/retrofit2/adapter/rxjava/CallEnqueueOnSubscribe.java", "content": "/*\n * Copyright (C) 2016 Jake Wharton\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport retrofit2.Call;\nimport retrofit2.Callback;\nimport retrofit2.Response;\nimport rx.Observable.OnSubscribe;\nimport rx.Subscriber;\nimport rx.exceptions.Exceptions;\n\nfinal class CallEnqueueOnSubscribe implements OnSubscribe> {\n private final Call originalCall;\n\n CallEnqueueOnSubscribe(Call originalCall) {\n this.originalCall = originalCall;\n }\n\n @Override\n public void call(Subscriber> subscriber) {\n // Since Call is a one-shot type, clone it for each new subscriber.\n Call call = originalCall.clone();\n final CallArbiter arbiter = new CallArbiter<>(call, subscriber);\n subscriber.add(arbiter);\n subscriber.setProducer(arbiter);\n\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n arbiter.emitResponse(response);\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n Exceptions.throwIfFatal(t);\n arbiter.emitError(t);\n }\n });\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/main/java/retrofit2/adapter/rxjava/CallExecuteOnSubscribe.java", "content": "/*\n * Copyright (C) 2016 Jake Wharton\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport retrofit2.Call;\nimport retrofit2.Response;\nimport rx.Observable.OnSubscribe;\nimport rx.Subscriber;\nimport rx.exceptions.Exceptions;\n\nfinal class CallExecuteOnSubscribe implements OnSubscribe> {\n private final Call originalCall;\n\n CallExecuteOnSubscribe(Call originalCall) {\n this.originalCall = originalCall;\n }\n\n @Override\n public void call(Subscriber> subscriber) {\n // Since Call is a one-shot type, clone it for each new subscriber.\n Call call = originalCall.clone();\n CallArbiter arbiter = new CallArbiter<>(call, subscriber);\n subscriber.add(arbiter);\n subscriber.setProducer(arbiter);\n\n Response response;\n try {\n response = call.execute();\n } catch (Throwable t) {\n Exceptions.throwIfFatal(t);\n arbiter.emitError(t);\n return;\n }\n arbiter.emitResponse(response);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/main/java/retrofit2/adapter/rxjava/HttpException.java", "content": "package retrofit2.adapter.rxjava;\n\nimport retrofit2.Response;\n\n/** @deprecated Use {@link retrofit2.HttpException}. */\n@Deprecated\npublic final class HttpException extends retrofit2.HttpException {\n public HttpException(Response response) {\n super(response);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/main/java/retrofit2/adapter/rxjava/Result.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport java.io.IOException;\nimport javax.annotation.Nullable;\nimport retrofit2.Response;\n\n/** The result of executing an HTTP request. */\npublic final class Result {\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static Result error(Throwable error) {\n if (error == null) throw new NullPointerException(\"error == null\");\n return new Result<>(null, error);\n }\n\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static Result response(Response response) {\n if (response == null) throw new NullPointerException(\"response == null\");\n return new Result<>(response, null);\n }\n\n private final @Nullable Response response;\n private final @Nullable Throwable error;\n\n private Result(@Nullable Response response, @Nullable Throwable error) {\n this.response = response;\n this.error = error;\n }\n\n /**\n * The response received from executing an HTTP request. Only present when {@link #isError()} is\n * false, null otherwise.\n */\n public @Nullable Response response() {\n return response;\n }\n\n /**\n * The error experienced while attempting to execute an HTTP request. Only present when {@link\n * #isError()} is true, null otherwise.\n *\n *

If the error is an {@link IOException} then there was a problem with the transport to the\n * remote server. Any other exception type indicates an unexpected failure and should be\n * considered fatal (configuration error, programming error, etc.).\n */\n public @Nullable Throwable error() {\n return error;\n }\n\n /** {@code true} if the request resulted in an error. See {@link #error()} for the cause. */\n public boolean isError() {\n return error != null;\n }\n\n @Override\n public String toString() {\n if (error != null) {\n return \"Result{isError=true, error=\\\"\" + error + \"\\\"}\";\n }\n return \"Result{isError=false, response=\" + response + '}';\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/main/java/retrofit2/adapter/rxjava/ResultOnSubscribe.java", "content": "/*\n * Copyright (C) 2016 Jake Wharton\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport retrofit2.Response;\nimport rx.Observable.OnSubscribe;\nimport rx.Subscriber;\nimport rx.exceptions.CompositeException;\nimport rx.exceptions.Exceptions;\nimport rx.exceptions.OnCompletedFailedException;\nimport rx.exceptions.OnErrorFailedException;\nimport rx.exceptions.OnErrorNotImplementedException;\nimport rx.plugins.RxJavaPlugins;\n\nfinal class ResultOnSubscribe implements OnSubscribe> {\n private final OnSubscribe> upstream;\n\n ResultOnSubscribe(OnSubscribe> upstream) {\n this.upstream = upstream;\n }\n\n @Override\n public void call(Subscriber> subscriber) {\n upstream.call(new ResultSubscriber(subscriber));\n }\n\n private static class ResultSubscriber extends Subscriber> {\n private final Subscriber> subscriber;\n\n ResultSubscriber(Subscriber> subscriber) {\n super(subscriber);\n this.subscriber = subscriber;\n }\n\n @Override\n public void onNext(Response response) {\n subscriber.onNext(Result.response(response));\n }\n\n @Override\n public void onError(Throwable throwable) {\n try {\n subscriber.onNext(Result.error(throwable));\n } catch (Throwable t) {\n try {\n subscriber.onError(t);\n } catch (OnCompletedFailedException\n | OnErrorFailedException\n | OnErrorNotImplementedException e) {\n RxJavaPlugins.getInstance().getErrorHandler().handleError(e);\n } catch (Throwable inner) {\n Exceptions.throwIfFatal(inner);\n CompositeException composite = new CompositeException(t, inner);\n RxJavaPlugins.getInstance().getErrorHandler().handleError(composite);\n }\n return;\n }\n subscriber.onCompleted();\n }\n\n @Override\n public void onCompleted() {\n subscriber.onCompleted();\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/main/java/retrofit2/adapter/rxjava/RxJavaCallAdapter.java", "content": "/*\n * Copyright (C) 2016 Jake Wharton\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport retrofit2.Call;\nimport retrofit2.CallAdapter;\nimport retrofit2.Response;\nimport rx.Observable;\nimport rx.Observable.OnSubscribe;\nimport rx.Scheduler;\n\nfinal class RxJavaCallAdapter implements CallAdapter {\n private final Type responseType;\n private final @Nullable Scheduler scheduler;\n private final boolean isAsync;\n private final boolean isResult;\n private final boolean isBody;\n private final boolean isSingle;\n private final boolean isCompletable;\n\n RxJavaCallAdapter(\n Type responseType,\n @Nullable Scheduler scheduler,\n boolean isAsync,\n boolean isResult,\n boolean isBody,\n boolean isSingle,\n boolean isCompletable) {\n this.responseType = responseType;\n this.scheduler = scheduler;\n this.isAsync = isAsync;\n this.isResult = isResult;\n this.isBody = isBody;\n this.isSingle = isSingle;\n this.isCompletable = isCompletable;\n }\n\n @Override\n public Type responseType() {\n return responseType;\n }\n\n @Override\n public Object adapt(Call call) {\n OnSubscribe> callFunc =\n isAsync ? new CallEnqueueOnSubscribe<>(call) : new CallExecuteOnSubscribe<>(call);\n\n OnSubscribe func;\n if (isResult) {\n func = new ResultOnSubscribe<>(callFunc);\n } else if (isBody) {\n func = new BodyOnSubscribe<>(callFunc);\n } else {\n func = callFunc;\n }\n Observable observable = Observable.create(func);\n\n if (scheduler != null) {\n observable = observable.subscribeOn(scheduler);\n }\n\n if (isSingle) {\n return observable.toSingle();\n }\n if (isCompletable) {\n return observable.toCompletable();\n }\n return observable;\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/main/java/retrofit2/adapter/rxjava/RxJavaCallAdapterFactory.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport retrofit2.CallAdapter;\nimport retrofit2.HttpException;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport rx.Completable;\nimport rx.Observable;\nimport rx.Scheduler;\nimport rx.Single;\n\n/**\n * A {@linkplain CallAdapter.Factory call adapter} which uses RxJava for creating observables.\n *\n *

Adding this class to {@link Retrofit} allows you to return an {@link Observable}, {@link\n * Single}, or {@link Completable} from service methods.\n *\n * 

\n * interface MyService {\n *   @GET(\"user/me\")\n *   Observable<User> getUser()\n * }\n *
\n *\n * There are three configurations supported for the {@code Observable} or {@code Single} type\n * parameter:\n *\n *
    \n *
  • Direct body (e.g., {@code Observable}) calls {@code onNext} with the deserialized\n * body for 2XX responses and calls {@code onError} with {@link HttpException} for non-2XX\n * responses and {@link IOException} for network errors.\n *
  • Response wrapped body (e.g., {@code Observable>}) calls {@code onNext} with\n * a {@link Response} object for all HTTP responses and calls {@code onError} with {@link\n * IOException} for network errors\n *
  • Result wrapped body (e.g., {@code Observable>}) calls {@code onNext} with a\n * {@link Result} object for all HTTP responses and errors.\n *
\n *\n *

Note: Support for {@link Single} and {@link Completable} is experimental and subject\n * to backwards-incompatible changes at any time since both of these types are not considered stable\n * by RxJava.\n */\npublic final class RxJavaCallAdapterFactory extends CallAdapter.Factory {\n /**\n * Returns an instance which creates synchronous observables that do not operate on any scheduler\n * by default.\n */\n public static RxJavaCallAdapterFactory create() {\n return new RxJavaCallAdapterFactory(null, false);\n }\n\n /** Returns an instance which creates asynchronous observables. */\n public static RxJavaCallAdapterFactory createAsync() {\n return new RxJavaCallAdapterFactory(null, true);\n }\n\n /**\n * Returns an instance which creates synchronous observables that {@linkplain\n * Observable#subscribeOn(Scheduler) subscribe on} {@code scheduler} by default.\n */\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static RxJavaCallAdapterFactory createWithScheduler(Scheduler scheduler) {\n if (scheduler == null) throw new NullPointerException(\"scheduler == null\");\n return new RxJavaCallAdapterFactory(scheduler, false);\n }\n\n private final @Nullable Scheduler scheduler;\n private final boolean isAsync;\n\n private RxJavaCallAdapterFactory(@Nullable Scheduler scheduler, boolean isAsync) {\n this.scheduler = scheduler;\n this.isAsync = isAsync;\n }\n\n @Override\n public @Nullable CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n Class rawType = getRawType(returnType);\n boolean isSingle = rawType == Single.class;\n boolean isCompletable = rawType == Completable.class;\n if (rawType != Observable.class && !isSingle && !isCompletable) {\n return null;\n }\n\n if (isCompletable) {\n return new RxJavaCallAdapter(Void.class, scheduler, isAsync, false, true, false, true);\n }\n\n boolean isResult = false;\n boolean isBody = false;\n Type responseType;\n if (!(returnType instanceof ParameterizedType)) {\n String name = isSingle ? \"Single\" : \"Observable\";\n throw new IllegalStateException(\n name\n + \" return type must be parameterized\"\n + \" as \"\n + name\n + \" or \"\n + name\n + \"\");\n }\n\n Type observableType = getParameterUpperBound(0, (ParameterizedType) returnType);\n Class rawObservableType = getRawType(observableType);\n if (rawObservableType == Response.class) {\n if (!(observableType instanceof ParameterizedType)) {\n throw new IllegalStateException(\n \"Response must be parameterized\" + \" as Response or Response\");\n }\n responseType = getParameterUpperBound(0, (ParameterizedType) observableType);\n } else if (rawObservableType == Result.class) {\n if (!(observableType instanceof ParameterizedType)) {\n throw new IllegalStateException(\n \"Result must be parameterized\" + \" as Result or Result\");\n }\n responseType = getParameterUpperBound(0, (ParameterizedType) observableType);\n isResult = true;\n } else {\n responseType = observableType;\n isBody = true;\n }\n\n return new RxJavaCallAdapter(\n responseType, scheduler, isAsync, isResult, isBody, isSingle, false);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/main/java/retrofit2/adapter/rxjava/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.adapter.rxjava;\n" }, { "path": "retrofit-adapters/rxjava/src/main/resources/META-INF/proguard/retrofit2-rxjava-adapter.pro", "content": "# Keep generic signature of RxJava (R8 full mode strips signatures from non-kept items).\n# It's necessary to add the explicit rule for Result as it could be used as a nested return type like `Observable>`\n-keep,allowoptimization,allowshrinking,allowobfuscation class retrofit2.adapter.rxjava.Result\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/AsyncTest.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static java.util.concurrent.TimeUnit.SECONDS;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\nimport static org.junit.Assert.assertFalse;\nimport static org.junit.Assert.assertTrue;\n\nimport java.io.IOException;\nimport java.util.concurrent.CountDownLatch;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport rx.Completable;\nimport rx.exceptions.CompositeException;\nimport rx.exceptions.Exceptions;\nimport rx.exceptions.OnErrorFailedException;\nimport rx.observers.AsyncCompletableSubscriber;\nimport rx.observers.TestSubscriber;\nimport rx.plugins.RxJavaErrorHandler;\nimport rx.plugins.RxJavaPlugins;\n\npublic final class AsyncTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule pluginsReset = new RxJavaPluginsResetRule();\n\n interface Service {\n @GET(\"/\")\n Completable completable();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addCallAdapterFactory(RxJavaCallAdapterFactory.createAsync())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void success() throws InterruptedException {\n TestSubscriber subscriber = new TestSubscriber<>();\n service.completable().subscribe(subscriber);\n assertFalse(subscriber.awaitValueCount(1, 1, SECONDS));\n\n server.enqueue(new MockResponse());\n subscriber.awaitTerminalEvent(1, SECONDS);\n subscriber.assertCompleted();\n }\n\n @Test\n public void failure() throws InterruptedException {\n TestSubscriber subscriber = new TestSubscriber<>();\n service.completable().subscribe(subscriber);\n assertFalse(subscriber.awaitValueCount(1, 1, SECONDS));\n\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n subscriber.awaitTerminalEvent(1, SECONDS);\n subscriber.assertError(IOException.class);\n }\n\n @Test\n public void throwingInOnCompleteDeliveredToPlugin() throws InterruptedException {\n server.enqueue(new MockResponse());\n\n final CountDownLatch latch = new CountDownLatch(1);\n final AtomicReference errorRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n latch.countDown();\n }\n });\n\n final TestSubscriber subscriber = new TestSubscriber<>();\n final RuntimeException e = new RuntimeException();\n service\n .completable()\n .unsafeSubscribe(\n new AsyncCompletableSubscriber() {\n @Override\n public void onCompleted() {\n throw e;\n }\n\n @Override\n public void onError(Throwable t) {\n subscriber.onError(t);\n }\n });\n\n latch.await(1, SECONDS);\n assertThat(errorRef.get()).isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() throws InterruptedException {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final CountDownLatch latch = new CountDownLatch(1);\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n latch.countDown();\n }\n });\n\n final TestSubscriber subscriber = new TestSubscriber<>();\n final RuntimeException e = new RuntimeException();\n final AtomicReference errorRef = new AtomicReference<>();\n service\n .completable()\n .unsafeSubscribe(\n new AsyncCompletableSubscriber() {\n @Override\n public void onCompleted() {\n subscriber.onCompleted();\n }\n\n @Override\n public void onError(Throwable t) {\n errorRef.set(t);\n throw e;\n }\n });\n\n assertTrue(latch.await(1, SECONDS));\n CompositeException composite = (CompositeException) pluginRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void bodyThrowingInOnSafeSubscriberErrorDeliveredToPlugin() throws InterruptedException {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final CountDownLatch latch = new CountDownLatch(1);\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (throwable instanceof OnErrorFailedException) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n latch.countDown();\n }\n }\n });\n\n final TestSubscriber subscriber = new TestSubscriber<>();\n final RuntimeException e = new RuntimeException();\n final AtomicReference errorRef = new AtomicReference<>();\n service\n .completable()\n .subscribe(\n new AsyncCompletableSubscriber() {\n @Override\n public void onCompleted() {\n subscriber.onCompleted();\n }\n\n @Override\n public void onError(Throwable t) {\n errorRef.set(t);\n throw e;\n }\n });\n\n assertTrue(latch.await(1, SECONDS));\n OnErrorFailedException failed = (OnErrorFailedException) pluginRef.get();\n CompositeException composite = (CompositeException) failed.getCause();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/CancelDisposeTest.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport static org.junit.Assert.assertEquals;\nimport static org.junit.Assert.assertFalse;\nimport static org.junit.Assert.assertTrue;\n\nimport java.util.List;\nimport okhttp3.Call;\nimport okhttp3.OkHttpClient;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport rx.Observable;\nimport rx.Subscription;\n\npublic final class CancelDisposeTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\")\n Observable go();\n }\n\n private final OkHttpClient client = new OkHttpClient();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJavaCallAdapterFactory.createAsync())\n .callFactory(client)\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void disposeCancelsCall() {\n Subscription subscription = service.go().subscribe();\n List calls = client.dispatcher().runningCalls();\n assertEquals(1, calls.size());\n subscription.unsubscribe();\n assertTrue(calls.get(0).isCanceled());\n }\n\n @Test\n public void cancelDoesNotDispose() {\n Subscription subscription = service.go().subscribe();\n List calls = client.dispatcher().runningCalls();\n assertEquals(1, calls.size());\n calls.get(0).cancel();\n assertFalse(subscription.isUnsubscribed());\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/CompletableTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport rx.Completable;\n\npublic final class CompletableTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule pluginsReset = new RxJavaPluginsResetRule();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Completable completable();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addCallAdapterFactory(RxJavaCallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void completableSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.completable().unsafeSubscribe(subscriber);\n subscriber.assertCompleted();\n }\n\n @Test\n public void completableSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.completable().unsafeSubscribe(subscriber);\n // Required for backwards compatibility.\n subscriber.assertError(HttpException.class, \"HTTP 404 Client Error\");\n }\n\n @Test\n public void completableFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.completable().unsafeSubscribe(subscriber);\n subscriber.assertError(IOException.class);\n }\n\n @Test\n public void subscribeTwice() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n server.enqueue(new MockResponse().setBody(\"Hey\"));\n\n Completable observable = service.completable();\n\n RecordingSubscriber subscriber1 = subscriberRule.create();\n observable.subscribe(subscriber1);\n subscriber1.assertCompleted();\n\n RecordingSubscriber subscriber2 = subscriberRule.create();\n observable.subscribe(subscriber2);\n subscriber2.assertCompleted();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/CompletableThrowingSafeSubscriberTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport static com.google.common.truth.Truth.assertThat;\n\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport rx.Completable;\nimport rx.CompletableSubscriber;\nimport rx.Subscription;\nimport rx.exceptions.CompositeException;\nimport rx.exceptions.Exceptions;\nimport rx.exceptions.OnCompletedFailedException;\nimport rx.exceptions.OnErrorFailedException;\nimport rx.plugins.RxJavaErrorHandler;\nimport rx.plugins.RxJavaPlugins;\n\npublic final class CompletableThrowingSafeSubscriberTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule resetRule = new RxJavaPluginsResetRule();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Completable completable();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addCallAdapterFactory(RxJavaCallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void throwingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (throwable instanceof OnCompletedFailedException) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n }\n });\n\n RecordingSubscriber observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .completable()\n .subscribe(\n new ForwardingCompletableObserver(observer) {\n @Override\n public void onCompleted() {\n throw e;\n }\n });\n\n assertThat(pluginRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (throwable instanceof OnErrorFailedException) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n }\n });\n\n RecordingSubscriber observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n final AtomicReference errorRef = new AtomicReference<>();\n service\n .completable()\n .subscribe(\n new ForwardingCompletableObserver(observer) {\n @Override\n public void onError(Throwable throwable) {\n errorRef.set(throwable);\n throw e;\n }\n });\n\n CompositeException composite = (CompositeException) pluginRef.get().getCause();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n abstract static class ForwardingCompletableObserver implements CompletableSubscriber {\n private final RecordingSubscriber delegate;\n\n ForwardingCompletableObserver(RecordingSubscriber delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public void onSubscribe(Subscription d) {}\n\n @Override\n public void onCompleted() {\n delegate.onCompleted();\n }\n\n @Override\n public void onError(Throwable throwable) {\n delegate.onError(throwable);\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/CompletableThrowingTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport static com.google.common.truth.Truth.assertThat;\n\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport rx.Completable;\nimport rx.CompletableSubscriber;\nimport rx.Subscription;\nimport rx.exceptions.CompositeException;\nimport rx.exceptions.Exceptions;\nimport rx.plugins.RxJavaErrorHandler;\nimport rx.plugins.RxJavaPlugins;\n\npublic final class CompletableThrowingTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule resetRule = new RxJavaPluginsResetRule();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Completable completable();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addCallAdapterFactory(RxJavaCallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void throwingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n });\n\n RecordingSubscriber observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .completable()\n .unsafeSubscribe(\n new ForwardingCompletableObserver(observer) {\n @Override\n public void onCompleted() {\n throw e;\n }\n });\n\n assertThat(pluginRef.get()).isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n });\n\n RecordingSubscriber observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n final AtomicReference errorRef = new AtomicReference<>();\n service\n .completable()\n .unsafeSubscribe(\n new ForwardingCompletableObserver(observer) {\n @Override\n public void onError(Throwable throwable) {\n errorRef.set(throwable);\n throw e;\n }\n });\n\n CompositeException composite = (CompositeException) pluginRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n abstract static class ForwardingCompletableObserver implements CompletableSubscriber {\n private final RecordingSubscriber delegate;\n\n ForwardingCompletableObserver(RecordingSubscriber delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public void onSubscribe(Subscription d) {}\n\n @Override\n public void onCompleted() {\n delegate.onCompleted();\n }\n\n @Override\n public void onError(Throwable throwable) {\n delegate.onError(throwable);\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/CompletableWithSchedulerTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport rx.Completable;\nimport rx.schedulers.TestScheduler;\n\npublic final class CompletableWithSchedulerTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Completable completable();\n }\n\n private final TestScheduler scheduler = new TestScheduler();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addCallAdapterFactory(RxJavaCallAdapterFactory.createWithScheduler(scheduler))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void completableUsesScheduler() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.completable().unsafeSubscribe(subscriber);\n subscriber.assertNoEvents();\n\n scheduler.triggerActions();\n subscriber.assertCompleted();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/ForwardingSubscriber.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport rx.Subscriber;\n\nabstract class ForwardingSubscriber extends Subscriber {\n private final Subscriber delegate;\n\n ForwardingSubscriber(Subscriber delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public void onNext(T value) {\n delegate.onNext(value);\n }\n\n @Override\n public void onCompleted() {\n delegate.onCompleted();\n }\n\n @Override\n public void onError(Throwable throwable) {\n delegate.onError(throwable);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/ObservableTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport rx.Observable;\n\npublic final class ObservableTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule pluginsReset = new RxJavaPluginsResetRule();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Observable body();\n\n @GET(\"/\")\n Observable> response();\n\n @GET(\"/\")\n Observable> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJavaCallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodySuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().unsafeSubscribe(subscriber);\n subscriber.assertValue(\"Hi\").assertCompleted();\n }\n\n @Test\n public void bodySuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().unsafeSubscribe(subscriber);\n // Required for backwards compatibility.\n subscriber.assertError(HttpException.class, \"HTTP 404 Client Error\");\n }\n\n @Test\n public void bodyFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().unsafeSubscribe(subscriber);\n subscriber.assertError(IOException.class);\n }\n\n @Test\n public void bodyRespectsBackpressure() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber subscriber = subscriberRule.createWithInitialRequest(0);\n service.body().unsafeSubscribe(subscriber);\n assertThat(server.getRequestCount()).isEqualTo(1);\n subscriber.assertNoEvents();\n\n subscriber.requestMore(1);\n subscriber.assertAnyValue().assertCompleted();\n\n subscriber.requestMore(Long.MAX_VALUE); // Subsequent requests do not trigger HTTP requests.\n assertThat(server.getRequestCount()).isEqualTo(1);\n }\n\n @Test\n public void responseSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.response().unsafeSubscribe(subscriber);\n assertThat(subscriber.takeValue().body()).isEqualTo(\"Hi\");\n subscriber.assertCompleted();\n }\n\n @Test\n public void responseSuccess404() throws IOException {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.response().unsafeSubscribe(subscriber);\n assertThat(subscriber.takeValue().code()).isEqualTo(404);\n subscriber.assertCompleted();\n }\n\n @Test\n public void responseFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.response().unsafeSubscribe(subscriber);\n subscriber.assertError(IOException.class);\n }\n\n @Test\n public void responseRespectsBackpressure() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber> subscriber = subscriberRule.createWithInitialRequest(0);\n service.response().unsafeSubscribe(subscriber);\n assertThat(server.getRequestCount()).isEqualTo(1);\n subscriber.assertNoEvents();\n\n subscriber.requestMore(1);\n subscriber.assertAnyValue().assertCompleted();\n\n subscriber.requestMore(Long.MAX_VALUE); // Subsequent requests do not trigger HTTP requests.\n assertThat(server.getRequestCount()).isEqualTo(1);\n }\n\n @Test\n public void responseUnsubscribedDoesNotCallCompleted() throws InterruptedException {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n final RecordingSubscriber> subscriber = subscriberRule.create();\n service.response().doOnNext(response -> subscriber.unsubscribe()).subscribe(subscriber);\n\n assertThat(subscriber.takeValue().body()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void resultSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.result().unsafeSubscribe(subscriber);\n assertThat(subscriber.takeValue().response().body()).isEqualTo(\"Hi\");\n subscriber.assertCompleted();\n }\n\n @Test\n public void resultSuccess404() throws IOException {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.result().unsafeSubscribe(subscriber);\n assertThat(subscriber.takeValue().response().code()).isEqualTo(404);\n subscriber.assertCompleted();\n }\n\n @Test\n public void resultFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.result().unsafeSubscribe(subscriber);\n assertThat(subscriber.takeValue().error()).isInstanceOf(IOException.class);\n subscriber.assertCompleted();\n }\n\n @Test\n public void resultRespectsBackpressure() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber> subscriber = subscriberRule.createWithInitialRequest(0);\n service.result().unsafeSubscribe(subscriber);\n assertThat(server.getRequestCount()).isEqualTo(1);\n subscriber.assertNoEvents();\n\n subscriber.requestMore(1);\n subscriber.assertAnyValue().assertCompleted();\n\n subscriber.requestMore(Long.MAX_VALUE); // Subsequent requests do not trigger HTTP requests.\n assertThat(server.getRequestCount()).isEqualTo(1);\n }\n\n @Test\n public void subscribeTwice() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n server.enqueue(new MockResponse().setBody(\"Hey\"));\n\n Observable observable = service.body();\n\n RecordingSubscriber subscriber1 = subscriberRule.create();\n observable.subscribe(subscriber1);\n subscriber1.assertValue(\"Hi\").assertCompleted();\n\n RecordingSubscriber subscriber2 = subscriberRule.create();\n observable.subscribe(subscriber2);\n subscriber2.assertValue(\"Hey\").assertCompleted();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/ObservableThrowingSafeSubscriberTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport rx.Observable;\nimport rx.exceptions.CompositeException;\nimport rx.exceptions.Exceptions;\nimport rx.exceptions.OnCompletedFailedException;\nimport rx.exceptions.OnErrorFailedException;\nimport rx.plugins.RxJavaErrorHandler;\nimport rx.plugins.RxJavaPlugins;\n\npublic final class ObservableThrowingSafeSubscriberTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule resetRule = new RxJavaPluginsResetRule();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Observable body();\n\n @GET(\"/\")\n Observable> response();\n\n @GET(\"/\")\n Observable> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJavaCallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingSubscriber(observer) {\n @Override\n public void onNext(String value) {\n throw e;\n }\n });\n\n observer.assertError(e);\n }\n\n @Test\n public void bodyThrowingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (throwable instanceof OnCompletedFailedException) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n }\n });\n\n RecordingSubscriber observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingSubscriber(observer) {\n @Override\n public void onCompleted() {\n throw e;\n }\n });\n\n observer.assertAnyValue();\n assertThat(pluginRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (throwable instanceof OnErrorFailedException) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n }\n });\n\n RecordingSubscriber observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingSubscriber(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n CompositeException composite = (CompositeException) pluginRef.get().getCause();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void responseThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingSubscriber>(observer) {\n @Override\n public void onNext(Response value) {\n throw e;\n }\n });\n\n observer.assertError(e);\n }\n\n @Test\n public void responseThrowingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (throwable instanceof OnCompletedFailedException) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n }\n });\n\n RecordingSubscriber> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingSubscriber>(observer) {\n @Override\n public void onCompleted() {\n throw e;\n }\n });\n\n observer.assertAnyValue();\n assertThat(pluginRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void responseThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (throwable instanceof OnErrorFailedException) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n }\n });\n\n RecordingSubscriber> observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingSubscriber>(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n CompositeException composite = (CompositeException) pluginRef.get().getCause();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void resultThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingSubscriber>(observer) {\n @Override\n public void onNext(Result value) {\n throw e;\n }\n });\n\n observer.assertError(e);\n }\n\n @Test\n public void resultThrowingInOnCompletedDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (throwable instanceof OnCompletedFailedException) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n }\n });\n\n RecordingSubscriber> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingSubscriber>(observer) {\n @Override\n public void onCompleted() {\n throw e;\n }\n });\n\n observer.assertAnyValue();\n assertThat(pluginRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void resultThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (throwable instanceof OnErrorFailedException) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n }\n });\n\n RecordingSubscriber> observer = subscriberRule.create();\n final RuntimeException first = new RuntimeException();\n final RuntimeException second = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingSubscriber>(observer) {\n @Override\n public void onNext(Result value) {\n // The only way to trigger onError for a result is if onNext throws.\n throw first;\n }\n\n @Override\n public void onError(Throwable throwable) {\n throw second;\n }\n });\n\n CompositeException composite = (CompositeException) pluginRef.get().getCause();\n assertThat(composite.getExceptions()).containsExactly(first, second);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/ObservableThrowingTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport rx.Observable;\nimport rx.exceptions.CompositeException;\nimport rx.exceptions.Exceptions;\nimport rx.plugins.RxJavaErrorHandler;\nimport rx.plugins.RxJavaPlugins;\n\npublic final class ObservableThrowingTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule resetRule = new RxJavaPluginsResetRule();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Observable body();\n\n @GET(\"/\")\n Observable> response();\n\n @GET(\"/\")\n Observable> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJavaCallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .unsafeSubscribe(\n new ForwardingSubscriber(observer) {\n @Override\n public void onNext(String value) {\n throw e;\n }\n });\n\n observer.assertError(e);\n }\n\n @Test\n public void bodyThrowingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n });\n\n RecordingSubscriber observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .unsafeSubscribe(\n new ForwardingSubscriber(observer) {\n @Override\n public void onCompleted() {\n throw e;\n }\n });\n\n observer.assertAnyValue();\n assertThat(pluginRef.get()).isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n });\n\n RecordingSubscriber observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .unsafeSubscribe(\n new ForwardingSubscriber(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n CompositeException composite = (CompositeException) pluginRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void responseThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .unsafeSubscribe(\n new ForwardingSubscriber>(observer) {\n @Override\n public void onNext(Response value) {\n throw e;\n }\n });\n\n observer.assertError(e);\n }\n\n @Test\n public void responseThrowingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n });\n\n RecordingSubscriber> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .unsafeSubscribe(\n new ForwardingSubscriber>(observer) {\n @Override\n public void onCompleted() {\n throw e;\n }\n });\n\n observer.assertAnyValue();\n assertThat(pluginRef.get()).isSameInstanceAs(e);\n }\n\n @Test\n public void responseThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n });\n\n RecordingSubscriber> observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .unsafeSubscribe(\n new ForwardingSubscriber>(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n CompositeException composite = (CompositeException) pluginRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void resultThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .unsafeSubscribe(\n new ForwardingSubscriber>(observer) {\n @Override\n public void onNext(Result value) {\n throw e;\n }\n });\n\n observer.assertError(e);\n }\n\n @Test\n public void resultThrowingInOnCompletedDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n });\n\n RecordingSubscriber> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .unsafeSubscribe(\n new ForwardingSubscriber>(observer) {\n @Override\n public void onCompleted() {\n throw e;\n }\n });\n\n observer.assertAnyValue();\n assertThat(pluginRef.get()).isSameInstanceAs(e);\n }\n\n @Test\n public void resultThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n });\n\n RecordingSubscriber> observer = subscriberRule.create();\n final RuntimeException first = new RuntimeException();\n final RuntimeException second = new RuntimeException();\n service\n .result()\n .unsafeSubscribe(\n new ForwardingSubscriber>(observer) {\n @Override\n public void onNext(Result value) {\n // The only way to trigger onError for a result is if onNext throws.\n throw first;\n }\n\n @Override\n public void onError(Throwable throwable) {\n throw second;\n }\n });\n\n CompositeException composite = (CompositeException) pluginRef.get();\n assertThat(composite.getExceptions()).containsExactly(first, second);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/ObservableWithSchedulerTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport rx.Observable;\nimport rx.schedulers.TestScheduler;\n\npublic final class ObservableWithSchedulerTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Observable body();\n\n @GET(\"/\")\n Observable> response();\n\n @GET(\"/\")\n Observable> result();\n }\n\n private final TestScheduler scheduler = new TestScheduler();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJavaCallAdapterFactory.createWithScheduler(scheduler))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyUsesScheduler() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().unsafeSubscribe(subscriber);\n subscriber.assertNoEvents();\n\n scheduler.triggerActions();\n subscriber.assertAnyValue().assertCompleted();\n }\n\n @Test\n public void responseUsesScheduler() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.response().unsafeSubscribe(subscriber);\n subscriber.assertNoEvents();\n\n scheduler.triggerActions();\n subscriber.assertAnyValue().assertCompleted();\n }\n\n @Test\n public void resultUsesScheduler() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.result().unsafeSubscribe(subscriber);\n subscriber.assertNoEvents();\n\n scheduler.triggerActions();\n subscriber.assertAnyValue().assertCompleted();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/RecordingSubscriber.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static com.google.common.truth.Truth.assertWithMessage;\n\nimport java.util.ArrayDeque;\nimport java.util.ArrayList;\nimport java.util.Deque;\nimport java.util.List;\nimport org.junit.rules.TestRule;\nimport org.junit.runner.Description;\nimport org.junit.runners.model.Statement;\nimport rx.Notification;\nimport rx.Subscriber;\n\n/** A test {@link Subscriber} and JUnit rule which guarantees all events are asserted. */\nfinal class RecordingSubscriber extends Subscriber {\n private final long initialRequest;\n private final Deque> events = new ArrayDeque<>();\n\n private RecordingSubscriber(long initialRequest) {\n this.initialRequest = initialRequest;\n }\n\n @Override\n public void onStart() {\n request(initialRequest);\n }\n\n @Override\n public void onNext(T value) {\n events.add(Notification.createOnNext(value));\n }\n\n @Override\n public void onCompleted() {\n events.add(Notification.createOnCompleted());\n }\n\n @Override\n public void onError(Throwable e) {\n events.add(Notification.createOnError(e));\n }\n\n private Notification takeNotification() {\n Notification notification = events.pollFirst();\n if (notification == null) {\n throw new AssertionError(\"No event found!\");\n }\n return notification;\n }\n\n public T takeValue() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onNext event but was %s\", notification)\n .that(notification.isOnNext())\n .isTrue();\n return notification.getValue();\n }\n\n public Throwable takeError() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onError event but was %s\", notification)\n .that(notification.isOnError())\n .isTrue();\n return notification.getThrowable();\n }\n\n public RecordingSubscriber assertAnyValue() {\n takeValue();\n return this;\n }\n\n public RecordingSubscriber assertValue(T value) {\n assertThat(takeValue()).isEqualTo(value);\n return this;\n }\n\n public void assertCompleted() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onCompleted event but was %s\", notification)\n .that(notification.isOnCompleted())\n .isTrue();\n assertNoEvents();\n }\n\n public void assertError(Throwable throwable) {\n assertThat(takeError()).isEqualTo(throwable);\n }\n\n public void assertError(Class errorClass) {\n assertError(errorClass, null);\n }\n\n public void assertError(Class errorClass, String message) {\n Throwable throwable = takeError();\n assertThat(throwable).isInstanceOf(errorClass);\n if (message != null) {\n assertThat(throwable).hasMessageThat().isEqualTo(message);\n }\n assertNoEvents();\n }\n\n public void assertNoEvents() {\n assertWithMessage(\"Unconsumed events found!\").that(events).isEmpty();\n }\n\n public void requestMore(long amount) {\n request(amount);\n }\n\n public static final class Rule implements TestRule {\n final List> subscribers = new ArrayList<>();\n\n public RecordingSubscriber create() {\n return createWithInitialRequest(Long.MAX_VALUE);\n }\n\n public RecordingSubscriber createWithInitialRequest(long initialRequest) {\n RecordingSubscriber subscriber = new RecordingSubscriber<>(initialRequest);\n subscribers.add(subscriber);\n return subscriber;\n }\n\n @Override\n public Statement apply(final Statement base, Description description) {\n return new Statement() {\n @Override\n public void evaluate() throws Throwable {\n base.evaluate();\n for (RecordingSubscriber subscriber : subscribers) {\n subscriber.assertNoEvents();\n }\n }\n };\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/ResultTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport java.io.IOException;\nimport org.junit.Test;\nimport retrofit2.Response;\n\npublic final class ResultTest {\n @Test\n public void response() {\n Response response = Response.success(\"Hi\");\n Result result = Result.response(response);\n assertThat(result.isError()).isFalse();\n assertThat(result.error()).isNull();\n assertThat(result.response()).isSameInstanceAs(response);\n }\n\n @Test\n public void nullResponseThrows() {\n try {\n Result.response(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"response == null\");\n }\n }\n\n @Test\n public void error() {\n Throwable error = new IOException();\n Result result = Result.error(error);\n assertThat(result.isError()).isTrue();\n assertThat(result.error()).isSameInstanceAs(error);\n assertThat(result.response()).isNull();\n }\n\n @Test\n public void nullErrorThrows() {\n try {\n Result.error(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"error == null\");\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/RxJavaCallAdapterFactoryTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport com.google.common.reflect.TypeToken;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport java.util.List;\nimport org.junit.Before;\nimport org.junit.Test;\nimport retrofit2.CallAdapter;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport rx.Observable;\nimport rx.Single;\n\npublic final class RxJavaCallAdapterFactoryTest {\n private static final Annotation[] NO_ANNOTATIONS = new Annotation[0];\n\n private final CallAdapter.Factory factory = RxJavaCallAdapterFactory.create();\n private Retrofit retrofit;\n\n @Before\n public void setUp() {\n retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://localhost:1\")\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(factory)\n .build();\n }\n\n @Test\n public void nullSchedulerThrows() {\n try {\n RxJavaCallAdapterFactory.createWithScheduler(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"scheduler == null\");\n }\n }\n\n @Test\n public void nonRxJavaTypeReturnsNull() {\n CallAdapter adapter = factory.get(String.class, NO_ANNOTATIONS, retrofit);\n assertThat(adapter).isNull();\n }\n\n @Test\n public void responseTypes() {\n Type oBodyClass = new TypeToken>() {}.getType();\n assertThat(factory.get(oBodyClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sBodyClass = new TypeToken>() {}.getType();\n assertThat(factory.get(sBodyClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n\n Type oBodyWildcard = new TypeToken>() {}.getType();\n assertThat(factory.get(oBodyWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sBodyWildcard = new TypeToken>() {}.getType();\n assertThat(factory.get(sBodyWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n\n Type oBodyGeneric = new TypeToken>>() {}.getType();\n assertThat(factory.get(oBodyGeneric, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(new TypeToken>() {}.getType());\n Type sBodyGeneric = new TypeToken>>() {}.getType();\n assertThat(factory.get(sBodyGeneric, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(new TypeToken>() {}.getType());\n\n Type oResponseClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(oResponseClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sResponseClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(sResponseClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n\n Type oResponseWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(oResponseWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sResponseWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(sResponseWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n\n Type oResultClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(oResultClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sResultClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(sResultClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n\n Type oResultWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(oResultWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sResultWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(sResultWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n }\n\n @Test\n public void rawBodyTypeThrows() {\n Type observableType = new TypeToken() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Observable return type must be parameterized as Observable or Observable\");\n }\n\n Type singleType = new TypeToken() {}.getType();\n try {\n factory.get(singleType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Single return type must be parameterized as Single or Single\");\n }\n }\n\n @Test\n public void rawResponseTypeThrows() {\n Type observableType = new TypeToken>() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Response must be parameterized as Response or Response\");\n }\n\n Type singleType = new TypeToken>() {}.getType();\n try {\n factory.get(singleType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Response must be parameterized as Response or Response\");\n }\n }\n\n @Test\n public void rawResultTypeThrows() {\n Type observableType = new TypeToken>() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Result must be parameterized as Result or Result\");\n }\n\n Type singleType = new TypeToken>() {}.getType();\n try {\n factory.get(singleType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Result must be parameterized as Result or Result\");\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/RxJavaPluginsResetRule.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport org.junit.rules.TestRule;\nimport org.junit.runner.Description;\nimport org.junit.runners.model.Statement;\nimport rx.plugins.RxJavaPlugins;\n\n/** A JUnit @Rule which resets RxJava's plugins before and after each test. */\nfinal class RxJavaPluginsResetRule implements TestRule {\n @Override\n public Statement apply(final Statement base, Description description) {\n return new Statement() {\n @Override\n public void evaluate() throws Throwable {\n RxJavaPlugins.getInstance().reset();\n try {\n base.evaluate();\n } finally {\n RxJavaPlugins.getInstance().reset();\n }\n }\n };\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/SingleTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport rx.Single;\n\npublic final class SingleTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule pluginsReset = new RxJavaPluginsResetRule();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Single body();\n\n @GET(\"/\")\n Single> response();\n\n @GET(\"/\")\n Single> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJavaCallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodySuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().unsafeSubscribe(subscriber);\n subscriber.assertValue(\"Hi\").assertCompleted();\n }\n\n @Test\n public void bodySuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().unsafeSubscribe(subscriber);\n // Required for backwards compatibility.\n subscriber.assertError(HttpException.class, \"HTTP 404 Client Error\");\n }\n\n @Test\n public void bodyFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().unsafeSubscribe(subscriber);\n subscriber.assertError(IOException.class);\n }\n\n @Test\n public void bodyThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .unsafeSubscribe(\n new ForwardingSubscriber(subscriber) {\n @Override\n public void onNext(String value) {\n throw e;\n }\n });\n\n subscriber.assertError(e);\n }\n\n @Test\n public void responseSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.response().unsafeSubscribe(subscriber);\n assertThat(subscriber.takeValue().body()).isEqualTo(\"Hi\");\n subscriber.assertCompleted();\n }\n\n @Test\n public void responseSuccess404() throws IOException {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.response().unsafeSubscribe(subscriber);\n assertThat(subscriber.takeValue().code()).isEqualTo(404);\n subscriber.assertCompleted();\n }\n\n @Test\n public void responseFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.response().unsafeSubscribe(subscriber);\n subscriber.assertError(IOException.class);\n }\n\n @Test\n public void responseThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .unsafeSubscribe(\n new ForwardingSubscriber>(subscriber) {\n @Override\n public void onNext(Response value) {\n throw e;\n }\n });\n\n subscriber.assertError(e);\n }\n\n @Test\n public void resultSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.result().unsafeSubscribe(subscriber);\n assertThat(subscriber.takeValue().response().body()).isEqualTo(\"Hi\");\n subscriber.assertCompleted();\n }\n\n @Test\n public void resultSuccess404() throws IOException {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.result().unsafeSubscribe(subscriber);\n assertThat(subscriber.takeValue().response().code()).isEqualTo(404);\n subscriber.assertCompleted();\n }\n\n @Test\n public void resultFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.result().unsafeSubscribe(subscriber);\n assertThat(subscriber.takeValue().error()).isInstanceOf(IOException.class);\n subscriber.assertCompleted();\n }\n\n @Test\n public void resultThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .unsafeSubscribe(\n new ForwardingSubscriber>(subscriber) {\n @Override\n public void onNext(Result value) {\n throw e;\n }\n });\n\n subscriber.assertError(e);\n }\n\n @Test\n public void subscribeTwice() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n server.enqueue(new MockResponse().setBody(\"Hey\"));\n\n Single observable = service.body();\n\n RecordingSubscriber subscriber1 = subscriberRule.create();\n observable.subscribe(subscriber1);\n subscriber1.assertValue(\"Hi\").assertCompleted();\n\n RecordingSubscriber subscriber2 = subscriberRule.create();\n observable.subscribe(subscriber2);\n subscriber2.assertValue(\"Hey\").assertCompleted();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/SingleThrowingTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Ignore;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport rx.Single;\nimport rx.SingleSubscriber;\nimport rx.Subscriber;\nimport rx.exceptions.CompositeException;\nimport rx.exceptions.Exceptions;\nimport rx.plugins.RxJavaErrorHandler;\nimport rx.plugins.RxJavaPlugins;\n\npublic final class SingleThrowingTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule resetRule = new RxJavaPluginsResetRule();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Single body();\n\n @GET(\"/\")\n Single> response();\n\n @GET(\"/\")\n Single> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJavaCallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyThrowingInOnSuccessDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n });\n\n RecordingSubscriber observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onSuccess(String value) {\n throw e;\n }\n });\n\n assertThat(pluginRef.get()).isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n });\n\n RecordingSubscriber observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n CompositeException composite = (CompositeException) pluginRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void responseThrowingInOnSuccessDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n });\n\n RecordingSubscriber> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onSuccess(Response value) {\n throw e;\n }\n });\n\n assertThat(pluginRef.get()).isSameInstanceAs(e);\n }\n\n @Test\n public void responseThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n });\n\n RecordingSubscriber> observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n CompositeException composite = (CompositeException) pluginRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void resultThrowingInOnSuccessDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n });\n\n RecordingSubscriber> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onSuccess(Result value) {\n throw e;\n }\n });\n\n assertThat(pluginRef.get()).isSameInstanceAs(e);\n }\n\n @Ignore(\"Single's contract is onNext|onError so we have no way of triggering this case\")\n @Test\n public void resultThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.getInstance()\n .registerErrorHandler(\n new RxJavaErrorHandler() {\n @Override\n public void handleError(Throwable throwable) {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n }\n });\n\n RecordingSubscriber> observer = subscriberRule.create();\n final RuntimeException first = new RuntimeException();\n final RuntimeException second = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onSuccess(Result value) {\n // The only way to trigger onError for Result is if onSuccess throws.\n throw first;\n }\n\n @Override\n public void onError(Throwable throwable) {\n throw second;\n }\n });\n\n CompositeException composite = (CompositeException) pluginRef.get();\n assertThat(composite.getExceptions()).containsExactly(first, second);\n }\n\n private abstract static class ForwardingObserver extends SingleSubscriber {\n private final Subscriber delegate;\n\n ForwardingObserver(Subscriber delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public void onSuccess(T value) {\n delegate.onNext(value);\n delegate.onCompleted();\n }\n\n @Override\n public void onError(Throwable throwable) {\n delegate.onError(throwable);\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/SingleWithSchedulerTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport rx.Single;\nimport rx.schedulers.TestScheduler;\n\npublic final class SingleWithSchedulerTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Single body();\n\n @GET(\"/\")\n Single> response();\n\n @GET(\"/\")\n Single> result();\n }\n\n private final TestScheduler scheduler = new TestScheduler();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJavaCallAdapterFactory.createWithScheduler(scheduler))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyUsesScheduler() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().unsafeSubscribe(subscriber);\n subscriber.assertNoEvents();\n\n scheduler.triggerActions();\n subscriber.assertAnyValue().assertCompleted();\n }\n\n @Test\n public void responseUsesScheduler() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.response().unsafeSubscribe(subscriber);\n subscriber.assertNoEvents();\n\n scheduler.triggerActions();\n subscriber.assertAnyValue().assertCompleted();\n }\n\n @Test\n public void resultUsesScheduler() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.result().unsafeSubscribe(subscriber);\n subscriber.assertNoEvents();\n\n scheduler.triggerActions();\n subscriber.assertAnyValue().assertCompleted();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava/src/test/java/retrofit2/adapter/rxjava/StringConverterFactory.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\nfinal class StringConverterFactory extends Converter.Factory {\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return ResponseBody::string;\n }\n\n @Override\n public Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n return value -> RequestBody.create(MediaType.get(\"text/plain\"), value);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/README.md", "content": "RxJava2 Adapter\n==============\n\nAn `Adapter` for adapting [RxJava 2.x][1] types.\n\nAvailable types:\n\n * `Observable`, `Observable>`, and `Observable>` where `T` is the body type.\n * `Flowable`, `Flowable>` and `Flowable>` where `T` is the body type.\n * `Single`, `Single>`, and `Single>` where `T` is the body type.\n * `Maybe`, `Maybe>`, and `Maybe>` where `T` is the body type.\n * `Completable` where response bodies are discarded.\n\n\nUsage\n-----\n\nAdd `RxJava2CallAdapterFactory` as a `Call` adapter when building your `Retrofit` instance:\n```java\nRetrofit retrofit = new Retrofit.Builder()\n .baseUrl(\"https://example.com/\")\n .addCallAdapterFactory(RxJava2CallAdapterFactory.create())\n .build();\n```\n\nYour service methods can now use any of the above types as their return type.\n```java\ninterface MyService {\n @GET(\"/user\")\n Observable getUser();\n}\n```\n\nBy default all reactive types execute their requests synchronously. There are multiple ways to\ncontrol the threading on which a request occurs:\n\n * Call `subscribeOn` on the returned reactive type with a `Scheduler` of your choice.\n * Use `createAsync()` when creating the factory which will use OkHttp's internal thread pool.\n * Use `createWithScheduler(Scheduler)` to supply a default subscription `Scheduler`.\n\nDownload\n--------\n\nDownload [the latest JAR][2] or grab via [Maven][3]:\n```xml\n\n com.squareup.retrofit2\n adapter-rxjava2\n latest.version\n\n```\nor [Gradle][3]:\n```groovy\nimplementation 'com.squareup.retrofit2:adapter-rxjava2:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n\n [1]: https://github.com/ReactiveX/RxJava/tree/2.x\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=adapter-rxjava2&v=LATEST\n [3]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22adapter-rxjava2%22\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-adapters/rxjava2/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n api libs.rxjava2\n api libs.reactiveStreams\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.guava\n testImplementation libs.okhttp.mockwebserver\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.adapter.rxjava2'\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/gradle.properties", "content": "POM_ARTIFACT_ID=adapter-rxjava2\nPOM_NAME=Adapter: RxJava 2\nPOM_DESCRIPTION=A Retrofit CallAdapter for RxJava 2's stream types.\n" }, { "path": "retrofit-adapters/rxjava2/src/main/java/retrofit2/adapter/rxjava2/BodyObservable.java", "content": "/*\n * Copyright (C) 2016 Jake Wharton\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport io.reactivex.Observable;\nimport io.reactivex.Observer;\nimport io.reactivex.disposables.Disposable;\nimport io.reactivex.exceptions.CompositeException;\nimport io.reactivex.exceptions.Exceptions;\nimport io.reactivex.plugins.RxJavaPlugins;\nimport retrofit2.Response;\n\nfinal class BodyObservable extends Observable {\n private final Observable> upstream;\n\n BodyObservable(Observable> upstream) {\n this.upstream = upstream;\n }\n\n @Override\n protected void subscribeActual(Observer observer) {\n upstream.subscribe(new BodyObserver(observer));\n }\n\n private static class BodyObserver implements Observer> {\n private final Observer observer;\n private boolean terminated;\n\n BodyObserver(Observer observer) {\n this.observer = observer;\n }\n\n @Override\n public void onSubscribe(Disposable disposable) {\n observer.onSubscribe(disposable);\n }\n\n @Override\n public void onNext(Response response) {\n if (response.isSuccessful()) {\n observer.onNext(response.body());\n } else {\n terminated = true;\n Throwable t = new HttpException(response);\n try {\n observer.onError(t);\n } catch (Throwable inner) {\n Exceptions.throwIfFatal(inner);\n RxJavaPlugins.onError(new CompositeException(t, inner));\n }\n }\n }\n\n @Override\n public void onComplete() {\n if (!terminated) {\n observer.onComplete();\n }\n }\n\n @Override\n public void onError(Throwable throwable) {\n if (!terminated) {\n observer.onError(throwable);\n } else {\n // This should never happen! onNext handles and forwards errors automatically.\n Throwable broken =\n new AssertionError(\n \"This should never happen! Report as a bug with the full stacktrace.\");\n //noinspection UnnecessaryInitCause Two-arg AssertionError constructor is 1.7+ only.\n broken.initCause(throwable);\n RxJavaPlugins.onError(broken);\n }\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/main/java/retrofit2/adapter/rxjava2/CallEnqueueObservable.java", "content": "/*\n * Copyright (C) 2016 Jake Wharton\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport io.reactivex.Observable;\nimport io.reactivex.Observer;\nimport io.reactivex.disposables.Disposable;\nimport io.reactivex.exceptions.CompositeException;\nimport io.reactivex.exceptions.Exceptions;\nimport io.reactivex.plugins.RxJavaPlugins;\nimport retrofit2.Call;\nimport retrofit2.Callback;\nimport retrofit2.Response;\n\nfinal class CallEnqueueObservable extends Observable> {\n private final Call originalCall;\n\n CallEnqueueObservable(Call originalCall) {\n this.originalCall = originalCall;\n }\n\n @Override\n protected void subscribeActual(Observer> observer) {\n // Since Call is a one-shot type, clone it for each new observer.\n Call call = originalCall.clone();\n CallCallback callback = new CallCallback<>(call, observer);\n observer.onSubscribe(callback);\n if (!callback.isDisposed()) {\n call.enqueue(callback);\n }\n }\n\n private static final class CallCallback implements Disposable, Callback {\n private final Call call;\n private final Observer> observer;\n private volatile boolean disposed;\n boolean terminated = false;\n\n CallCallback(Call call, Observer> observer) {\n this.call = call;\n this.observer = observer;\n }\n\n @Override\n public void onResponse(Call call, Response response) {\n if (disposed) return;\n\n try {\n observer.onNext(response);\n\n if (!disposed) {\n terminated = true;\n observer.onComplete();\n }\n } catch (Throwable t) {\n Exceptions.throwIfFatal(t);\n if (terminated) {\n RxJavaPlugins.onError(t);\n } else if (!disposed) {\n try {\n observer.onError(t);\n } catch (Throwable inner) {\n Exceptions.throwIfFatal(inner);\n RxJavaPlugins.onError(new CompositeException(t, inner));\n }\n }\n }\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n if (call.isCanceled()) return;\n\n try {\n observer.onError(t);\n } catch (Throwable inner) {\n Exceptions.throwIfFatal(inner);\n RxJavaPlugins.onError(new CompositeException(t, inner));\n }\n }\n\n @Override\n public void dispose() {\n disposed = true;\n call.cancel();\n }\n\n @Override\n public boolean isDisposed() {\n return disposed;\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/main/java/retrofit2/adapter/rxjava2/CallExecuteObservable.java", "content": "/*\n * Copyright (C) 2016 Jake Wharton\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport io.reactivex.Observable;\nimport io.reactivex.Observer;\nimport io.reactivex.disposables.Disposable;\nimport io.reactivex.exceptions.CompositeException;\nimport io.reactivex.exceptions.Exceptions;\nimport io.reactivex.plugins.RxJavaPlugins;\nimport retrofit2.Call;\nimport retrofit2.Response;\n\nfinal class CallExecuteObservable extends Observable> {\n private final Call originalCall;\n\n CallExecuteObservable(Call originalCall) {\n this.originalCall = originalCall;\n }\n\n @Override\n protected void subscribeActual(Observer> observer) {\n // Since Call is a one-shot type, clone it for each new observer.\n Call call = originalCall.clone();\n CallDisposable disposable = new CallDisposable(call);\n observer.onSubscribe(disposable);\n if (disposable.isDisposed()) {\n return;\n }\n\n boolean terminated = false;\n try {\n Response response = call.execute();\n if (!disposable.isDisposed()) {\n observer.onNext(response);\n }\n if (!disposable.isDisposed()) {\n terminated = true;\n observer.onComplete();\n }\n } catch (Throwable t) {\n Exceptions.throwIfFatal(t);\n if (terminated) {\n RxJavaPlugins.onError(t);\n } else if (!disposable.isDisposed()) {\n try {\n observer.onError(t);\n } catch (Throwable inner) {\n Exceptions.throwIfFatal(inner);\n RxJavaPlugins.onError(new CompositeException(t, inner));\n }\n }\n }\n }\n\n private static final class CallDisposable implements Disposable {\n private final Call call;\n private volatile boolean disposed;\n\n CallDisposable(Call call) {\n this.call = call;\n }\n\n @Override\n public void dispose() {\n disposed = true;\n call.cancel();\n }\n\n @Override\n public boolean isDisposed() {\n return disposed;\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/main/java/retrofit2/adapter/rxjava2/HttpException.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport retrofit2.Response;\n\n/** @deprecated Use {@link retrofit2.HttpException}. */\n@Deprecated\npublic final class HttpException extends retrofit2.HttpException {\n public HttpException(Response response) {\n super(response);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/main/java/retrofit2/adapter/rxjava2/Result.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport java.io.IOException;\nimport javax.annotation.Nullable;\nimport retrofit2.Response;\n\n/** The result of executing an HTTP request. */\npublic final class Result {\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static Result error(Throwable error) {\n if (error == null) throw new NullPointerException(\"error == null\");\n return new Result<>(null, error);\n }\n\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static Result response(Response response) {\n if (response == null) throw new NullPointerException(\"response == null\");\n return new Result<>(response, null);\n }\n\n private final @Nullable Response response;\n private final @Nullable Throwable error;\n\n private Result(@Nullable Response response, @Nullable Throwable error) {\n this.response = response;\n this.error = error;\n }\n\n /**\n * The response received from executing an HTTP request. Only present when {@link #isError()} is\n * false, null otherwise.\n */\n public @Nullable Response response() {\n return response;\n }\n\n /**\n * The error experienced while attempting to execute an HTTP request. Only present when {@link\n * #isError()} is true, null otherwise.\n *\n *

If the error is an {@link IOException} then there was a problem with the transport to the\n * remote server. Any other exception type indicates an unexpected failure and should be\n * considered fatal (configuration error, programming error, etc.).\n */\n public @Nullable Throwable error() {\n return error;\n }\n\n /** {@code true} if the request resulted in an error. See {@link #error()} for the cause. */\n public boolean isError() {\n return error != null;\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/main/java/retrofit2/adapter/rxjava2/ResultObservable.java", "content": "/*\n * Copyright (C) 2016 Jake Wharton\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport io.reactivex.Observable;\nimport io.reactivex.Observer;\nimport io.reactivex.disposables.Disposable;\nimport io.reactivex.exceptions.CompositeException;\nimport io.reactivex.exceptions.Exceptions;\nimport io.reactivex.plugins.RxJavaPlugins;\nimport retrofit2.Response;\n\nfinal class ResultObservable extends Observable> {\n private final Observable> upstream;\n\n ResultObservable(Observable> upstream) {\n this.upstream = upstream;\n }\n\n @Override\n protected void subscribeActual(Observer> observer) {\n upstream.subscribe(new ResultObserver(observer));\n }\n\n private static class ResultObserver implements Observer> {\n private final Observer> observer;\n\n ResultObserver(Observer> observer) {\n this.observer = observer;\n }\n\n @Override\n public void onSubscribe(Disposable disposable) {\n observer.onSubscribe(disposable);\n }\n\n @Override\n public void onNext(Response response) {\n observer.onNext(Result.response(response));\n }\n\n @Override\n public void onError(Throwable throwable) {\n try {\n observer.onNext(Result.error(throwable));\n } catch (Throwable t) {\n try {\n observer.onError(t);\n } catch (Throwable inner) {\n Exceptions.throwIfFatal(inner);\n RxJavaPlugins.onError(new CompositeException(t, inner));\n }\n return;\n }\n observer.onComplete();\n }\n\n @Override\n public void onComplete() {\n observer.onComplete();\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/main/java/retrofit2/adapter/rxjava2/RxJava2CallAdapter.java", "content": "/*\n * Copyright (C) 2016 Jake Wharton\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport io.reactivex.BackpressureStrategy;\nimport io.reactivex.Observable;\nimport io.reactivex.Scheduler;\nimport io.reactivex.plugins.RxJavaPlugins;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport retrofit2.Call;\nimport retrofit2.CallAdapter;\nimport retrofit2.Response;\n\nfinal class RxJava2CallAdapter implements CallAdapter {\n private final Type responseType;\n private final @Nullable Scheduler scheduler;\n private final boolean isAsync;\n private final boolean isResult;\n private final boolean isBody;\n private final boolean isFlowable;\n private final boolean isSingle;\n private final boolean isMaybe;\n private final boolean isCompletable;\n\n RxJava2CallAdapter(\n Type responseType,\n @Nullable Scheduler scheduler,\n boolean isAsync,\n boolean isResult,\n boolean isBody,\n boolean isFlowable,\n boolean isSingle,\n boolean isMaybe,\n boolean isCompletable) {\n this.responseType = responseType;\n this.scheduler = scheduler;\n this.isAsync = isAsync;\n this.isResult = isResult;\n this.isBody = isBody;\n this.isFlowable = isFlowable;\n this.isSingle = isSingle;\n this.isMaybe = isMaybe;\n this.isCompletable = isCompletable;\n }\n\n @Override\n public Type responseType() {\n return responseType;\n }\n\n @Override\n public Object adapt(Call call) {\n Observable> responseObservable =\n isAsync ? new CallEnqueueObservable<>(call) : new CallExecuteObservable<>(call);\n\n Observable observable;\n if (isResult) {\n observable = new ResultObservable<>(responseObservable);\n } else if (isBody) {\n observable = new BodyObservable<>(responseObservable);\n } else {\n observable = responseObservable;\n }\n\n if (scheduler != null) {\n observable = observable.subscribeOn(scheduler);\n }\n\n if (isFlowable) {\n // We only ever deliver a single value, and the RS spec states that you MUST request at least\n // one element which means we never need to honor backpressure.\n return observable.toFlowable(BackpressureStrategy.MISSING);\n }\n if (isSingle) {\n return observable.singleOrError();\n }\n if (isMaybe) {\n return observable.singleElement();\n }\n if (isCompletable) {\n return observable.ignoreElements();\n }\n return RxJavaPlugins.onAssembly(observable);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/main/java/retrofit2/adapter/rxjava2/RxJava2CallAdapterFactory.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport io.reactivex.Completable;\nimport io.reactivex.Flowable;\nimport io.reactivex.Maybe;\nimport io.reactivex.Observable;\nimport io.reactivex.Scheduler;\nimport io.reactivex.Single;\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport retrofit2.CallAdapter;\nimport retrofit2.HttpException;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\n\n/**\n * A {@linkplain CallAdapter.Factory call adapter} which uses RxJava 2 for creating observables.\n *\n *

Adding this class to {@link Retrofit} allows you to return an {@link Observable}, {@link\n * Flowable}, {@link Single}, {@link Completable} or {@link Maybe} from service methods.\n *\n * 

\n * interface MyService {\n *   @GET(\"user/me\")\n *   Observable<User> getUser()\n * }\n *
\n *\n * There are three configurations supported for the {@code Observable}, {@code Flowable}, {@code\n * Single}, {@link Completable} and {@code Maybe} type parameter:\n *\n *
    \n *
  • Direct body (e.g., {@code Observable}) calls {@code onNext} with the deserialized\n * body for 2XX responses and calls {@code onError} with {@link HttpException} for non-2XX\n * responses and {@link IOException} for network errors.\n *
  • Response wrapped body (e.g., {@code Observable>}) calls {@code onNext} with\n * a {@link Response} object for all HTTP responses and calls {@code onError} with {@link\n * IOException} for network errors\n *
  • Result wrapped body (e.g., {@code Observable>}) calls {@code onNext} with a\n * {@link Result} object for all HTTP responses and errors.\n *
\n */\npublic final class RxJava2CallAdapterFactory extends CallAdapter.Factory {\n /**\n * Returns an instance which creates synchronous observables that do not operate on any scheduler\n * by default.\n */\n public static RxJava2CallAdapterFactory create() {\n return new RxJava2CallAdapterFactory(null, false);\n }\n\n /** Returns an instance which creates asynchronous observables. */\n public static RxJava2CallAdapterFactory createAsync() {\n return new RxJava2CallAdapterFactory(null, true);\n }\n\n /**\n * Returns an instance which creates synchronous observables that {@linkplain\n * Observable#subscribeOn(Scheduler) subscribe on} {@code scheduler} by default.\n */\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static RxJava2CallAdapterFactory createWithScheduler(Scheduler scheduler) {\n if (scheduler == null) throw new NullPointerException(\"scheduler == null\");\n return new RxJava2CallAdapterFactory(scheduler, false);\n }\n\n private final @Nullable Scheduler scheduler;\n private final boolean isAsync;\n\n private RxJava2CallAdapterFactory(@Nullable Scheduler scheduler, boolean isAsync) {\n this.scheduler = scheduler;\n this.isAsync = isAsync;\n }\n\n @Override\n public @Nullable CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n Class rawType = getRawType(returnType);\n\n if (rawType == Completable.class) {\n // Completable is not parameterized (which is what the rest of this method deals with) so it\n // can only be created with a single configuration.\n return new RxJava2CallAdapter(\n Void.class, scheduler, isAsync, false, true, false, false, false, true);\n }\n\n boolean isFlowable = rawType == Flowable.class;\n boolean isSingle = rawType == Single.class;\n boolean isMaybe = rawType == Maybe.class;\n if (rawType != Observable.class && !isFlowable && !isSingle && !isMaybe) {\n return null;\n }\n\n boolean isResult = false;\n boolean isBody = false;\n Type responseType;\n if (!(returnType instanceof ParameterizedType)) {\n String name =\n isFlowable ? \"Flowable\" : isSingle ? \"Single\" : isMaybe ? \"Maybe\" : \"Observable\";\n throw new IllegalStateException(\n name\n + \" return type must be parameterized\"\n + \" as \"\n + name\n + \" or \"\n + name\n + \"\");\n }\n\n Type observableType = getParameterUpperBound(0, (ParameterizedType) returnType);\n Class rawObservableType = getRawType(observableType);\n if (rawObservableType == Response.class) {\n if (!(observableType instanceof ParameterizedType)) {\n throw new IllegalStateException(\n \"Response must be parameterized\" + \" as Response or Response\");\n }\n responseType = getParameterUpperBound(0, (ParameterizedType) observableType);\n } else if (rawObservableType == Result.class) {\n if (!(observableType instanceof ParameterizedType)) {\n throw new IllegalStateException(\n \"Result must be parameterized\" + \" as Result or Result\");\n }\n responseType = getParameterUpperBound(0, (ParameterizedType) observableType);\n isResult = true;\n } else {\n responseType = observableType;\n isBody = true;\n }\n\n return new RxJava2CallAdapter(\n responseType, scheduler, isAsync, isResult, isBody, isFlowable, isSingle, isMaybe, false);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/main/java/retrofit2/adapter/rxjava2/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.adapter.rxjava2;\n" }, { "path": "retrofit-adapters/rxjava2/src/main/resources/META-INF/proguard/retrofit2-rxjava2-adapter.pro", "content": "# Keep generic signature of RxJava2 (R8 full mode strips signatures from non-kept items).\n# It's necessary to add the explicit rule for Result as it could be used as a nested return type like `Observable>`\n-keep,allowoptimization,allowshrinking,allowobfuscation class retrofit2.adapter.rxjava2.Result\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/AsyncTest.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static java.util.concurrent.TimeUnit.SECONDS;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\nimport static org.junit.Assert.assertEquals;\nimport static org.junit.Assert.assertFalse;\nimport static org.junit.Assert.assertSame;\nimport static org.junit.Assert.assertTrue;\n\nimport io.reactivex.Completable;\nimport io.reactivex.exceptions.CompositeException;\nimport io.reactivex.exceptions.Exceptions;\nimport io.reactivex.exceptions.UndeliverableException;\nimport io.reactivex.observers.TestObserver;\nimport io.reactivex.plugins.RxJavaPlugins;\nimport java.io.IOException;\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.concurrent.CountDownLatch;\nimport java.util.concurrent.ExecutorService;\nimport java.util.concurrent.Executors;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.Dispatcher;\nimport okhttp3.OkHttpClient;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.After;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Retrofit;\nimport retrofit2.adapter.rxjava2.CompletableThrowingTest.ForwardingCompletableObserver;\nimport retrofit2.http.GET;\n\npublic final class AsyncTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\")\n Completable completable();\n }\n\n private Service service;\n private final List uncaughtExceptions = new ArrayList<>();\n\n @Before\n public void setUp() {\n ExecutorService executorService =\n Executors.newCachedThreadPool(\n r -> {\n Thread thread = new Thread(r);\n thread.setUncaughtExceptionHandler((t, e) -> uncaughtExceptions.add(e));\n return thread;\n });\n\n OkHttpClient client =\n new OkHttpClient.Builder().dispatcher(new Dispatcher(executorService)).build();\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .client(client)\n .addCallAdapterFactory(RxJava2CallAdapterFactory.createAsync())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @After\n public void tearDown() {\n assertTrue(\"Uncaught exceptions: \" + uncaughtExceptions, uncaughtExceptions.isEmpty());\n }\n\n @Test\n public void success() throws InterruptedException {\n TestObserver observer = new TestObserver<>();\n service.completable().subscribe(observer);\n assertFalse(observer.await(1, SECONDS));\n\n server.enqueue(new MockResponse());\n observer.awaitTerminalEvent(1, SECONDS);\n observer.assertComplete();\n }\n\n @Test\n public void failure() throws InterruptedException {\n TestObserver observer = new TestObserver<>();\n service.completable().subscribe(observer);\n assertFalse(observer.await(1, SECONDS));\n\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n observer.awaitTerminalEvent(1, SECONDS);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void throwingInOnCompleteDeliveredToPlugin() throws InterruptedException {\n server.enqueue(new MockResponse());\n\n final CountDownLatch latch = new CountDownLatch(1);\n final AtomicReference errorRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n latch.countDown();\n });\n\n TestObserver observer = new TestObserver<>();\n final RuntimeException e = new RuntimeException();\n service\n .completable()\n .subscribe(\n new ForwardingCompletableObserver(observer) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n latch.await(1, SECONDS);\n\n Throwable error = errorRef.get();\n assertThat(error).isInstanceOf(UndeliverableException.class);\n assertThat(error).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() throws InterruptedException {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final CountDownLatch latch = new CountDownLatch(1);\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n latch.countDown();\n });\n\n TestObserver observer = new TestObserver<>();\n final RuntimeException e = new RuntimeException();\n final AtomicReference errorRef = new AtomicReference<>();\n service\n .completable()\n .subscribe(\n new ForwardingCompletableObserver(observer) {\n @Override\n public void onError(Throwable throwable) {\n errorRef.set(throwable);\n throw e;\n }\n });\n\n latch.await(1, SECONDS);\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) pluginRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void bodyThrowingFatalInOnErrorPropagates() throws InterruptedException {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final CountDownLatch latch = new CountDownLatch(1);\n\n TestObserver observer = new TestObserver<>();\n final Error e = new OutOfMemoryError(\"Not real\");\n service\n .completable()\n .subscribe(\n new ForwardingCompletableObserver(observer) {\n @Override\n public void onError(Throwable throwable) {\n throw e;\n }\n });\n\n latch.await(1, SECONDS);\n\n assertEquals(1, uncaughtExceptions.size());\n assertSame(e, uncaughtExceptions.remove(0));\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/CancelDisposeTest.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static org.junit.Assert.assertEquals;\nimport static org.junit.Assert.assertFalse;\nimport static org.junit.Assert.assertTrue;\n\nimport io.reactivex.Observable;\nimport io.reactivex.disposables.Disposable;\nimport java.util.List;\nimport okhttp3.Call;\nimport okhttp3.OkHttpClient;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class CancelDisposeTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\")\n Observable go();\n }\n\n private final OkHttpClient client = new OkHttpClient();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava2CallAdapterFactory.createAsync())\n .callFactory(client)\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void disposeCancelsCall() {\n Disposable disposable = service.go().subscribe();\n List calls = client.dispatcher().runningCalls();\n assertEquals(1, calls.size());\n disposable.dispose();\n assertTrue(calls.get(0).isCanceled());\n }\n\n @SuppressWarnings(\"ResultOfMethodCallIgnored\")\n @Test\n public void disposeBeforeEnqueueDoesNotEnqueue() {\n service.go().test(true);\n List calls = client.dispatcher().runningCalls();\n assertEquals(0, calls.size());\n }\n\n @Test\n public void cancelDoesNotDispose() {\n Disposable disposable = service.go().subscribe();\n List calls = client.dispatcher().runningCalls();\n assertEquals(1, calls.size());\n calls.get(0).cancel();\n assertFalse(disposable.isDisposed());\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/CancelDisposeTestSync.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static org.junit.Assert.assertEquals;\n\nimport io.reactivex.Observable;\nimport okhttp3.OkHttpClient;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class CancelDisposeTestSync {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\")\n Observable go();\n }\n\n private final OkHttpClient client = new OkHttpClient();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava2CallAdapterFactory.create())\n .callFactory(client)\n .build();\n service = retrofit.create(Service.class);\n }\n\n @SuppressWarnings(\"ResultOfMethodCallIgnored\")\n @Test\n public void disposeBeforeExecuteDoesNotEnqueue() {\n service.go().test(true);\n assertEquals(0, server.getRequestCount());\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/CompletableTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.Completable;\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class CompletableTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n @Rule\n public final RecordingCompletableObserver.Rule observerRule =\n new RecordingCompletableObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Completable completable();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addCallAdapterFactory(RxJava2CallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void completableSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingCompletableObserver observer = observerRule.create();\n service.completable().subscribe(observer);\n observer.assertComplete();\n }\n\n @Test\n public void completableSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingCompletableObserver observer = observerRule.create();\n service.completable().subscribe(observer);\n // Required for backwards compatibility.\n observer.assertError(HttpException.class, \"HTTP 404 Client Error\");\n }\n\n @Test\n public void completableFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingCompletableObserver observer = observerRule.create();\n service.completable().subscribe(observer);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void subscribeTwice() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n server.enqueue(new MockResponse().setBody(\"Hey\"));\n\n Completable observable = service.completable();\n\n RecordingCompletableObserver observer1 = observerRule.create();\n observable.subscribe(observer1);\n observer1.assertComplete();\n\n RecordingCompletableObserver observer2 = observerRule.create();\n observable.subscribe(observer2);\n observer2.assertComplete();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/CompletableThrowingTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\n\nimport io.reactivex.Completable;\nimport io.reactivex.CompletableObserver;\nimport io.reactivex.disposables.Disposable;\nimport io.reactivex.exceptions.CompositeException;\nimport io.reactivex.exceptions.Exceptions;\nimport io.reactivex.exceptions.UndeliverableException;\nimport io.reactivex.plugins.RxJavaPlugins;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class CompletableThrowingTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule resetRule = new RxJavaPluginsResetRule();\n\n @Rule\n public final RecordingCompletableObserver.Rule observerRule =\n new RecordingCompletableObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Completable completable();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addCallAdapterFactory(RxJava2CallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void throwingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference errorRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n });\n\n RecordingCompletableObserver observer = observerRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .completable()\n .subscribe(\n new ForwardingCompletableObserver(observer) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n Throwable error = errorRef.get();\n assertThat(error).isInstanceOf(UndeliverableException.class);\n assertThat(error).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n });\n\n RecordingCompletableObserver observer = observerRule.create();\n final RuntimeException e = new RuntimeException();\n final AtomicReference errorRef = new AtomicReference<>();\n service\n .completable()\n .subscribe(\n new ForwardingCompletableObserver(observer) {\n @Override\n public void onError(Throwable throwable) {\n errorRef.set(throwable);\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) pluginRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n abstract static class ForwardingCompletableObserver implements CompletableObserver {\n private final CompletableObserver delegate;\n\n ForwardingCompletableObserver(CompletableObserver delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public void onSubscribe(Disposable disposable) {\n delegate.onSubscribe(disposable);\n }\n\n @Override\n public void onComplete() {\n delegate.onComplete();\n }\n\n @Override\n public void onError(Throwable throwable) {\n delegate.onError(throwable);\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/CompletableWithSchedulerTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport io.reactivex.Completable;\nimport io.reactivex.schedulers.TestScheduler;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class CompletableWithSchedulerTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n @Rule\n public final RecordingCompletableObserver.Rule observerRule =\n new RecordingCompletableObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Completable completable();\n }\n\n private final TestScheduler scheduler = new TestScheduler();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addCallAdapterFactory(RxJava2CallAdapterFactory.createWithScheduler(scheduler))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void completableUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingCompletableObserver observer = observerRule.create();\n service.completable().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertComplete();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/FlowableTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.Flowable;\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class FlowableTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Flowable body();\n\n @GET(\"/\")\n Flowable> response();\n\n @GET(\"/\")\n Flowable> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava2CallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodySuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().subscribe(subscriber);\n subscriber.assertValue(\"Hi\").assertComplete();\n }\n\n @Test\n public void bodySuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().subscribe(subscriber);\n // Required for backwards compatibility.\n subscriber.assertError(HttpException.class, \"HTTP 404 Client Error\");\n }\n\n @Test\n public void bodyFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().subscribe(subscriber);\n subscriber.assertError(IOException.class);\n }\n\n @Test\n public void responseSuccess200() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.response().subscribe(subscriber);\n assertThat(subscriber.takeValue().isSuccessful()).isTrue();\n subscriber.assertComplete();\n }\n\n @Test\n public void responseSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.response().subscribe(subscriber);\n assertThat(subscriber.takeValue().isSuccessful()).isFalse();\n subscriber.assertComplete();\n }\n\n @Test\n public void responseFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.response().subscribe(subscriber);\n subscriber.assertError(IOException.class);\n }\n\n @Test\n public void resultSuccess200() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.result().subscribe(subscriber);\n Result result = subscriber.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isTrue();\n subscriber.assertComplete();\n }\n\n @Test\n public void resultSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.result().subscribe(subscriber);\n Result result = subscriber.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isFalse();\n subscriber.assertComplete();\n }\n\n @Test\n public void resultFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.result().subscribe(subscriber);\n Result result = subscriber.takeValue();\n assertThat(result.isError()).isTrue();\n assertThat(result.error()).isInstanceOf(IOException.class);\n subscriber.assertComplete();\n }\n\n @Test\n public void subscribeTwice() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n server.enqueue(new MockResponse().setBody(\"Hey\"));\n\n Flowable observable = service.body();\n\n RecordingSubscriber subscriber1 = subscriberRule.create();\n observable.subscribe(subscriber1);\n subscriber1.assertValue(\"Hi\").assertComplete();\n\n RecordingSubscriber subscriber2 = subscriberRule.create();\n observable.subscribe(subscriber2);\n subscriber2.assertValue(\"Hey\").assertComplete();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/FlowableThrowingTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.Flowable;\nimport io.reactivex.exceptions.CompositeException;\nimport io.reactivex.exceptions.Exceptions;\nimport io.reactivex.exceptions.UndeliverableException;\nimport io.reactivex.plugins.RxJavaPlugins;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport org.reactivestreams.Subscriber;\nimport org.reactivestreams.Subscription;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class FlowableThrowingTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule resetRule = new RxJavaPluginsResetRule();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Flowable body();\n\n @GET(\"/\")\n Flowable> response();\n\n @GET(\"/\")\n Flowable> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava2CallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber subscriber = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .safeSubscribe(\n new ForwardingSubscriber(subscriber) {\n @Override\n public void onNext(String value) {\n throw e;\n }\n });\n\n subscriber.assertError(e);\n }\n\n @Test\n public void bodyThrowingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSubscriber subscriber = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingSubscriber(subscriber) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n subscriber.assertAnyValue();\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(UndeliverableException.class);\n assertThat(throwable).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSubscriber subscriber = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingSubscriber(subscriber) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void responseThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .safeSubscribe(\n new ForwardingSubscriber>(subscriber) {\n @Override\n public void onNext(Response value) {\n throw e;\n }\n });\n\n subscriber.assertError(e);\n }\n\n @Test\n public void responseThrowingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingSubscriber>(subscriber) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n subscriber.assertAnyValue();\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(UndeliverableException.class);\n assertThat(throwable).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void responseThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingSubscriber>(subscriber) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void resultThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .safeSubscribe(\n new ForwardingSubscriber>(subscriber) {\n @Override\n public void onNext(Result value) {\n throw e;\n }\n });\n\n subscriber.assertError(e);\n }\n\n @Test\n public void resultThrowingInOnCompletedDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingSubscriber>(subscriber) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n subscriber.assertAnyValue();\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(UndeliverableException.class);\n assertThat(throwable).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void resultThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n final RuntimeException first = new RuntimeException();\n final RuntimeException second = new RuntimeException();\n service\n .result()\n .safeSubscribe(\n new ForwardingSubscriber>(subscriber) {\n @Override\n public void onNext(Result value) {\n // The only way to trigger onError for a result is if onNext throws.\n throw first;\n }\n\n @Override\n public void onError(Throwable throwable) {\n throw second;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(first, second);\n }\n\n private abstract static class ForwardingSubscriber implements Subscriber {\n private final Subscriber delegate;\n\n ForwardingSubscriber(Subscriber delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public void onSubscribe(Subscription subscription) {\n delegate.onSubscribe(subscription);\n }\n\n @Override\n public void onNext(T value) {\n delegate.onNext(value);\n }\n\n @Override\n public void onError(Throwable throwable) {\n delegate.onError(throwable);\n }\n\n @Override\n public void onComplete() {\n delegate.onComplete();\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/FlowableWithSchedulerTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport io.reactivex.Flowable;\nimport io.reactivex.schedulers.TestScheduler;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class FlowableWithSchedulerTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Flowable body();\n\n @GET(\"/\")\n Flowable> response();\n\n @GET(\"/\")\n Flowable> result();\n }\n\n private final TestScheduler scheduler = new TestScheduler();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava2CallAdapterFactory.createWithScheduler(scheduler))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().subscribe(subscriber);\n subscriber.assertNoEvents();\n\n scheduler.triggerActions();\n subscriber.assertAnyValue().assertComplete();\n }\n\n @Test\n public void responseUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.response().subscribe(subscriber);\n subscriber.assertNoEvents();\n\n scheduler.triggerActions();\n subscriber.assertAnyValue().assertComplete();\n }\n\n @Test\n public void resultUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.result().subscribe(subscriber);\n subscriber.assertNoEvents();\n\n scheduler.triggerActions();\n subscriber.assertAnyValue().assertComplete();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/MaybeTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.Maybe;\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class MaybeTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingMaybeObserver.Rule observerRule = new RecordingMaybeObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Maybe body();\n\n @GET(\"/\")\n Maybe> response();\n\n @GET(\"/\")\n Maybe> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava2CallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodySuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingMaybeObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertValue(\"Hi\");\n }\n\n @Test\n public void bodySuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingMaybeObserver observer = observerRule.create();\n service.body().subscribe(observer);\n // Required for backwards compatibility.\n observer.assertError(HttpException.class, \"HTTP 404 Client Error\");\n }\n\n @Test\n public void bodyFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingMaybeObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void responseSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingMaybeObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n Response response = observer.takeValue();\n assertThat(response.isSuccessful()).isTrue();\n }\n\n @Test\n public void responseSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingMaybeObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n assertThat(observer.takeValue().isSuccessful()).isFalse();\n }\n\n @Test\n public void responseFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingMaybeObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void resultSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingMaybeObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isTrue();\n }\n\n @Test\n public void resultSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingMaybeObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isFalse();\n }\n\n @Test\n public void resultFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingMaybeObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isTrue();\n assertThat(result.error()).isInstanceOf(IOException.class);\n }\n\n @Test\n public void subscribeTwice() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n server.enqueue(new MockResponse().setBody(\"Hey\"));\n\n Maybe observable = service.body();\n\n RecordingMaybeObserver observer1 = observerRule.create();\n observable.subscribe(observer1);\n observer1.assertValue(\"Hi\");\n\n RecordingMaybeObserver observer2 = observerRule.create();\n observable.subscribe(observer2);\n observer2.assertValue(\"Hey\");\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/MaybeThrowingTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.Maybe;\nimport io.reactivex.MaybeObserver;\nimport io.reactivex.disposables.Disposable;\nimport io.reactivex.exceptions.CompositeException;\nimport io.reactivex.exceptions.Exceptions;\nimport io.reactivex.exceptions.UndeliverableException;\nimport io.reactivex.plugins.RxJavaPlugins;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Ignore;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class MaybeThrowingTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule resetRule = new RxJavaPluginsResetRule();\n @Rule public final RecordingMaybeObserver.Rule subscriberRule = new RecordingMaybeObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Maybe body();\n\n @GET(\"/\")\n Maybe> response();\n\n @GET(\"/\")\n Maybe> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava2CallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyThrowingInOnSuccessDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingMaybeObserver observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onSuccess(String value) {\n throw e;\n }\n });\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(UndeliverableException.class);\n assertThat(throwable).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingMaybeObserver observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void responseThrowingInOnSuccessDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingMaybeObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onSuccess(Response value) {\n throw e;\n }\n });\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(UndeliverableException.class);\n assertThat(throwable).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void responseThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingMaybeObserver> observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void resultThrowingInOnSuccessDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingMaybeObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onSuccess(Result value) {\n throw e;\n }\n });\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(UndeliverableException.class);\n assertThat(throwable).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Ignore(\"Single's contract is onNext|onError so we have no way of triggering this case\")\n @Test\n public void resultThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingMaybeObserver> observer = subscriberRule.create();\n final RuntimeException first = new RuntimeException();\n final RuntimeException second = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onSuccess(Result value) {\n // The only way to trigger onError for Result is if onSuccess throws.\n throw first;\n }\n\n @Override\n public void onError(Throwable throwable) {\n throw second;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(first, second);\n }\n\n private abstract static class ForwardingObserver implements MaybeObserver {\n private final MaybeObserver delegate;\n\n ForwardingObserver(MaybeObserver delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public void onSubscribe(Disposable disposable) {\n delegate.onSubscribe(disposable);\n }\n\n @Override\n public void onSuccess(T value) {\n delegate.onSuccess(value);\n }\n\n @Override\n public void onError(Throwable throwable) {\n delegate.onError(throwable);\n }\n\n @Override\n public void onComplete() {\n delegate.onComplete();\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/MaybeWithSchedulerTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport io.reactivex.Maybe;\nimport io.reactivex.schedulers.TestScheduler;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class MaybeWithSchedulerTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingMaybeObserver.Rule observerRule = new RecordingMaybeObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Maybe body();\n\n @GET(\"/\")\n Maybe> response();\n\n @GET(\"/\")\n Maybe> result();\n }\n\n private final TestScheduler scheduler = new TestScheduler();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava2CallAdapterFactory.createWithScheduler(scheduler))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingMaybeObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue();\n }\n\n @Test\n public void responseUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingMaybeObserver observer = observerRule.create();\n service.response().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue();\n }\n\n @Test\n public void resultUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingMaybeObserver observer = observerRule.create();\n service.result().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/ObservableTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.Observable;\nimport io.reactivex.plugins.RxJavaPlugins;\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class ObservableTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingObserver.Rule observerRule = new RecordingObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Observable body();\n\n @GET(\"/\")\n Observable> response();\n\n @GET(\"/\")\n Observable> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava2CallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodySuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertValue(\"Hi\").assertComplete();\n }\n\n @Test\n public void bodySuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingObserver observer = observerRule.create();\n service.body().subscribe(observer);\n // Required for backwards compatibility.\n observer.assertError(HttpException.class, \"HTTP 404 Client Error\");\n }\n\n @Test\n public void bodyFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void responseSuccess200() {\n server.enqueue(new MockResponse());\n\n RecordingObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n assertThat(observer.takeValue().isSuccessful()).isTrue();\n observer.assertComplete();\n }\n\n @Test\n public void responseSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n assertThat(observer.takeValue().isSuccessful()).isFalse();\n observer.assertComplete();\n }\n\n @Test\n public void responseFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void resultSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isTrue();\n observer.assertComplete();\n }\n\n @Test\n public void resultSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isFalse();\n observer.assertComplete();\n }\n\n @Test\n public void resultFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isTrue();\n assertThat(result.error()).isInstanceOf(IOException.class);\n observer.assertComplete();\n }\n\n @Test\n public void observableAssembly() {\n try {\n final Observable justMe = Observable.just(\"me\");\n RxJavaPlugins.setOnObservableAssembly(f -> justMe);\n assertThat(service.body()).isEqualTo(justMe);\n } finally {\n RxJavaPlugins.reset();\n }\n }\n\n @Test\n public void subscribeTwice() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n server.enqueue(new MockResponse().setBody(\"Hey\"));\n\n Observable observable = service.body();\n\n RecordingObserver observer1 = observerRule.create();\n observable.subscribe(observer1);\n observer1.assertValue(\"Hi\").assertComplete();\n\n RecordingObserver observer2 = observerRule.create();\n observable.subscribe(observer2);\n observer2.assertValue(\"Hey\").assertComplete();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/ObservableThrowingTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.Observable;\nimport io.reactivex.Observer;\nimport io.reactivex.disposables.Disposable;\nimport io.reactivex.exceptions.CompositeException;\nimport io.reactivex.exceptions.Exceptions;\nimport io.reactivex.exceptions.UndeliverableException;\nimport io.reactivex.plugins.RxJavaPlugins;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class ObservableThrowingTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule resetRule = new RxJavaPluginsResetRule();\n @Rule public final RecordingObserver.Rule subscriberRule = new RecordingObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Observable body();\n\n @GET(\"/\")\n Observable> response();\n\n @GET(\"/\")\n Observable> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava2CallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingObserver observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onNext(String value) {\n throw e;\n }\n });\n\n observer.assertError(e);\n }\n\n @Test\n public void bodyThrowingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingObserver observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n observer.assertAnyValue();\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(UndeliverableException.class);\n assertThat(throwable).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingObserver observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void responseThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onNext(Response value) {\n throw e;\n }\n });\n\n observer.assertError(e);\n }\n\n @Test\n public void responseThrowingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n observer.assertAnyValue();\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(UndeliverableException.class);\n assertThat(throwable).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void responseThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingObserver> observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void resultThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onNext(Result value) {\n throw e;\n }\n });\n\n observer.assertError(e);\n }\n\n @Test\n public void resultThrowingInOnCompletedDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n observer.assertAnyValue();\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(UndeliverableException.class);\n assertThat(throwable).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void resultThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingObserver> observer = subscriberRule.create();\n final RuntimeException first = new RuntimeException();\n final RuntimeException second = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onNext(Result value) {\n // The only way to trigger onError for a result is if onNext throws.\n throw first;\n }\n\n @Override\n public void onError(Throwable throwable) {\n throw second;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(first, second);\n }\n\n private abstract static class ForwardingObserver implements Observer {\n private final Observer delegate;\n\n ForwardingObserver(Observer delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public void onSubscribe(Disposable disposable) {\n delegate.onSubscribe(disposable);\n }\n\n @Override\n public void onNext(T value) {\n delegate.onNext(value);\n }\n\n @Override\n public void onError(Throwable throwable) {\n delegate.onError(throwable);\n }\n\n @Override\n public void onComplete() {\n delegate.onComplete();\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/ObservableWithSchedulerTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport io.reactivex.Observable;\nimport io.reactivex.schedulers.TestScheduler;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class ObservableWithSchedulerTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingObserver.Rule observerRule = new RecordingObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Observable body();\n\n @GET(\"/\")\n Observable> response();\n\n @GET(\"/\")\n Observable> result();\n }\n\n private final TestScheduler scheduler = new TestScheduler();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava2CallAdapterFactory.createWithScheduler(scheduler))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue().assertComplete();\n }\n\n @Test\n public void responseUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingObserver observer = observerRule.create();\n service.response().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue().assertComplete();\n }\n\n @Test\n public void resultUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingObserver observer = observerRule.create();\n service.result().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue().assertComplete();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/RecordingCompletableObserver.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static com.google.common.truth.Truth.assertWithMessage;\n\nimport io.reactivex.CompletableObserver;\nimport io.reactivex.Notification;\nimport io.reactivex.disposables.Disposable;\nimport java.util.ArrayDeque;\nimport java.util.ArrayList;\nimport java.util.Deque;\nimport java.util.List;\nimport org.junit.rules.TestRule;\nimport org.junit.runner.Description;\nimport org.junit.runners.model.Statement;\n\n/** A test {@link CompletableObserver} and JUnit rule which guarantees all events are asserted. */\nfinal class RecordingCompletableObserver implements CompletableObserver {\n private final Deque> events = new ArrayDeque<>();\n\n private RecordingCompletableObserver() {}\n\n @Override\n public void onSubscribe(Disposable disposable) {}\n\n @Override\n public void onComplete() {\n events.add(Notification.createOnComplete());\n }\n\n @Override\n public void onError(Throwable e) {\n events.add(Notification.createOnError(e));\n }\n\n private Notification takeNotification() {\n Notification notification = events.pollFirst();\n if (notification == null) {\n throw new AssertionError(\"No event found!\");\n }\n return notification;\n }\n\n public Throwable takeError() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onError event but was \" + notification)\n .that(notification.isOnError())\n .isTrue();\n return notification.getError();\n }\n\n public void assertComplete() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onCompleted event but was \" + notification)\n .that(notification.isOnComplete())\n .isTrue();\n assertNoEvents();\n }\n\n public void assertError(Throwable throwable) {\n assertThat(takeError()).isEqualTo(throwable);\n }\n\n public void assertError(Class errorClass) {\n assertError(errorClass, null);\n }\n\n public void assertError(Class errorClass, String message) {\n Throwable throwable = takeError();\n assertThat(throwable).isInstanceOf(errorClass);\n if (message != null) {\n assertThat(throwable).hasMessageThat().isEqualTo(message);\n }\n assertNoEvents();\n }\n\n public void assertNoEvents() {\n assertWithMessage(\"Unconsumed events found!\").that(events).isEmpty();\n }\n\n public static final class Rule implements TestRule {\n final List subscribers = new ArrayList<>();\n\n public RecordingCompletableObserver create() {\n RecordingCompletableObserver subscriber = new RecordingCompletableObserver();\n subscribers.add(subscriber);\n return subscriber;\n }\n\n @Override\n public Statement apply(final Statement base, Description description) {\n return new Statement() {\n @Override\n public void evaluate() throws Throwable {\n base.evaluate();\n for (RecordingCompletableObserver subscriber : subscribers) {\n subscriber.assertNoEvents();\n }\n }\n };\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/RecordingMaybeObserver.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static com.google.common.truth.Truth.assertWithMessage;\n\nimport io.reactivex.MaybeObserver;\nimport io.reactivex.Notification;\nimport io.reactivex.Observer;\nimport io.reactivex.disposables.Disposable;\nimport java.util.ArrayDeque;\nimport java.util.ArrayList;\nimport java.util.Deque;\nimport java.util.List;\nimport org.junit.rules.TestRule;\nimport org.junit.runner.Description;\nimport org.junit.runners.model.Statement;\n\n/** A test {@link Observer} and JUnit rule which guarantees all events are asserted. */\nfinal class RecordingMaybeObserver implements MaybeObserver {\n private final Deque> events = new ArrayDeque<>();\n\n private RecordingMaybeObserver() {}\n\n @Override\n public void onSubscribe(Disposable disposable) {}\n\n @Override\n public void onSuccess(T value) {\n events.add(Notification.createOnNext(value));\n }\n\n @Override\n public void onError(Throwable e) {\n events.add(Notification.createOnError(e));\n }\n\n @Override\n public void onComplete() {\n events.add(Notification.createOnComplete());\n }\n\n private Notification takeNotification() {\n Notification notification = events.pollFirst();\n if (notification == null) {\n throw new AssertionError(\"No event found!\");\n }\n return notification;\n }\n\n public T takeValue() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onNext event but was \" + notification)\n .that(notification.isOnNext())\n .isTrue();\n return notification.getValue();\n }\n\n public Throwable takeError() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onError event but was \" + notification)\n .that(notification.isOnError())\n .isTrue();\n return notification.getError();\n }\n\n public RecordingMaybeObserver assertAnyValue() {\n takeValue();\n return this;\n }\n\n public RecordingMaybeObserver assertValue(T value) {\n assertThat(takeValue()).isEqualTo(value);\n return this;\n }\n\n public void assertError(Throwable throwable) {\n assertThat(takeError()).isEqualTo(throwable);\n }\n\n public void assertError(Class errorClass) {\n assertError(errorClass, null);\n }\n\n public void assertError(Class errorClass, String message) {\n Throwable throwable = takeError();\n assertThat(throwable).isInstanceOf(errorClass);\n if (message != null) {\n assertThat(throwable).hasMessageThat().isEqualTo(message);\n }\n assertNoEvents();\n }\n\n public void assertNoEvents() {\n assertWithMessage(\"Unconsumed events found!\").that(events).isEmpty();\n }\n\n public static final class Rule implements TestRule {\n final List> subscribers = new ArrayList<>();\n\n public RecordingMaybeObserver create() {\n RecordingMaybeObserver subscriber = new RecordingMaybeObserver<>();\n subscribers.add(subscriber);\n return subscriber;\n }\n\n @Override\n public Statement apply(final Statement base, Description description) {\n return new Statement() {\n @Override\n public void evaluate() throws Throwable {\n base.evaluate();\n for (RecordingMaybeObserver subscriber : subscribers) {\n subscriber.assertNoEvents();\n }\n }\n };\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/RecordingObserver.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static com.google.common.truth.Truth.assertWithMessage;\n\nimport io.reactivex.Notification;\nimport io.reactivex.Observer;\nimport io.reactivex.disposables.Disposable;\nimport java.util.ArrayDeque;\nimport java.util.ArrayList;\nimport java.util.Deque;\nimport java.util.List;\nimport org.junit.rules.TestRule;\nimport org.junit.runner.Description;\nimport org.junit.runners.model.Statement;\n\n/** A test {@link Observer} and JUnit rule which guarantees all events are asserted. */\nfinal class RecordingObserver implements Observer {\n private final Deque> events = new ArrayDeque<>();\n\n private RecordingObserver() {}\n\n @Override\n public void onSubscribe(Disposable disposable) {}\n\n @Override\n public void onNext(T value) {\n events.add(Notification.createOnNext(value));\n }\n\n @Override\n public void onComplete() {\n events.add(Notification.createOnComplete());\n }\n\n @Override\n public void onError(Throwable e) {\n events.add(Notification.createOnError(e));\n }\n\n private Notification takeNotification() {\n Notification notification = events.pollFirst();\n if (notification == null) {\n throw new AssertionError(\"No event found!\");\n }\n return notification;\n }\n\n public T takeValue() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onNext event but was \" + notification)\n .that(notification.isOnNext())\n .isTrue();\n return notification.getValue();\n }\n\n public Throwable takeError() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onError event but was \" + notification)\n .that(notification.isOnError())\n .isTrue();\n return notification.getError();\n }\n\n public RecordingObserver assertAnyValue() {\n takeValue();\n return this;\n }\n\n public RecordingObserver assertValue(T value) {\n assertThat(takeValue()).isEqualTo(value);\n return this;\n }\n\n public void assertComplete() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onCompleted event but was \" + notification)\n .that(notification.isOnComplete())\n .isTrue();\n assertNoEvents();\n }\n\n public void assertError(Throwable throwable) {\n assertThat(takeError()).isEqualTo(throwable);\n }\n\n public void assertError(Class errorClass) {\n assertError(errorClass, null);\n }\n\n public void assertError(Class errorClass, String message) {\n Throwable throwable = takeError();\n assertThat(throwable).isInstanceOf(errorClass);\n if (message != null) {\n assertThat(throwable).hasMessageThat().isEqualTo(message);\n }\n assertNoEvents();\n }\n\n public void assertNoEvents() {\n assertWithMessage(\"Unconsumed events found!\").that(events).isEmpty();\n }\n\n public static final class Rule implements TestRule {\n final List> subscribers = new ArrayList<>();\n\n public RecordingObserver create() {\n RecordingObserver subscriber = new RecordingObserver<>();\n subscribers.add(subscriber);\n return subscriber;\n }\n\n @Override\n public Statement apply(final Statement base, Description description) {\n return new Statement() {\n @Override\n public void evaluate() throws Throwable {\n base.evaluate();\n for (RecordingObserver subscriber : subscribers) {\n subscriber.assertNoEvents();\n }\n }\n };\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/RecordingSingleObserver.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static com.google.common.truth.Truth.assertWithMessage;\n\nimport io.reactivex.Notification;\nimport io.reactivex.Observer;\nimport io.reactivex.SingleObserver;\nimport io.reactivex.disposables.Disposable;\nimport java.util.ArrayDeque;\nimport java.util.ArrayList;\nimport java.util.Deque;\nimport java.util.List;\nimport org.junit.rules.TestRule;\nimport org.junit.runner.Description;\nimport org.junit.runners.model.Statement;\n\n/** A test {@link Observer} and JUnit rule which guarantees all events are asserted. */\nfinal class RecordingSingleObserver implements SingleObserver {\n private final Deque> events = new ArrayDeque<>();\n\n private RecordingSingleObserver() {}\n\n @Override\n public void onSubscribe(Disposable disposable) {}\n\n @Override\n public void onSuccess(T value) {\n events.add(Notification.createOnNext(value));\n }\n\n @Override\n public void onError(Throwable e) {\n events.add(Notification.createOnError(e));\n }\n\n private Notification takeNotification() {\n Notification notification = events.pollFirst();\n if (notification == null) {\n throw new AssertionError(\"No event found!\");\n }\n return notification;\n }\n\n public T takeValue() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onNext event but was \" + notification)\n .that(notification.isOnNext())\n .isTrue();\n return notification.getValue();\n }\n\n public Throwable takeError() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onError event but was \" + notification)\n .that(notification.isOnError())\n .isTrue();\n return notification.getError();\n }\n\n public RecordingSingleObserver assertAnyValue() {\n takeValue();\n return this;\n }\n\n public RecordingSingleObserver assertValue(T value) {\n assertThat(takeValue()).isEqualTo(value);\n return this;\n }\n\n public void assertError(Throwable throwable) {\n assertThat(takeError()).isEqualTo(throwable);\n }\n\n public void assertError(Class errorClass) {\n assertError(errorClass, null);\n }\n\n public void assertError(Class errorClass, String message) {\n Throwable throwable = takeError();\n assertThat(throwable).isInstanceOf(errorClass);\n if (message != null) {\n assertThat(throwable).hasMessageThat().isEqualTo(message);\n }\n assertNoEvents();\n }\n\n public void assertNoEvents() {\n assertWithMessage(\"Unconsumed events found!\").that(events).isEmpty();\n }\n\n public static final class Rule implements TestRule {\n final List> subscribers = new ArrayList<>();\n\n public RecordingSingleObserver create() {\n RecordingSingleObserver subscriber = new RecordingSingleObserver<>();\n subscribers.add(subscriber);\n return subscriber;\n }\n\n @Override\n public Statement apply(final Statement base, Description description) {\n return new Statement() {\n @Override\n public void evaluate() throws Throwable {\n base.evaluate();\n for (RecordingSingleObserver subscriber : subscribers) {\n subscriber.assertNoEvents();\n }\n }\n };\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/RecordingSubscriber.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static com.google.common.truth.Truth.assertWithMessage;\n\nimport io.reactivex.Notification;\nimport java.util.ArrayDeque;\nimport java.util.ArrayList;\nimport java.util.Deque;\nimport java.util.List;\nimport org.junit.rules.TestRule;\nimport org.junit.runner.Description;\nimport org.junit.runners.model.Statement;\nimport org.reactivestreams.Subscriber;\nimport org.reactivestreams.Subscription;\n\n/** A test {@link Subscriber} and JUnit rule which guarantees all events are asserted. */\nfinal class RecordingSubscriber implements Subscriber {\n private final long initialRequest;\n private final Deque> events = new ArrayDeque<>();\n\n private Subscription subscription;\n\n private RecordingSubscriber(long initialRequest) {\n this.initialRequest = initialRequest;\n }\n\n @Override\n public void onSubscribe(Subscription subscription) {\n this.subscription = subscription;\n\n subscription.request(initialRequest);\n }\n\n @Override\n public void onNext(T value) {\n events.add(Notification.createOnNext(value));\n }\n\n @Override\n public void onComplete() {\n events.add(Notification.createOnComplete());\n }\n\n @Override\n public void onError(Throwable e) {\n events.add(Notification.createOnError(e));\n }\n\n private Notification takeNotification() {\n Notification notification = events.pollFirst();\n if (notification == null) {\n throw new AssertionError(\"No event found!\");\n }\n return notification;\n }\n\n public T takeValue() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onNext event but was \" + notification)\n .that(notification.isOnNext())\n .isTrue();\n return notification.getValue();\n }\n\n public Throwable takeError() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onError event but was \" + notification)\n .that(notification.isOnError())\n .isTrue();\n return notification.getError();\n }\n\n public RecordingSubscriber assertAnyValue() {\n takeValue();\n return this;\n }\n\n public RecordingSubscriber assertValue(T value) {\n assertThat(takeValue()).isEqualTo(value);\n return this;\n }\n\n public void assertComplete() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onCompleted event but was \" + notification)\n .that(notification.isOnComplete())\n .isTrue();\n assertNoEvents();\n }\n\n public void assertError(Throwable throwable) {\n assertThat(takeError()).isEqualTo(throwable);\n }\n\n public void assertError(Class errorClass) {\n assertError(errorClass, null);\n }\n\n public void assertError(Class errorClass, String message) {\n Throwable throwable = takeError();\n assertThat(throwable).isInstanceOf(errorClass);\n if (message != null) {\n assertThat(throwable).hasMessageThat().isEqualTo(message);\n }\n assertNoEvents();\n }\n\n public void assertNoEvents() {\n assertWithMessage(\"Unconsumed events found!\").that(events).isEmpty();\n }\n\n public void request(long amount) {\n if (subscription == null) {\n throw new IllegalStateException(\"onSubscribe has not been called yet. Did you subscribe()?\");\n }\n subscription.request(amount);\n }\n\n public static final class Rule implements TestRule {\n final List> subscribers = new ArrayList<>();\n\n public RecordingSubscriber create() {\n return createWithInitialRequest(Long.MAX_VALUE);\n }\n\n public RecordingSubscriber createWithInitialRequest(long initialRequest) {\n RecordingSubscriber subscriber = new RecordingSubscriber<>(initialRequest);\n subscribers.add(subscriber);\n return subscriber;\n }\n\n @Override\n public Statement apply(final Statement base, Description description) {\n return new Statement() {\n @Override\n public void evaluate() throws Throwable {\n base.evaluate();\n for (RecordingSubscriber subscriber : subscribers) {\n subscriber.assertNoEvents();\n }\n }\n };\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/ResultTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport java.io.IOException;\nimport org.junit.Test;\nimport retrofit2.Response;\n\npublic final class ResultTest {\n @Test\n public void response() {\n Response response = Response.success(\"Hi\");\n Result result = Result.response(response);\n assertThat(result.isError()).isFalse();\n assertThat(result.error()).isNull();\n assertThat(result.response()).isSameInstanceAs(response);\n }\n\n @Test\n public void nullResponseThrows() {\n try {\n Result.response(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"response == null\");\n }\n }\n\n @Test\n public void error() {\n Throwable error = new IOException();\n Result result = Result.error(error);\n assertThat(result.isError()).isTrue();\n assertThat(result.error()).isSameInstanceAs(error);\n assertThat(result.response()).isNull();\n }\n\n @Test\n public void nullErrorThrows() {\n try {\n Result.error(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"error == null\");\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/RxJava2CallAdapterFactoryTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport com.google.common.reflect.TypeToken;\nimport io.reactivex.Flowable;\nimport io.reactivex.Maybe;\nimport io.reactivex.Observable;\nimport io.reactivex.Single;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport java.util.List;\nimport org.junit.Before;\nimport org.junit.Test;\nimport retrofit2.CallAdapter;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\n\npublic class RxJava2CallAdapterFactoryTest {\n private static final Annotation[] NO_ANNOTATIONS = new Annotation[0];\n\n private final CallAdapter.Factory factory = RxJava2CallAdapterFactory.create();\n private Retrofit retrofit;\n\n @Before\n public void setUp() {\n retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://localhost:1\")\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(factory)\n .build();\n }\n\n @Test\n public void nullSchedulerThrows() {\n try {\n RxJava2CallAdapterFactory.createWithScheduler(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"scheduler == null\");\n }\n }\n\n @Test\n public void nonRxJavaTypeReturnsNull() {\n CallAdapter adapter = factory.get(String.class, NO_ANNOTATIONS, retrofit);\n assertThat(adapter).isNull();\n }\n\n @Test\n public void responseTypes() {\n Type oBodyClass = new TypeToken>() {}.getType();\n assertThat(factory.get(oBodyClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sBodyClass = new TypeToken>() {}.getType();\n assertThat(factory.get(sBodyClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type mBodyClass = new TypeToken>() {}.getType();\n assertThat(factory.get(mBodyClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type fBodyClass = new TypeToken>() {}.getType();\n assertThat(factory.get(fBodyClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n\n Type oBodyWildcard = new TypeToken>() {}.getType();\n assertThat(factory.get(oBodyWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sBodyWildcard = new TypeToken>() {}.getType();\n assertThat(factory.get(sBodyWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type mBodyWildcard = new TypeToken>() {}.getType();\n assertThat(factory.get(mBodyWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type fBodyWildcard = new TypeToken>() {}.getType();\n assertThat(factory.get(fBodyWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n\n Type oBodyGeneric = new TypeToken>>() {}.getType();\n assertThat(factory.get(oBodyGeneric, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(new TypeToken>() {}.getType());\n Type sBodyGeneric = new TypeToken>>() {}.getType();\n assertThat(factory.get(sBodyGeneric, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(new TypeToken>() {}.getType());\n Type mBodyGeneric = new TypeToken>>() {}.getType();\n assertThat(factory.get(mBodyGeneric, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(new TypeToken>() {}.getType());\n Type fBodyGeneric = new TypeToken>>() {}.getType();\n assertThat(factory.get(fBodyGeneric, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(new TypeToken>() {}.getType());\n\n Type oResponseClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(oResponseClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sResponseClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(sResponseClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type mResponseClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(mResponseClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type fResponseClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(fResponseClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n\n Type oResponseWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(oResponseWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sResponseWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(sResponseWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type mResponseWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(mResponseWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type fResponseWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(fResponseWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n\n Type oResultClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(oResultClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sResultClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(sResultClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type mResultClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(mResultClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type fResultClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(fResultClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n\n Type oResultWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(oResultWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sResultWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(sResultWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type mResultWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(mResultWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type fResultWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(fResultWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n }\n\n @Test\n public void rawBodyTypeThrows() {\n Type observableType = new TypeToken() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Observable return type must be parameterized as Observable or Observable\");\n }\n\n Type singleType = new TypeToken() {}.getType();\n try {\n factory.get(singleType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Single return type must be parameterized as Single or Single\");\n }\n\n Type maybeType = new TypeToken() {}.getType();\n try {\n factory.get(maybeType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Maybe return type must be parameterized as Maybe or Maybe\");\n }\n\n Type flowableType = new TypeToken() {}.getType();\n try {\n factory.get(flowableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Flowable return type must be parameterized as Flowable or Flowable\");\n }\n }\n\n @Test\n public void rawResponseTypeThrows() {\n Type observableType = new TypeToken>() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Response must be parameterized as Response or Response\");\n }\n\n Type singleType = new TypeToken>() {}.getType();\n try {\n factory.get(singleType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Response must be parameterized as Response or Response\");\n }\n\n Type maybeType = new TypeToken>() {}.getType();\n try {\n factory.get(maybeType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Response must be parameterized as Response or Response\");\n }\n\n Type flowableType = new TypeToken>() {}.getType();\n try {\n factory.get(flowableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Response must be parameterized as Response or Response\");\n }\n }\n\n @Test\n public void rawResultTypeThrows() {\n Type observableType = new TypeToken>() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Result must be parameterized as Result or Result\");\n }\n\n Type singleType = new TypeToken>() {}.getType();\n try {\n factory.get(singleType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Result must be parameterized as Result or Result\");\n }\n\n Type maybeType = new TypeToken>() {}.getType();\n try {\n factory.get(maybeType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Result must be parameterized as Result or Result\");\n }\n\n Type flowableType = new TypeToken>() {}.getType();\n try {\n factory.get(flowableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Result must be parameterized as Result or Result\");\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/RxJavaPluginsResetRule.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport io.reactivex.plugins.RxJavaPlugins;\nimport org.junit.rules.TestRule;\nimport org.junit.runner.Description;\nimport org.junit.runners.model.Statement;\n\nfinal class RxJavaPluginsResetRule implements TestRule {\n @Override\n public Statement apply(final Statement base, Description description) {\n return new Statement() {\n @Override\n public void evaluate() throws Throwable {\n RxJavaPlugins.reset();\n try {\n base.evaluate();\n } finally {\n RxJavaPlugins.reset();\n }\n }\n };\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/SingleTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.Single;\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class SingleTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingSingleObserver.Rule observerRule = new RecordingSingleObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Single body();\n\n @GET(\"/\")\n Single> response();\n\n @GET(\"/\")\n Single> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava2CallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodySuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSingleObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertValue(\"Hi\");\n }\n\n @Test\n public void bodySuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSingleObserver observer = observerRule.create();\n service.body().subscribe(observer);\n // Required for backwards compatibility.\n observer.assertError(HttpException.class, \"HTTP 404 Client Error\");\n }\n\n @Test\n public void bodyFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSingleObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void responseSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSingleObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n Response response = observer.takeValue();\n assertThat(response.isSuccessful()).isTrue();\n }\n\n @Test\n public void responseSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSingleObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n assertThat(observer.takeValue().isSuccessful()).isFalse();\n }\n\n @Test\n public void responseFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSingleObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void resultSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSingleObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isTrue();\n }\n\n @Test\n public void resultSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSingleObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isFalse();\n }\n\n @Test\n public void resultFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSingleObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isTrue();\n assertThat(result.error()).isInstanceOf(IOException.class);\n }\n\n @Test\n public void subscribeTwice() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n server.enqueue(new MockResponse().setBody(\"Hey\"));\n\n Single observable = service.body();\n\n RecordingSingleObserver observer1 = observerRule.create();\n observable.subscribe(observer1);\n observer1.assertValue(\"Hi\");\n\n RecordingSingleObserver observer2 = observerRule.create();\n observable.subscribe(observer2);\n observer2.assertValue(\"Hey\");\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/SingleThrowingTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.Single;\nimport io.reactivex.SingleObserver;\nimport io.reactivex.disposables.Disposable;\nimport io.reactivex.exceptions.CompositeException;\nimport io.reactivex.exceptions.Exceptions;\nimport io.reactivex.exceptions.UndeliverableException;\nimport io.reactivex.plugins.RxJavaPlugins;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Ignore;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class SingleThrowingTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule resetRule = new RxJavaPluginsResetRule();\n\n @Rule\n public final RecordingSingleObserver.Rule subscriberRule = new RecordingSingleObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Single body();\n\n @GET(\"/\")\n Single> response();\n\n @GET(\"/\")\n Single> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava2CallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyThrowingInOnSuccessDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSingleObserver observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onSuccess(String value) {\n throw e;\n }\n });\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(UndeliverableException.class);\n assertThat(throwable).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSingleObserver observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void responseThrowingInOnSuccessDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSingleObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onSuccess(Response value) {\n throw e;\n }\n });\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(UndeliverableException.class);\n assertThat(throwable).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void responseThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSingleObserver> observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void resultThrowingInOnSuccessDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSingleObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onSuccess(Result value) {\n throw e;\n }\n });\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(UndeliverableException.class);\n assertThat(throwable).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Ignore(\"Single's contract is onNext|onError so we have no way of triggering this case\")\n @Test\n public void resultThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSingleObserver> observer = subscriberRule.create();\n final RuntimeException first = new RuntimeException();\n final RuntimeException second = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onSuccess(Result value) {\n // The only way to trigger onError for Result is if onSuccess throws.\n throw first;\n }\n\n @Override\n public void onError(Throwable throwable) {\n throw second;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(first, second);\n }\n\n private abstract static class ForwardingObserver implements SingleObserver {\n private final SingleObserver delegate;\n\n ForwardingObserver(SingleObserver delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public void onSubscribe(Disposable disposable) {\n delegate.onSubscribe(disposable);\n }\n\n @Override\n public void onSuccess(T value) {\n delegate.onSuccess(value);\n }\n\n @Override\n public void onError(Throwable throwable) {\n delegate.onError(throwable);\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/SingleWithSchedulerTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport io.reactivex.Single;\nimport io.reactivex.schedulers.TestScheduler;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class SingleWithSchedulerTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingSingleObserver.Rule observerRule = new RecordingSingleObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Single body();\n\n @GET(\"/\")\n Single> response();\n\n @GET(\"/\")\n Single> result();\n }\n\n private final TestScheduler scheduler = new TestScheduler();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava2CallAdapterFactory.createWithScheduler(scheduler))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingSingleObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue();\n }\n\n @Test\n public void responseUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingSingleObserver observer = observerRule.create();\n service.response().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue();\n }\n\n @Test\n public void resultUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingSingleObserver observer = observerRule.create();\n service.result().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava2/src/test/java/retrofit2/adapter/rxjava2/StringConverterFactory.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava2;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\nfinal class StringConverterFactory extends Converter.Factory {\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return ResponseBody::string;\n }\n\n @Override\n public Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n return value -> RequestBody.create(MediaType.get(\"text/plain\"), value);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/README.md", "content": "RxJava3 Adapter\n==============\n\nAn `Adapter` for adapting [RxJava 3.x][1] types.\n\nAvailable types:\n\n * `Observable`, `Observable>`, and `Observable>` where `T` is the body type.\n * `Flowable`, `Flowable>` and `Flowable>` where `T` is the body type.\n * `Single`, `Single>`, and `Single>` where `T` is the body type.\n * `Maybe`, `Maybe>`, and `Maybe>` where `T` is the body type.\n * `Completable` where response bodies are discarded.\n\n\nUsage\n-----\n\nAdd `RxJava3CallAdapterFactory` as a `Call` adapter when building your `Retrofit` instance:\n```java\nRetrofit retrofit = new Retrofit.Builder()\n .baseUrl(\"https://example.com/\")\n .addCallAdapterFactory(RxJava3CallAdapterFactory.create())\n .build();\n```\n\nYour service methods can now use any of the above types as their return type.\n```java\ninterface MyService {\n @GET(\"/user\")\n Observable getUser();\n}\n```\n\nBy default, `create()` will produce reactive types which execute their HTTP requests asynchronously\non a background thread. There are two other ways to control the threading on which a request\noccurs:\n\n * Use `createSynchronous()` and call `subscribeOn` on the returned reactive type with a `Scheduler`\n of your choice.\n * Use `createWithScheduler(Scheduler)` to supply a default subscription `Scheduler`.\n\nDownload\n--------\n\nDownload [the latest JAR][2] or grab via [Maven][3]:\n```xml\n\n com.squareup.retrofit2\n adapter-rxjava3\n latest.version\n\n```\nor [Gradle][3]:\n```groovy\nimplementation 'com.squareup.retrofit2:adapter-rxjava3:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n\n [1]: https://github.com/ReactiveX/RxJava/tree/3.x\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=adapter-rxjava3&v=LATEST\n [3]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22adapter-rxjava3%22\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-adapters/rxjava3/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n api libs.rxjava3\n api libs.reactiveStreams\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.guava\n testImplementation libs.okhttp.mockwebserver\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.adapter.rxjava3'\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/gradle.properties", "content": "POM_ARTIFACT_ID=adapter-rxjava3\nPOM_NAME=Adapter: RxJava 3\nPOM_DESCRIPTION=A Retrofit CallAdapter for RxJava 3's stream types.\n" }, { "path": "retrofit-adapters/rxjava3/src/main/java/retrofit2/adapter/rxjava3/BodyObservable.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport io.reactivex.rxjava3.core.Observable;\nimport io.reactivex.rxjava3.core.Observer;\nimport io.reactivex.rxjava3.disposables.Disposable;\nimport io.reactivex.rxjava3.exceptions.CompositeException;\nimport io.reactivex.rxjava3.exceptions.Exceptions;\nimport io.reactivex.rxjava3.plugins.RxJavaPlugins;\nimport retrofit2.Response;\n\nfinal class BodyObservable extends Observable {\n private final Observable> upstream;\n\n BodyObservable(Observable> upstream) {\n this.upstream = upstream;\n }\n\n @Override\n protected void subscribeActual(Observer observer) {\n upstream.subscribe(new BodyObserver<>(observer));\n }\n\n private static class BodyObserver implements Observer> {\n private final Observer observer;\n private boolean terminated;\n\n BodyObserver(Observer observer) {\n this.observer = observer;\n }\n\n @Override\n public void onSubscribe(Disposable disposable) {\n observer.onSubscribe(disposable);\n }\n\n @Override\n public void onNext(Response response) {\n if (response.isSuccessful()) {\n observer.onNext(response.body());\n } else {\n terminated = true;\n Throwable t = new HttpException(response);\n try {\n observer.onError(t);\n } catch (Throwable inner) {\n Exceptions.throwIfFatal(inner);\n RxJavaPlugins.onError(new CompositeException(t, inner));\n }\n }\n }\n\n @Override\n public void onComplete() {\n if (!terminated) {\n observer.onComplete();\n }\n }\n\n @Override\n public void onError(Throwable throwable) {\n if (!terminated) {\n observer.onError(throwable);\n } else {\n // This should never happen! onNext handles and forwards errors automatically.\n Throwable broken =\n new AssertionError(\n \"This should never happen! Report as a bug with the full stacktrace.\");\n //noinspection UnnecessaryInitCause Two-arg AssertionError constructor is 1.7+ only.\n broken.initCause(throwable);\n RxJavaPlugins.onError(broken);\n }\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/main/java/retrofit2/adapter/rxjava3/CallEnqueueObservable.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport io.reactivex.rxjava3.core.Observable;\nimport io.reactivex.rxjava3.core.Observer;\nimport io.reactivex.rxjava3.disposables.Disposable;\nimport io.reactivex.rxjava3.exceptions.CompositeException;\nimport io.reactivex.rxjava3.exceptions.Exceptions;\nimport io.reactivex.rxjava3.plugins.RxJavaPlugins;\nimport retrofit2.Call;\nimport retrofit2.Callback;\nimport retrofit2.Response;\n\nfinal class CallEnqueueObservable extends Observable> {\n private final Call originalCall;\n\n CallEnqueueObservable(Call originalCall) {\n this.originalCall = originalCall;\n }\n\n @Override\n protected void subscribeActual(Observer> observer) {\n // Since Call is a one-shot type, clone it for each new observer.\n Call call = originalCall.clone();\n CallCallback callback = new CallCallback<>(call, observer);\n observer.onSubscribe(callback);\n if (!callback.isDisposed()) {\n call.enqueue(callback);\n }\n }\n\n private static final class CallCallback implements Disposable, Callback {\n private final Call call;\n private final Observer> observer;\n private volatile boolean disposed;\n boolean terminated = false;\n\n CallCallback(Call call, Observer> observer) {\n this.call = call;\n this.observer = observer;\n }\n\n @Override\n public void onResponse(Call call, Response response) {\n if (disposed) return;\n\n try {\n observer.onNext(response);\n\n if (!disposed) {\n terminated = true;\n observer.onComplete();\n }\n } catch (Throwable t) {\n Exceptions.throwIfFatal(t);\n if (terminated) {\n RxJavaPlugins.onError(t);\n } else if (!disposed) {\n try {\n observer.onError(t);\n } catch (Throwable inner) {\n Exceptions.throwIfFatal(inner);\n RxJavaPlugins.onError(new CompositeException(t, inner));\n }\n }\n }\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n if (call.isCanceled()) return;\n\n try {\n observer.onError(t);\n } catch (Throwable inner) {\n Exceptions.throwIfFatal(inner);\n RxJavaPlugins.onError(new CompositeException(t, inner));\n }\n }\n\n @Override\n public void dispose() {\n disposed = true;\n call.cancel();\n }\n\n @Override\n public boolean isDisposed() {\n return disposed;\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/main/java/retrofit2/adapter/rxjava3/CallExecuteObservable.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport io.reactivex.rxjava3.core.Observable;\nimport io.reactivex.rxjava3.core.Observer;\nimport io.reactivex.rxjava3.disposables.Disposable;\nimport io.reactivex.rxjava3.exceptions.CompositeException;\nimport io.reactivex.rxjava3.exceptions.Exceptions;\nimport io.reactivex.rxjava3.plugins.RxJavaPlugins;\nimport retrofit2.Call;\nimport retrofit2.Response;\n\nfinal class CallExecuteObservable extends Observable> {\n private final Call originalCall;\n\n CallExecuteObservable(Call originalCall) {\n this.originalCall = originalCall;\n }\n\n @Override\n protected void subscribeActual(Observer> observer) {\n // Since Call is a one-shot type, clone it for each new observer.\n Call call = originalCall.clone();\n CallDisposable disposable = new CallDisposable(call);\n observer.onSubscribe(disposable);\n if (disposable.isDisposed()) {\n return;\n }\n\n boolean terminated = false;\n try {\n Response response = call.execute();\n if (!disposable.isDisposed()) {\n observer.onNext(response);\n }\n if (!disposable.isDisposed()) {\n terminated = true;\n observer.onComplete();\n }\n } catch (Throwable t) {\n Exceptions.throwIfFatal(t);\n if (terminated) {\n RxJavaPlugins.onError(t);\n } else if (!disposable.isDisposed()) {\n try {\n observer.onError(t);\n } catch (Throwable inner) {\n Exceptions.throwIfFatal(inner);\n RxJavaPlugins.onError(new CompositeException(t, inner));\n }\n }\n }\n }\n\n private static final class CallDisposable implements Disposable {\n private final Call call;\n private volatile boolean disposed;\n\n CallDisposable(Call call) {\n this.call = call;\n }\n\n @Override\n public void dispose() {\n disposed = true;\n call.cancel();\n }\n\n @Override\n public boolean isDisposed() {\n return disposed;\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/main/java/retrofit2/adapter/rxjava3/HttpException.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport retrofit2.Response;\n\n/** @deprecated Use {@link retrofit2.HttpException}. */\n@Deprecated\npublic final class HttpException extends retrofit2.HttpException {\n public HttpException(Response response) {\n super(response);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/main/java/retrofit2/adapter/rxjava3/Result.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport java.io.IOException;\nimport javax.annotation.Nullable;\nimport retrofit2.Response;\n\n/** The result of executing an HTTP request. */\npublic final class Result {\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static Result error(Throwable error) {\n if (error == null) throw new NullPointerException(\"error == null\");\n return new Result<>(null, error);\n }\n\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static Result response(Response response) {\n if (response == null) throw new NullPointerException(\"response == null\");\n return new Result<>(response, null);\n }\n\n private final @Nullable Response response;\n private final @Nullable Throwable error;\n\n private Result(@Nullable Response response, @Nullable Throwable error) {\n this.response = response;\n this.error = error;\n }\n\n /**\n * The response received from executing an HTTP request. Only present when {@link #isError()} is\n * false, null otherwise.\n */\n public @Nullable Response response() {\n return response;\n }\n\n /**\n * The error experienced while attempting to execute an HTTP request. Only present when {@link\n * #isError()} is true, null otherwise.\n *\n *

If the error is an {@link IOException} then there was a problem with the transport to the\n * remote server. Any other exception type indicates an unexpected failure and should be\n * considered fatal (configuration error, programming error, etc.).\n */\n public @Nullable Throwable error() {\n return error;\n }\n\n /** {@code true} if the request resulted in an error. See {@link #error()} for the cause. */\n public boolean isError() {\n return error != null;\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/main/java/retrofit2/adapter/rxjava3/ResultObservable.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport io.reactivex.rxjava3.core.Observable;\nimport io.reactivex.rxjava3.core.Observer;\nimport io.reactivex.rxjava3.disposables.Disposable;\nimport io.reactivex.rxjava3.exceptions.CompositeException;\nimport io.reactivex.rxjava3.exceptions.Exceptions;\nimport io.reactivex.rxjava3.plugins.RxJavaPlugins;\nimport retrofit2.Response;\n\nfinal class ResultObservable extends Observable> {\n private final Observable> upstream;\n\n ResultObservable(Observable> upstream) {\n this.upstream = upstream;\n }\n\n @Override\n protected void subscribeActual(Observer> observer) {\n upstream.subscribe(new ResultObserver<>(observer));\n }\n\n private static class ResultObserver implements Observer> {\n private final Observer> observer;\n\n ResultObserver(Observer> observer) {\n this.observer = observer;\n }\n\n @Override\n public void onSubscribe(Disposable disposable) {\n observer.onSubscribe(disposable);\n }\n\n @Override\n public void onNext(Response response) {\n observer.onNext(Result.response(response));\n }\n\n @Override\n public void onError(Throwable throwable) {\n try {\n observer.onNext(Result.error(throwable));\n } catch (Throwable t) {\n try {\n observer.onError(t);\n } catch (Throwable inner) {\n Exceptions.throwIfFatal(inner);\n RxJavaPlugins.onError(new CompositeException(t, inner));\n }\n return;\n }\n observer.onComplete();\n }\n\n @Override\n public void onComplete() {\n observer.onComplete();\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/main/java/retrofit2/adapter/rxjava3/RxJava3CallAdapter.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport io.reactivex.rxjava3.core.BackpressureStrategy;\nimport io.reactivex.rxjava3.core.Observable;\nimport io.reactivex.rxjava3.core.Scheduler;\nimport io.reactivex.rxjava3.plugins.RxJavaPlugins;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport retrofit2.Call;\nimport retrofit2.CallAdapter;\nimport retrofit2.Response;\n\nfinal class RxJava3CallAdapter implements CallAdapter {\n private final Type responseType;\n private final @Nullable Scheduler scheduler;\n private final boolean isAsync;\n private final boolean isResult;\n private final boolean isBody;\n private final boolean isFlowable;\n private final boolean isSingle;\n private final boolean isMaybe;\n private final boolean isCompletable;\n\n RxJava3CallAdapter(\n Type responseType,\n @Nullable Scheduler scheduler,\n boolean isAsync,\n boolean isResult,\n boolean isBody,\n boolean isFlowable,\n boolean isSingle,\n boolean isMaybe,\n boolean isCompletable) {\n this.responseType = responseType;\n this.scheduler = scheduler;\n this.isAsync = isAsync;\n this.isResult = isResult;\n this.isBody = isBody;\n this.isFlowable = isFlowable;\n this.isSingle = isSingle;\n this.isMaybe = isMaybe;\n this.isCompletable = isCompletable;\n }\n\n @Override\n public Type responseType() {\n return responseType;\n }\n\n @Override\n public Object adapt(Call call) {\n Observable> responseObservable =\n isAsync ? new CallEnqueueObservable<>(call) : new CallExecuteObservable<>(call);\n\n Observable observable;\n if (isResult) {\n observable = new ResultObservable<>(responseObservable);\n } else if (isBody) {\n observable = new BodyObservable<>(responseObservable);\n } else {\n observable = responseObservable;\n }\n\n if (scheduler != null) {\n observable = observable.subscribeOn(scheduler);\n }\n\n if (isFlowable) {\n // We only ever deliver a single value, and the RS spec states that you MUST request at least\n // one element which means we never need to honor backpressure.\n return observable.toFlowable(BackpressureStrategy.MISSING);\n }\n if (isSingle) {\n return observable.singleOrError();\n }\n if (isMaybe) {\n return observable.singleElement();\n }\n if (isCompletable) {\n return observable.ignoreElements();\n }\n return RxJavaPlugins.onAssembly(observable);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/main/java/retrofit2/adapter/rxjava3/RxJava3CallAdapterFactory.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport io.reactivex.rxjava3.core.Completable;\nimport io.reactivex.rxjava3.core.Flowable;\nimport io.reactivex.rxjava3.core.Maybe;\nimport io.reactivex.rxjava3.core.Observable;\nimport io.reactivex.rxjava3.core.Scheduler;\nimport io.reactivex.rxjava3.core.Single;\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport retrofit2.CallAdapter;\nimport retrofit2.HttpException;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\n\n/**\n * A {@linkplain CallAdapter.Factory call adapter} which uses RxJava 3 for creating observables.\n *\n *

Adding this class to {@link Retrofit} allows you to return an {@link Observable}, {@link\n * Flowable}, {@link Single}, {@link Completable} or {@link Maybe} from service methods.\n *\n * 

\n * interface MyService {\n *   @GET(\"user/me\")\n *   Observable<User> getUser()\n * }\n *
\n *\n * There are three configurations supported for the {@code Observable}, {@code Flowable}, {@code\n * Single}, {@link Completable} and {@code Maybe} type parameter:\n *\n *
    \n *
  • Direct body (e.g., {@code Observable}) calls {@code onNext} with the deserialized\n * body for 2XX responses and calls {@code onError} with {@link HttpException} for non-2XX\n * responses and {@link IOException} for network errors.\n *
  • Response wrapped body (e.g., {@code Observable>}) calls {@code onNext} with\n * a {@link Response} object for all HTTP responses and calls {@code onError} with {@link\n * IOException} for network errors\n *
  • Result wrapped body (e.g., {@code Observable>}) calls {@code onNext} with a\n * {@link Result} object for all HTTP responses and errors.\n *
\n */\npublic final class RxJava3CallAdapterFactory extends CallAdapter.Factory {\n /**\n * Returns an instance which creates asynchronous observables that run on a background thread by\n * default. Applying {@code subscribeOn(..)} has no effect on instances created by the returned\n * factory.\n */\n public static RxJava3CallAdapterFactory create() {\n return new RxJava3CallAdapterFactory(null, true);\n }\n\n /**\n * Returns an instance which creates synchronous observables that do not operate on any scheduler\n * by default. Applying {@code subscribeOn(..)} will change the scheduler on which the HTTP calls\n * are made.\n */\n public static RxJava3CallAdapterFactory createSynchronous() {\n return new RxJava3CallAdapterFactory(null, false);\n }\n\n /**\n * Returns an instance which creates synchronous observables that {@code subscribeOn(..)} the\n * supplied {@code scheduler} by default.\n */\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static RxJava3CallAdapterFactory createWithScheduler(Scheduler scheduler) {\n if (scheduler == null) throw new NullPointerException(\"scheduler == null\");\n return new RxJava3CallAdapterFactory(scheduler, false);\n }\n\n private final @Nullable Scheduler scheduler;\n private final boolean isAsync;\n\n private RxJava3CallAdapterFactory(@Nullable Scheduler scheduler, boolean isAsync) {\n this.scheduler = scheduler;\n this.isAsync = isAsync;\n }\n\n @Override\n public @Nullable CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n Class rawType = getRawType(returnType);\n\n if (rawType == Completable.class) {\n // Completable is not parameterized (which is what the rest of this method deals with) so it\n // can only be created with a single configuration.\n return new RxJava3CallAdapter(\n Void.class, scheduler, isAsync, false, true, false, false, false, true);\n }\n\n boolean isFlowable = rawType == Flowable.class;\n boolean isSingle = rawType == Single.class;\n boolean isMaybe = rawType == Maybe.class;\n if (rawType != Observable.class && !isFlowable && !isSingle && !isMaybe) {\n return null;\n }\n\n boolean isResult = false;\n boolean isBody = false;\n Type responseType;\n if (!(returnType instanceof ParameterizedType)) {\n String name =\n isFlowable ? \"Flowable\" : isSingle ? \"Single\" : isMaybe ? \"Maybe\" : \"Observable\";\n throw new IllegalStateException(\n name\n + \" return type must be parameterized\"\n + \" as \"\n + name\n + \" or \"\n + name\n + \"\");\n }\n\n Type observableType = getParameterUpperBound(0, (ParameterizedType) returnType);\n Class rawObservableType = getRawType(observableType);\n if (rawObservableType == Response.class) {\n if (!(observableType instanceof ParameterizedType)) {\n throw new IllegalStateException(\n \"Response must be parameterized\" + \" as Response or Response\");\n }\n responseType = getParameterUpperBound(0, (ParameterizedType) observableType);\n } else if (rawObservableType == Result.class) {\n if (!(observableType instanceof ParameterizedType)) {\n throw new IllegalStateException(\n \"Result must be parameterized\" + \" as Result or Result\");\n }\n responseType = getParameterUpperBound(0, (ParameterizedType) observableType);\n isResult = true;\n } else {\n responseType = observableType;\n isBody = true;\n }\n\n return new RxJava3CallAdapter(\n responseType, scheduler, isAsync, isResult, isBody, isFlowable, isSingle, isMaybe, false);\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/main/java/retrofit2/adapter/rxjava3/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.adapter.rxjava3;\n" }, { "path": "retrofit-adapters/rxjava3/src/main/resources/META-INF/proguard/retrofit2-rxjava3-adapter.pro", "content": "# Keep generic signature of RxJava3 (R8 full mode strips signatures from non-kept items).\n# It's necessary to add the explicit rule for Result as it could be used as a nested return type like `Observable>`\n-keep,allowoptimization,allowshrinking,allowobfuscation class retrofit2.adapter.rxjava3.Result\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/AsyncTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static java.util.concurrent.TimeUnit.SECONDS;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\nimport static org.junit.Assert.assertEquals;\nimport static org.junit.Assert.assertFalse;\nimport static org.junit.Assert.assertSame;\nimport static org.junit.Assert.assertTrue;\n\nimport io.reactivex.rxjava3.core.Completable;\nimport io.reactivex.rxjava3.exceptions.CompositeException;\nimport io.reactivex.rxjava3.exceptions.Exceptions;\nimport io.reactivex.rxjava3.observers.TestObserver;\nimport io.reactivex.rxjava3.plugins.RxJavaPlugins;\nimport java.io.IOException;\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.concurrent.CountDownLatch;\nimport java.util.concurrent.ExecutorService;\nimport java.util.concurrent.Executors;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.Dispatcher;\nimport okhttp3.OkHttpClient;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.After;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Retrofit;\nimport retrofit2.adapter.rxjava3.CompletableThrowingTest.ForwardingCompletableObserver;\nimport retrofit2.http.GET;\n\npublic final class AsyncTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\")\n Completable completable();\n }\n\n private Service service;\n private final List uncaughtExceptions = new ArrayList<>();\n\n @Before\n public void setUp() {\n ExecutorService executorService =\n Executors.newCachedThreadPool(\n r -> {\n Thread thread = new Thread(r);\n thread.setUncaughtExceptionHandler((t, e) -> uncaughtExceptions.add(e));\n return thread;\n });\n\n OkHttpClient client =\n new OkHttpClient.Builder().dispatcher(new Dispatcher(executorService)).build();\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .client(client)\n .addCallAdapterFactory(RxJava3CallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @After\n public void tearDown() {\n assertTrue(\"Uncaught exceptions: \" + uncaughtExceptions, uncaughtExceptions.isEmpty());\n }\n\n @Test\n public void success() throws InterruptedException {\n TestObserver observer = new TestObserver<>();\n service.completable().subscribe(observer);\n assertFalse(observer.await(1, SECONDS));\n\n server.enqueue(new MockResponse());\n observer.await(1, SECONDS);\n observer.assertComplete();\n }\n\n @Test\n public void failure() throws InterruptedException {\n TestObserver observer = new TestObserver<>();\n service.completable().subscribe(observer);\n assertFalse(observer.await(1, SECONDS));\n\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n observer.await(1, SECONDS);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void throwingInOnCompleteDeliveredToPlugin() throws InterruptedException {\n server.enqueue(new MockResponse());\n\n final CountDownLatch latch = new CountDownLatch(1);\n final AtomicReference errorRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n latch.countDown();\n });\n\n TestObserver observer = new TestObserver<>();\n final RuntimeException e = new RuntimeException();\n service\n .completable()\n .subscribe(\n new ForwardingCompletableObserver(observer) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n latch.await(1, SECONDS);\n assertThat(errorRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() throws InterruptedException {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final CountDownLatch latch = new CountDownLatch(1);\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n latch.countDown();\n });\n\n TestObserver observer = new TestObserver<>();\n final RuntimeException e = new RuntimeException();\n final AtomicReference errorRef = new AtomicReference<>();\n service\n .completable()\n .subscribe(\n new ForwardingCompletableObserver(observer) {\n @Override\n public void onError(Throwable throwable) {\n errorRef.set(throwable);\n throw e;\n }\n });\n\n latch.await(1, SECONDS);\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) pluginRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void bodyThrowingFatalInOnErrorPropagates() throws InterruptedException {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final CountDownLatch latch = new CountDownLatch(1);\n\n TestObserver observer = new TestObserver<>();\n final Error e = new OutOfMemoryError(\"Not real\");\n service\n .completable()\n .subscribe(\n new ForwardingCompletableObserver(observer) {\n @Override\n public void onError(Throwable throwable) {\n throw e;\n }\n });\n\n latch.await(1, SECONDS);\n\n assertEquals(1, uncaughtExceptions.size());\n assertSame(e, uncaughtExceptions.remove(0));\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/CancelDisposeTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static org.junit.Assert.assertEquals;\nimport static org.junit.Assert.assertFalse;\nimport static org.junit.Assert.assertTrue;\n\nimport io.reactivex.rxjava3.core.Observable;\nimport io.reactivex.rxjava3.disposables.Disposable;\nimport java.util.List;\nimport okhttp3.Call;\nimport okhttp3.OkHttpClient;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class CancelDisposeTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\")\n Observable go();\n }\n\n private final OkHttpClient client = new OkHttpClient();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava3CallAdapterFactory.create())\n .callFactory(client)\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void disposeCancelsCall() {\n Disposable disposable = service.go().subscribe();\n List calls = client.dispatcher().runningCalls();\n assertEquals(1, calls.size());\n disposable.dispose();\n assertTrue(calls.get(0).isCanceled());\n }\n\n @SuppressWarnings(\"ResultOfMethodCallIgnored\")\n @Test\n public void disposeBeforeEnqueueDoesNotEnqueue() {\n service.go().test(true);\n List calls = client.dispatcher().runningCalls();\n assertEquals(0, calls.size());\n }\n\n @Test\n public void cancelDoesNotDispose() {\n Disposable disposable = service.go().subscribe();\n List calls = client.dispatcher().runningCalls();\n assertEquals(1, calls.size());\n calls.get(0).cancel();\n assertFalse(disposable.isDisposed());\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/CancelDisposeTestSync.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static org.junit.Assert.assertEquals;\n\nimport io.reactivex.rxjava3.core.Observable;\nimport okhttp3.OkHttpClient;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class CancelDisposeTestSync {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\")\n Observable go();\n }\n\n private final OkHttpClient client = new OkHttpClient();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createSynchronous())\n .callFactory(client)\n .build();\n service = retrofit.create(Service.class);\n }\n\n @SuppressWarnings(\"ResultOfMethodCallIgnored\")\n @Test\n public void disposeBeforeExecuteDoesNotEnqueue() {\n service.go().test(true);\n assertEquals(0, server.getRequestCount());\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/CompletableTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.rxjava3.core.Completable;\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class CompletableTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n @Rule\n public final RecordingCompletableObserver.Rule observerRule =\n new RecordingCompletableObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Completable completable();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createSynchronous())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void completableSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingCompletableObserver observer = observerRule.create();\n service.completable().subscribe(observer);\n observer.assertComplete();\n }\n\n @Test\n public void completableSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingCompletableObserver observer = observerRule.create();\n service.completable().subscribe(observer);\n // Required for backwards compatibility.\n observer.assertError(HttpException.class, \"HTTP 404 Client Error\");\n }\n\n @Test\n public void completableFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingCompletableObserver observer = observerRule.create();\n service.completable().subscribe(observer);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void subscribeTwice() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n server.enqueue(new MockResponse().setBody(\"Hey\"));\n\n Completable observable = service.completable();\n\n RecordingCompletableObserver observer1 = observerRule.create();\n observable.subscribe(observer1);\n observer1.assertComplete();\n\n RecordingCompletableObserver observer2 = observerRule.create();\n observable.subscribe(observer2);\n observer2.assertComplete();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/CompletableThrowingTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\n\nimport io.reactivex.rxjava3.core.Completable;\nimport io.reactivex.rxjava3.core.CompletableObserver;\nimport io.reactivex.rxjava3.disposables.Disposable;\nimport io.reactivex.rxjava3.exceptions.CompositeException;\nimport io.reactivex.rxjava3.exceptions.Exceptions;\nimport io.reactivex.rxjava3.plugins.RxJavaPlugins;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class CompletableThrowingTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule resetRule = new RxJavaPluginsResetRule();\n\n @Rule\n public final RecordingCompletableObserver.Rule observerRule =\n new RecordingCompletableObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Completable completable();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createSynchronous())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void throwingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference errorRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n });\n\n RecordingCompletableObserver observer = observerRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .completable()\n .subscribe(\n new ForwardingCompletableObserver(observer) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n assertThat(errorRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final AtomicReference pluginRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!pluginRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable); // Don't swallow secondary errors!\n }\n });\n\n RecordingCompletableObserver observer = observerRule.create();\n final RuntimeException e = new RuntimeException();\n final AtomicReference errorRef = new AtomicReference<>();\n service\n .completable()\n .subscribe(\n new ForwardingCompletableObserver(observer) {\n @Override\n public void onError(Throwable throwable) {\n errorRef.set(throwable);\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) pluginRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n abstract static class ForwardingCompletableObserver implements CompletableObserver {\n private final CompletableObserver delegate;\n\n ForwardingCompletableObserver(CompletableObserver delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public void onSubscribe(Disposable disposable) {\n delegate.onSubscribe(disposable);\n }\n\n @Override\n public void onComplete() {\n delegate.onComplete();\n }\n\n @Override\n public void onError(Throwable throwable) {\n delegate.onError(throwable);\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/CompletableWithSchedulerTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport io.reactivex.rxjava3.core.Completable;\nimport io.reactivex.rxjava3.schedulers.TestScheduler;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class CompletableWithSchedulerTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n @Rule\n public final RecordingCompletableObserver.Rule observerRule =\n new RecordingCompletableObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Completable completable();\n }\n\n private final TestScheduler scheduler = new TestScheduler();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createWithScheduler(scheduler))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void completableUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingCompletableObserver observer = observerRule.create();\n service.completable().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertComplete();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/FlowableTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.rxjava3.core.Flowable;\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class FlowableTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Flowable body();\n\n @GET(\"/\")\n Flowable> response();\n\n @GET(\"/\")\n Flowable> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createSynchronous())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodySuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().subscribe(subscriber);\n subscriber.assertValue(\"Hi\").assertComplete();\n }\n\n @Test\n public void bodySuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().subscribe(subscriber);\n // Required for backwards compatibility.\n subscriber.assertError(HttpException.class, \"HTTP 404 Client Error\");\n }\n\n @Test\n public void bodyFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().subscribe(subscriber);\n subscriber.assertError(IOException.class);\n }\n\n @Test\n public void responseSuccess200() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.response().subscribe(subscriber);\n assertThat(subscriber.takeValue().isSuccessful()).isTrue();\n subscriber.assertComplete();\n }\n\n @Test\n public void responseSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.response().subscribe(subscriber);\n assertThat(subscriber.takeValue().isSuccessful()).isFalse();\n subscriber.assertComplete();\n }\n\n @Test\n public void responseFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.response().subscribe(subscriber);\n subscriber.assertError(IOException.class);\n }\n\n @Test\n public void resultSuccess200() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.result().subscribe(subscriber);\n Result result = subscriber.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isTrue();\n subscriber.assertComplete();\n }\n\n @Test\n public void resultSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.result().subscribe(subscriber);\n Result result = subscriber.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isFalse();\n subscriber.assertComplete();\n }\n\n @Test\n public void resultFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n service.result().subscribe(subscriber);\n Result result = subscriber.takeValue();\n assertThat(result.isError()).isTrue();\n assertThat(result.error()).isInstanceOf(IOException.class);\n subscriber.assertComplete();\n }\n\n @Test\n public void subscribeTwice() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n server.enqueue(new MockResponse().setBody(\"Hey\"));\n\n Flowable observable = service.body();\n\n RecordingSubscriber subscriber1 = subscriberRule.create();\n observable.subscribe(subscriber1);\n subscriber1.assertValue(\"Hi\").assertComplete();\n\n RecordingSubscriber subscriber2 = subscriberRule.create();\n observable.subscribe(subscriber2);\n subscriber2.assertValue(\"Hey\").assertComplete();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/FlowableThrowingTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.rxjava3.core.Flowable;\nimport io.reactivex.rxjava3.exceptions.CompositeException;\nimport io.reactivex.rxjava3.exceptions.Exceptions;\nimport io.reactivex.rxjava3.plugins.RxJavaPlugins;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport org.reactivestreams.Subscriber;\nimport org.reactivestreams.Subscription;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class FlowableThrowingTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule resetRule = new RxJavaPluginsResetRule();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Flowable body();\n\n @GET(\"/\")\n Flowable> response();\n\n @GET(\"/\")\n Flowable> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createSynchronous())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber subscriber = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .safeSubscribe(\n new ForwardingSubscriber(subscriber) {\n @Override\n public void onNext(String value) {\n throw e;\n }\n });\n\n subscriber.assertError(e);\n }\n\n @Test\n public void bodyThrowingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSubscriber subscriber = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingSubscriber(subscriber) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n subscriber.assertAnyValue();\n assertThat(throwableRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSubscriber subscriber = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingSubscriber(subscriber) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void responseThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .safeSubscribe(\n new ForwardingSubscriber>(subscriber) {\n @Override\n public void onNext(Response value) {\n throw e;\n }\n });\n\n subscriber.assertError(e);\n }\n\n @Test\n public void responseThrowingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingSubscriber>(subscriber) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n subscriber.assertAnyValue();\n assertThat(throwableRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void responseThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingSubscriber>(subscriber) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void resultThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .safeSubscribe(\n new ForwardingSubscriber>(subscriber) {\n @Override\n public void onNext(Result value) {\n throw e;\n }\n });\n\n subscriber.assertError(e);\n }\n\n @Test\n public void resultThrowingInOnCompletedDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingSubscriber>(subscriber) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n subscriber.assertAnyValue();\n assertThat(throwableRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void resultThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSubscriber> subscriber = subscriberRule.create();\n final RuntimeException first = new RuntimeException();\n final RuntimeException second = new RuntimeException();\n service\n .result()\n .safeSubscribe(\n new ForwardingSubscriber>(subscriber) {\n @Override\n public void onNext(Result value) {\n // The only way to trigger onError for a result is if onNext throws.\n throw first;\n }\n\n @Override\n public void onError(Throwable throwable) {\n throw second;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(first, second);\n }\n\n private abstract static class ForwardingSubscriber implements Subscriber {\n private final Subscriber delegate;\n\n ForwardingSubscriber(Subscriber delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public void onSubscribe(Subscription subscription) {\n delegate.onSubscribe(subscription);\n }\n\n @Override\n public void onNext(T value) {\n delegate.onNext(value);\n }\n\n @Override\n public void onError(Throwable throwable) {\n delegate.onError(throwable);\n }\n\n @Override\n public void onComplete() {\n delegate.onComplete();\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/FlowableWithSchedulerTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport io.reactivex.rxjava3.core.Flowable;\nimport io.reactivex.rxjava3.schedulers.TestScheduler;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class FlowableWithSchedulerTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingSubscriber.Rule subscriberRule = new RecordingSubscriber.Rule();\n\n interface Service {\n @GET(\"/\")\n Flowable body();\n\n @GET(\"/\")\n Flowable> response();\n\n @GET(\"/\")\n Flowable> result();\n }\n\n private final TestScheduler scheduler = new TestScheduler();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createWithScheduler(scheduler))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.body().subscribe(subscriber);\n subscriber.assertNoEvents();\n\n scheduler.triggerActions();\n subscriber.assertAnyValue().assertComplete();\n }\n\n @Test\n public void responseUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.response().subscribe(subscriber);\n subscriber.assertNoEvents();\n\n scheduler.triggerActions();\n subscriber.assertAnyValue().assertComplete();\n }\n\n @Test\n public void resultUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingSubscriber subscriber = subscriberRule.create();\n service.result().subscribe(subscriber);\n subscriber.assertNoEvents();\n\n scheduler.triggerActions();\n subscriber.assertAnyValue().assertComplete();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/MaybeTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.rxjava3.core.Maybe;\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class MaybeTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingMaybeObserver.Rule observerRule = new RecordingMaybeObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Maybe body();\n\n @GET(\"/\")\n Maybe> response();\n\n @GET(\"/\")\n Maybe> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createSynchronous())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodySuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingMaybeObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertValue(\"Hi\");\n }\n\n @Test\n public void bodySuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingMaybeObserver observer = observerRule.create();\n service.body().subscribe(observer);\n // Required for backwards compatibility.\n observer.assertError(HttpException.class, \"HTTP 404 Client Error\");\n }\n\n @Test\n public void bodyFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingMaybeObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void responseSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingMaybeObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n Response response = observer.takeValue();\n assertThat(response.isSuccessful()).isTrue();\n }\n\n @Test\n public void responseSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingMaybeObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n assertThat(observer.takeValue().isSuccessful()).isFalse();\n }\n\n @Test\n public void responseFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingMaybeObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void resultSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingMaybeObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isTrue();\n }\n\n @Test\n public void resultSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingMaybeObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isFalse();\n }\n\n @Test\n public void resultFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingMaybeObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isTrue();\n assertThat(result.error()).isInstanceOf(IOException.class);\n }\n\n @Test\n public void subscribeTwice() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n server.enqueue(new MockResponse().setBody(\"Hey\"));\n\n Maybe observable = service.body();\n\n RecordingMaybeObserver observer1 = observerRule.create();\n observable.subscribe(observer1);\n observer1.assertValue(\"Hi\");\n\n RecordingMaybeObserver observer2 = observerRule.create();\n observable.subscribe(observer2);\n observer2.assertValue(\"Hey\");\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/MaybeThrowingTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.rxjava3.core.Maybe;\nimport io.reactivex.rxjava3.core.MaybeObserver;\nimport io.reactivex.rxjava3.disposables.Disposable;\nimport io.reactivex.rxjava3.exceptions.CompositeException;\nimport io.reactivex.rxjava3.exceptions.Exceptions;\nimport io.reactivex.rxjava3.plugins.RxJavaPlugins;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Ignore;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class MaybeThrowingTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule resetRule = new RxJavaPluginsResetRule();\n @Rule public final RecordingMaybeObserver.Rule subscriberRule = new RecordingMaybeObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Maybe body();\n\n @GET(\"/\")\n Maybe> response();\n\n @GET(\"/\")\n Maybe> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createSynchronous())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyThrowingInOnSuccessDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingMaybeObserver observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onSuccess(String value) {\n throw e;\n }\n });\n\n assertThat(throwableRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingMaybeObserver observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void responseThrowingInOnSuccessDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingMaybeObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onSuccess(Response value) {\n throw e;\n }\n });\n\n assertThat(throwableRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void responseThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingMaybeObserver> observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void resultThrowingInOnSuccessDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingMaybeObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onSuccess(Result value) {\n throw e;\n }\n });\n\n assertThat(throwableRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Ignore(\"Single's contract is onNext|onError so we have no way of triggering this case\")\n @Test\n public void resultThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingMaybeObserver> observer = subscriberRule.create();\n final RuntimeException first = new RuntimeException();\n final RuntimeException second = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onSuccess(Result value) {\n // The only way to trigger onError for Result is if onSuccess throws.\n throw first;\n }\n\n @Override\n public void onError(Throwable throwable) {\n throw second;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(first, second);\n }\n\n private abstract static class ForwardingObserver implements MaybeObserver {\n private final MaybeObserver delegate;\n\n ForwardingObserver(MaybeObserver delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public void onSubscribe(Disposable disposable) {\n delegate.onSubscribe(disposable);\n }\n\n @Override\n public void onSuccess(T value) {\n delegate.onSuccess(value);\n }\n\n @Override\n public void onError(Throwable throwable) {\n delegate.onError(throwable);\n }\n\n @Override\n public void onComplete() {\n delegate.onComplete();\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/MaybeWithSchedulerTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport io.reactivex.rxjava3.core.Maybe;\nimport io.reactivex.rxjava3.schedulers.TestScheduler;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class MaybeWithSchedulerTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingMaybeObserver.Rule observerRule = new RecordingMaybeObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Maybe body();\n\n @GET(\"/\")\n Maybe> response();\n\n @GET(\"/\")\n Maybe> result();\n }\n\n private final TestScheduler scheduler = new TestScheduler();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createWithScheduler(scheduler))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingMaybeObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue();\n }\n\n @Test\n public void responseUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingMaybeObserver observer = observerRule.create();\n service.response().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue();\n }\n\n @Test\n public void resultUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingMaybeObserver observer = observerRule.create();\n service.result().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/ObservableTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.rxjava3.core.Observable;\nimport io.reactivex.rxjava3.plugins.RxJavaPlugins;\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class ObservableTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingObserver.Rule observerRule = new RecordingObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Observable body();\n\n @GET(\"/\")\n Observable> response();\n\n @GET(\"/\")\n Observable> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createSynchronous())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodySuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertValue(\"Hi\").assertComplete();\n }\n\n @Test\n public void bodySuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingObserver observer = observerRule.create();\n service.body().subscribe(observer);\n // Required for backwards compatibility.\n observer.assertError(HttpException.class, \"HTTP 404 Client Error\");\n }\n\n @Test\n public void bodyFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void responseSuccess200() {\n server.enqueue(new MockResponse());\n\n RecordingObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n assertThat(observer.takeValue().isSuccessful()).isTrue();\n observer.assertComplete();\n }\n\n @Test\n public void responseSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n assertThat(observer.takeValue().isSuccessful()).isFalse();\n observer.assertComplete();\n }\n\n @Test\n public void responseFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void resultSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isTrue();\n observer.assertComplete();\n }\n\n @Test\n public void resultSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isFalse();\n observer.assertComplete();\n }\n\n @Test\n public void resultFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isTrue();\n assertThat(result.error()).isInstanceOf(IOException.class);\n observer.assertComplete();\n }\n\n @Test\n public void observableAssembly() {\n try {\n final Observable justMe = Observable.just(\"me\");\n RxJavaPlugins.setOnObservableAssembly(f -> justMe);\n assertThat(service.body()).isEqualTo(justMe);\n } finally {\n RxJavaPlugins.reset();\n }\n }\n\n @Test\n public void subscribeTwice() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n server.enqueue(new MockResponse().setBody(\"Hey\"));\n\n Observable observable = service.body();\n\n RecordingObserver observer1 = observerRule.create();\n observable.subscribe(observer1);\n observer1.assertValue(\"Hi\").assertComplete();\n\n RecordingObserver observer2 = observerRule.create();\n observable.subscribe(observer2);\n observer2.assertValue(\"Hey\").assertComplete();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/ObservableThrowingTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.rxjava3.core.Observable;\nimport io.reactivex.rxjava3.core.Observer;\nimport io.reactivex.rxjava3.disposables.Disposable;\nimport io.reactivex.rxjava3.exceptions.CompositeException;\nimport io.reactivex.rxjava3.exceptions.Exceptions;\nimport io.reactivex.rxjava3.plugins.RxJavaPlugins;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class ObservableThrowingTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule resetRule = new RxJavaPluginsResetRule();\n @Rule public final RecordingObserver.Rule subscriberRule = new RecordingObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Observable body();\n\n @GET(\"/\")\n Observable> response();\n\n @GET(\"/\")\n Observable> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createSynchronous())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingObserver observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onNext(String value) {\n throw e;\n }\n });\n\n observer.assertError(e);\n }\n\n @Test\n public void bodyThrowingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingObserver observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n observer.assertAnyValue();\n assertThat(throwableRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingObserver observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void responseThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onNext(Response value) {\n throw e;\n }\n });\n\n observer.assertError(e);\n }\n\n @Test\n public void responseThrowingInOnCompleteDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n observer.assertAnyValue();\n assertThat(throwableRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void responseThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingObserver> observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void resultThrowingInOnNextDeliveredToError() {\n server.enqueue(new MockResponse());\n\n RecordingObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onNext(Result value) {\n throw e;\n }\n });\n\n observer.assertError(e);\n }\n\n @Test\n public void resultThrowingInOnCompletedDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onComplete() {\n throw e;\n }\n });\n\n observer.assertAnyValue();\n assertThat(throwableRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void resultThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingObserver> observer = subscriberRule.create();\n final RuntimeException first = new RuntimeException();\n final RuntimeException second = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onNext(Result value) {\n // The only way to trigger onError for a result is if onNext throws.\n throw first;\n }\n\n @Override\n public void onError(Throwable throwable) {\n throw second;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(first, second);\n }\n\n private abstract static class ForwardingObserver implements Observer {\n private final Observer delegate;\n\n ForwardingObserver(Observer delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public void onSubscribe(Disposable disposable) {\n delegate.onSubscribe(disposable);\n }\n\n @Override\n public void onNext(T value) {\n delegate.onNext(value);\n }\n\n @Override\n public void onError(Throwable throwable) {\n delegate.onError(throwable);\n }\n\n @Override\n public void onComplete() {\n delegate.onComplete();\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/ObservableWithSchedulerTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport io.reactivex.rxjava3.core.Observable;\nimport io.reactivex.rxjava3.schedulers.TestScheduler;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class ObservableWithSchedulerTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingObserver.Rule observerRule = new RecordingObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Observable body();\n\n @GET(\"/\")\n Observable> response();\n\n @GET(\"/\")\n Observable> result();\n }\n\n private final TestScheduler scheduler = new TestScheduler();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createWithScheduler(scheduler))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue().assertComplete();\n }\n\n @Test\n public void responseUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingObserver observer = observerRule.create();\n service.response().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue().assertComplete();\n }\n\n @Test\n public void resultUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingObserver observer = observerRule.create();\n service.result().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue().assertComplete();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/RecordingCompletableObserver.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static com.google.common.truth.Truth.assertWithMessage;\n\nimport io.reactivex.rxjava3.core.CompletableObserver;\nimport io.reactivex.rxjava3.core.Notification;\nimport io.reactivex.rxjava3.disposables.Disposable;\nimport java.util.ArrayDeque;\nimport java.util.ArrayList;\nimport java.util.Deque;\nimport java.util.List;\nimport org.junit.rules.TestRule;\nimport org.junit.runner.Description;\nimport org.junit.runners.model.Statement;\n\n/** A test {@link CompletableObserver} and JUnit rule which guarantees all events are asserted. */\nfinal class RecordingCompletableObserver implements CompletableObserver {\n private final Deque> events = new ArrayDeque<>();\n\n private RecordingCompletableObserver() {}\n\n @Override\n public void onSubscribe(Disposable disposable) {}\n\n @Override\n public void onComplete() {\n events.add(Notification.createOnComplete());\n }\n\n @Override\n public void onError(Throwable e) {\n events.add(Notification.createOnError(e));\n }\n\n private Notification takeNotification() {\n Notification notification = events.pollFirst();\n if (notification == null) {\n throw new AssertionError(\"No event found!\");\n }\n return notification;\n }\n\n public Throwable takeError() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onError event but was \" + notification)\n .that(notification.isOnError())\n .isTrue();\n return notification.getError();\n }\n\n public void assertComplete() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onCompleted event but was \" + notification)\n .that(notification.isOnComplete())\n .isTrue();\n assertNoEvents();\n }\n\n public void assertError(Throwable throwable) {\n assertThat(takeError()).isEqualTo(throwable);\n }\n\n public void assertError(Class errorClass) {\n assertError(errorClass, null);\n }\n\n public void assertError(Class errorClass, String message) {\n Throwable throwable = takeError();\n assertThat(throwable).isInstanceOf(errorClass);\n if (message != null) {\n assertThat(throwable).hasMessageThat().isEqualTo(message);\n }\n assertNoEvents();\n }\n\n public void assertNoEvents() {\n assertWithMessage(\"Unconsumed events found!\").that(events).isEmpty();\n }\n\n public static final class Rule implements TestRule {\n final List subscribers = new ArrayList<>();\n\n public RecordingCompletableObserver create() {\n RecordingCompletableObserver subscriber = new RecordingCompletableObserver();\n subscribers.add(subscriber);\n return subscriber;\n }\n\n @Override\n public Statement apply(final Statement base, Description description) {\n return new Statement() {\n @Override\n public void evaluate() throws Throwable {\n base.evaluate();\n for (RecordingCompletableObserver subscriber : subscribers) {\n subscriber.assertNoEvents();\n }\n }\n };\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/RecordingMaybeObserver.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static com.google.common.truth.Truth.assertWithMessage;\n\nimport io.reactivex.rxjava3.core.MaybeObserver;\nimport io.reactivex.rxjava3.core.Notification;\nimport io.reactivex.rxjava3.core.Observer;\nimport io.reactivex.rxjava3.disposables.Disposable;\nimport java.util.ArrayDeque;\nimport java.util.ArrayList;\nimport java.util.Deque;\nimport java.util.List;\nimport org.junit.rules.TestRule;\nimport org.junit.runner.Description;\nimport org.junit.runners.model.Statement;\n\n/** A test {@link Observer} and JUnit rule which guarantees all events are asserted. */\nfinal class RecordingMaybeObserver implements MaybeObserver {\n private final Deque> events = new ArrayDeque<>();\n\n private RecordingMaybeObserver() {}\n\n @Override\n public void onSubscribe(Disposable disposable) {}\n\n @Override\n public void onSuccess(T value) {\n events.add(Notification.createOnNext(value));\n }\n\n @Override\n public void onError(Throwable e) {\n events.add(Notification.createOnError(e));\n }\n\n @Override\n public void onComplete() {\n events.add(Notification.createOnComplete());\n }\n\n private Notification takeNotification() {\n Notification notification = events.pollFirst();\n if (notification == null) {\n throw new AssertionError(\"No event found!\");\n }\n return notification;\n }\n\n public T takeValue() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onNext event but was \" + notification)\n .that(notification.isOnNext())\n .isTrue();\n return notification.getValue();\n }\n\n public Throwable takeError() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onError event but was \" + notification)\n .that(notification.isOnError())\n .isTrue();\n return notification.getError();\n }\n\n public RecordingMaybeObserver assertAnyValue() {\n takeValue();\n return this;\n }\n\n public RecordingMaybeObserver assertValue(T value) {\n assertThat(takeValue()).isEqualTo(value);\n return this;\n }\n\n public void assertError(Throwable throwable) {\n assertThat(takeError()).isEqualTo(throwable);\n }\n\n public void assertError(Class errorClass) {\n assertError(errorClass, null);\n }\n\n public void assertError(Class errorClass, String message) {\n Throwable throwable = takeError();\n assertThat(throwable).isInstanceOf(errorClass);\n if (message != null) {\n assertThat(throwable).hasMessageThat().isEqualTo(message);\n }\n assertNoEvents();\n }\n\n public void assertNoEvents() {\n assertWithMessage(\"Unconsumed events found!\").that(events).isEmpty();\n }\n\n public static final class Rule implements TestRule {\n final List> subscribers = new ArrayList<>();\n\n public RecordingMaybeObserver create() {\n RecordingMaybeObserver subscriber = new RecordingMaybeObserver<>();\n subscribers.add(subscriber);\n return subscriber;\n }\n\n @Override\n public Statement apply(final Statement base, Description description) {\n return new Statement() {\n @Override\n public void evaluate() throws Throwable {\n base.evaluate();\n for (RecordingMaybeObserver subscriber : subscribers) {\n subscriber.assertNoEvents();\n }\n }\n };\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/RecordingObserver.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static com.google.common.truth.Truth.assertWithMessage;\n\nimport io.reactivex.rxjava3.core.Notification;\nimport io.reactivex.rxjava3.core.Observer;\nimport io.reactivex.rxjava3.disposables.Disposable;\nimport java.util.ArrayDeque;\nimport java.util.ArrayList;\nimport java.util.Deque;\nimport java.util.List;\nimport org.junit.rules.TestRule;\nimport org.junit.runner.Description;\nimport org.junit.runners.model.Statement;\n\n/** A test {@link Observer} and JUnit rule which guarantees all events are asserted. */\nfinal class RecordingObserver implements Observer {\n private final Deque> events = new ArrayDeque<>();\n\n private RecordingObserver() {}\n\n @Override\n public void onSubscribe(Disposable disposable) {}\n\n @Override\n public void onNext(T value) {\n events.add(Notification.createOnNext(value));\n }\n\n @Override\n public void onComplete() {\n events.add(Notification.createOnComplete());\n }\n\n @Override\n public void onError(Throwable e) {\n events.add(Notification.createOnError(e));\n }\n\n private Notification takeNotification() {\n Notification notification = events.pollFirst();\n if (notification == null) {\n throw new AssertionError(\"No event found!\");\n }\n return notification;\n }\n\n public T takeValue() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onNext event but was \" + notification)\n .that(notification.isOnNext())\n .isTrue();\n return notification.getValue();\n }\n\n public Throwable takeError() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onError event but was \" + notification)\n .that(notification.isOnError())\n .isTrue();\n return notification.getError();\n }\n\n public RecordingObserver assertAnyValue() {\n takeValue();\n return this;\n }\n\n public RecordingObserver assertValue(T value) {\n assertThat(takeValue()).isEqualTo(value);\n return this;\n }\n\n public void assertComplete() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onCompleted event but was \" + notification)\n .that(notification.isOnComplete())\n .isTrue();\n assertNoEvents();\n }\n\n public void assertError(Throwable throwable) {\n assertThat(takeError()).isEqualTo(throwable);\n }\n\n public void assertError(Class errorClass) {\n assertError(errorClass, null);\n }\n\n public void assertError(Class errorClass, String message) {\n Throwable throwable = takeError();\n assertThat(throwable).isInstanceOf(errorClass);\n if (message != null) {\n assertThat(throwable).hasMessageThat().isEqualTo(message);\n }\n assertNoEvents();\n }\n\n public void assertNoEvents() {\n assertWithMessage(\"Unconsumed events found!\").that(events).isEmpty();\n }\n\n public static final class Rule implements TestRule {\n final List> subscribers = new ArrayList<>();\n\n public RecordingObserver create() {\n RecordingObserver subscriber = new RecordingObserver<>();\n subscribers.add(subscriber);\n return subscriber;\n }\n\n @Override\n public Statement apply(final Statement base, Description description) {\n return new Statement() {\n @Override\n public void evaluate() throws Throwable {\n base.evaluate();\n for (RecordingObserver subscriber : subscribers) {\n subscriber.assertNoEvents();\n }\n }\n };\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/RecordingSingleObserver.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static com.google.common.truth.Truth.assertWithMessage;\n\nimport io.reactivex.rxjava3.core.Notification;\nimport io.reactivex.rxjava3.core.Observer;\nimport io.reactivex.rxjava3.core.SingleObserver;\nimport io.reactivex.rxjava3.disposables.Disposable;\nimport java.util.ArrayDeque;\nimport java.util.ArrayList;\nimport java.util.Deque;\nimport java.util.List;\nimport org.junit.rules.TestRule;\nimport org.junit.runner.Description;\nimport org.junit.runners.model.Statement;\n\n/** A test {@link Observer} and JUnit rule which guarantees all events are asserted. */\nfinal class RecordingSingleObserver implements SingleObserver {\n private final Deque> events = new ArrayDeque<>();\n\n private RecordingSingleObserver() {}\n\n @Override\n public void onSubscribe(Disposable disposable) {}\n\n @Override\n public void onSuccess(T value) {\n events.add(Notification.createOnNext(value));\n }\n\n @Override\n public void onError(Throwable e) {\n events.add(Notification.createOnError(e));\n }\n\n private Notification takeNotification() {\n Notification notification = events.pollFirst();\n if (notification == null) {\n throw new AssertionError(\"No event found!\");\n }\n return notification;\n }\n\n public T takeValue() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onNext event but was \" + notification)\n .that(notification.isOnNext())\n .isTrue();\n return notification.getValue();\n }\n\n public Throwable takeError() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onError event but was \" + notification)\n .that(notification.isOnError())\n .isTrue();\n return notification.getError();\n }\n\n public RecordingSingleObserver assertAnyValue() {\n takeValue();\n return this;\n }\n\n public RecordingSingleObserver assertValue(T value) {\n assertThat(takeValue()).isEqualTo(value);\n return this;\n }\n\n public void assertError(Throwable throwable) {\n assertThat(takeError()).isEqualTo(throwable);\n }\n\n public void assertError(Class errorClass) {\n assertError(errorClass, null);\n }\n\n public void assertError(Class errorClass, String message) {\n Throwable throwable = takeError();\n assertThat(throwable).isInstanceOf(errorClass);\n if (message != null) {\n assertThat(throwable).hasMessageThat().isEqualTo(message);\n }\n assertNoEvents();\n }\n\n public void assertNoEvents() {\n assertWithMessage(\"Unconsumed events found!\").that(events).isEmpty();\n }\n\n public static final class Rule implements TestRule {\n final List> subscribers = new ArrayList<>();\n\n public RecordingSingleObserver create() {\n RecordingSingleObserver subscriber = new RecordingSingleObserver<>();\n subscribers.add(subscriber);\n return subscriber;\n }\n\n @Override\n public Statement apply(final Statement base, Description description) {\n return new Statement() {\n @Override\n public void evaluate() throws Throwable {\n base.evaluate();\n for (RecordingSingleObserver subscriber : subscribers) {\n subscriber.assertNoEvents();\n }\n }\n };\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/RecordingSubscriber.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static com.google.common.truth.Truth.assertWithMessage;\n\nimport io.reactivex.rxjava3.core.FlowableSubscriber;\nimport io.reactivex.rxjava3.core.Notification;\nimport java.util.ArrayDeque;\nimport java.util.ArrayList;\nimport java.util.Deque;\nimport java.util.List;\nimport org.junit.rules.TestRule;\nimport org.junit.runner.Description;\nimport org.junit.runners.model.Statement;\nimport org.reactivestreams.Subscriber;\nimport org.reactivestreams.Subscription;\n\n/** A test {@link Subscriber} and JUnit rule which guarantees all events are asserted. */\nfinal class RecordingSubscriber implements FlowableSubscriber {\n private final long initialRequest;\n private final Deque> events = new ArrayDeque<>();\n\n private Subscription subscription;\n\n private RecordingSubscriber(long initialRequest) {\n this.initialRequest = initialRequest;\n }\n\n @Override\n public void onSubscribe(Subscription subscription) {\n this.subscription = subscription;\n\n subscription.request(initialRequest);\n }\n\n @Override\n public void onNext(T value) {\n events.add(Notification.createOnNext(value));\n }\n\n @Override\n public void onComplete() {\n events.add(Notification.createOnComplete());\n }\n\n @Override\n public void onError(Throwable e) {\n events.add(Notification.createOnError(e));\n }\n\n private Notification takeNotification() {\n Notification notification = events.pollFirst();\n if (notification == null) {\n throw new AssertionError(\"No event found!\");\n }\n return notification;\n }\n\n public T takeValue() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onNext event but was \" + notification)\n .that(notification.isOnNext())\n .isTrue();\n return notification.getValue();\n }\n\n public Throwable takeError() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onError event but was \" + notification)\n .that(notification.isOnError())\n .isTrue();\n return notification.getError();\n }\n\n public RecordingSubscriber assertAnyValue() {\n takeValue();\n return this;\n }\n\n public RecordingSubscriber assertValue(T value) {\n assertThat(takeValue()).isEqualTo(value);\n return this;\n }\n\n public void assertComplete() {\n Notification notification = takeNotification();\n assertWithMessage(\"Expected onCompleted event but was \" + notification)\n .that(notification.isOnComplete())\n .isTrue();\n assertNoEvents();\n }\n\n public void assertError(Throwable throwable) {\n assertThat(takeError()).isEqualTo(throwable);\n }\n\n public void assertError(Class errorClass) {\n assertError(errorClass, null);\n }\n\n public void assertError(Class errorClass, String message) {\n Throwable throwable = takeError();\n assertThat(throwable).isInstanceOf(errorClass);\n if (message != null) {\n assertThat(throwable).hasMessageThat().isEqualTo(message);\n }\n assertNoEvents();\n }\n\n public void assertNoEvents() {\n assertWithMessage(\"Unconsumed events found!\").that(events).isEmpty();\n }\n\n public void request(long amount) {\n if (subscription == null) {\n throw new IllegalStateException(\"onSubscribe has not been called yet. Did you subscribe()?\");\n }\n subscription.request(amount);\n }\n\n public static final class Rule implements TestRule {\n final List> subscribers = new ArrayList<>();\n\n public RecordingSubscriber create() {\n return createWithInitialRequest(Long.MAX_VALUE);\n }\n\n public RecordingSubscriber createWithInitialRequest(long initialRequest) {\n RecordingSubscriber subscriber = new RecordingSubscriber<>(initialRequest);\n subscribers.add(subscriber);\n return subscriber;\n }\n\n @Override\n public Statement apply(final Statement base, Description description) {\n return new Statement() {\n @Override\n public void evaluate() throws Throwable {\n base.evaluate();\n for (RecordingSubscriber subscriber : subscribers) {\n subscriber.assertNoEvents();\n }\n }\n };\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/ResultTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport java.io.IOException;\nimport org.junit.Test;\nimport retrofit2.Response;\n\npublic final class ResultTest {\n @Test\n public void response() {\n Response response = Response.success(\"Hi\");\n Result result = Result.response(response);\n assertThat(result.isError()).isFalse();\n assertThat(result.error()).isNull();\n assertThat(result.response()).isSameInstanceAs(response);\n }\n\n @Test\n public void nullResponseThrows() {\n try {\n Result.response(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"response == null\");\n }\n }\n\n @Test\n public void error() {\n Throwable error = new IOException();\n Result result = Result.error(error);\n assertThat(result.isError()).isTrue();\n assertThat(result.error()).isSameInstanceAs(error);\n assertThat(result.response()).isNull();\n }\n\n @Test\n public void nullErrorThrows() {\n try {\n Result.error(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"error == null\");\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/RxJava3CallAdapterFactoryTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport com.google.common.reflect.TypeToken;\nimport io.reactivex.rxjava3.core.Flowable;\nimport io.reactivex.rxjava3.core.Maybe;\nimport io.reactivex.rxjava3.core.Observable;\nimport io.reactivex.rxjava3.core.Single;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport java.util.List;\nimport org.junit.Before;\nimport org.junit.Test;\nimport retrofit2.CallAdapter;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\n\npublic class RxJava3CallAdapterFactoryTest {\n private static final Annotation[] NO_ANNOTATIONS = new Annotation[0];\n\n private final CallAdapter.Factory factory = RxJava3CallAdapterFactory.createSynchronous();\n private Retrofit retrofit;\n\n @Before\n public void setUp() {\n retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://localhost:1\")\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(factory)\n .build();\n }\n\n @Test\n public void nullSchedulerThrows() {\n try {\n RxJava3CallAdapterFactory.createWithScheduler(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"scheduler == null\");\n }\n }\n\n @Test\n public void nonRxJavaTypeReturnsNull() {\n CallAdapter adapter = factory.get(String.class, NO_ANNOTATIONS, retrofit);\n assertThat(adapter).isNull();\n }\n\n @Test\n public void responseTypes() {\n Type oBodyClass = new TypeToken>() {}.getType();\n assertThat(factory.get(oBodyClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sBodyClass = new TypeToken>() {}.getType();\n assertThat(factory.get(sBodyClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type mBodyClass = new TypeToken>() {}.getType();\n assertThat(factory.get(mBodyClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type fBodyClass = new TypeToken>() {}.getType();\n assertThat(factory.get(fBodyClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n\n Type oBodyWildcard = new TypeToken>() {}.getType();\n assertThat(factory.get(oBodyWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sBodyWildcard = new TypeToken>() {}.getType();\n assertThat(factory.get(sBodyWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type mBodyWildcard = new TypeToken>() {}.getType();\n assertThat(factory.get(mBodyWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type fBodyWildcard = new TypeToken>() {}.getType();\n assertThat(factory.get(fBodyWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n\n Type oBodyGeneric = new TypeToken>>() {}.getType();\n assertThat(factory.get(oBodyGeneric, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(new TypeToken>() {}.getType());\n Type sBodyGeneric = new TypeToken>>() {}.getType();\n assertThat(factory.get(sBodyGeneric, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(new TypeToken>() {}.getType());\n Type mBodyGeneric = new TypeToken>>() {}.getType();\n assertThat(factory.get(mBodyGeneric, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(new TypeToken>() {}.getType());\n Type fBodyGeneric = new TypeToken>>() {}.getType();\n assertThat(factory.get(fBodyGeneric, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(new TypeToken>() {}.getType());\n\n Type oResponseClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(oResponseClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sResponseClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(sResponseClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type mResponseClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(mResponseClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type fResponseClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(fResponseClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n\n Type oResponseWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(oResponseWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sResponseWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(sResponseWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type mResponseWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(mResponseWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type fResponseWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(fResponseWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n\n Type oResultClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(oResultClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sResultClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(sResultClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type mResultClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(mResultClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type fResultClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(fResultClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n\n Type oResultWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(oResultWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type sResultWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(sResultWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type mResultWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(mResultWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type fResultWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(fResultWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n }\n\n @Test\n public void rawBodyTypeThrows() {\n Type observableType = new TypeToken() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Observable return type must be parameterized as Observable or Observable\");\n }\n\n Type singleType = new TypeToken() {}.getType();\n try {\n factory.get(singleType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Single return type must be parameterized as Single or Single\");\n }\n\n Type maybeType = new TypeToken() {}.getType();\n try {\n factory.get(maybeType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Maybe return type must be parameterized as Maybe or Maybe\");\n }\n\n Type flowableType = new TypeToken() {}.getType();\n try {\n factory.get(flowableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Flowable return type must be parameterized as Flowable or Flowable\");\n }\n }\n\n @Test\n public void rawResponseTypeThrows() {\n Type observableType = new TypeToken>() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Response must be parameterized as Response or Response\");\n }\n\n Type singleType = new TypeToken>() {}.getType();\n try {\n factory.get(singleType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Response must be parameterized as Response or Response\");\n }\n\n Type maybeType = new TypeToken>() {}.getType();\n try {\n factory.get(maybeType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Response must be parameterized as Response or Response\");\n }\n\n Type flowableType = new TypeToken>() {}.getType();\n try {\n factory.get(flowableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Response must be parameterized as Response or Response\");\n }\n }\n\n @Test\n public void rawResultTypeThrows() {\n Type observableType = new TypeToken>() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Result must be parameterized as Result or Result\");\n }\n\n Type singleType = new TypeToken>() {}.getType();\n try {\n factory.get(singleType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Result must be parameterized as Result or Result\");\n }\n\n Type maybeType = new TypeToken>() {}.getType();\n try {\n factory.get(maybeType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Result must be parameterized as Result or Result\");\n }\n\n Type flowableType = new TypeToken>() {}.getType();\n try {\n factory.get(flowableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Result must be parameterized as Result or Result\");\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/RxJavaPluginsResetRule.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport io.reactivex.rxjava3.plugins.RxJavaPlugins;\nimport org.junit.rules.TestRule;\nimport org.junit.runner.Description;\nimport org.junit.runners.model.Statement;\n\nfinal class RxJavaPluginsResetRule implements TestRule {\n @Override\n public Statement apply(final Statement base, Description description) {\n return new Statement() {\n @Override\n public void evaluate() throws Throwable {\n RxJavaPlugins.reset();\n try {\n base.evaluate();\n } finally {\n RxJavaPlugins.reset();\n }\n }\n };\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/SingleTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.rxjava3.core.Single;\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class SingleTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingSingleObserver.Rule observerRule = new RecordingSingleObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Single body();\n\n @GET(\"/\")\n Single> response();\n\n @GET(\"/\")\n Single> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createSynchronous())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodySuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSingleObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertValue(\"Hi\");\n }\n\n @Test\n public void bodySuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSingleObserver observer = observerRule.create();\n service.body().subscribe(observer);\n // Required for backwards compatibility.\n observer.assertError(HttpException.class, \"HTTP 404 Client Error\");\n }\n\n @Test\n public void bodyFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSingleObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void responseSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSingleObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n Response response = observer.takeValue();\n assertThat(response.isSuccessful()).isTrue();\n }\n\n @Test\n public void responseSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSingleObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n assertThat(observer.takeValue().isSuccessful()).isFalse();\n }\n\n @Test\n public void responseFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSingleObserver> observer = observerRule.create();\n service.response().subscribe(observer);\n observer.assertError(IOException.class);\n }\n\n @Test\n public void resultSuccess200() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n RecordingSingleObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isTrue();\n }\n\n @Test\n public void resultSuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n RecordingSingleObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isFalse();\n assertThat(result.response().isSuccessful()).isFalse();\n }\n\n @Test\n public void resultFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n RecordingSingleObserver> observer = observerRule.create();\n service.result().subscribe(observer);\n Result result = observer.takeValue();\n assertThat(result.isError()).isTrue();\n assertThat(result.error()).isInstanceOf(IOException.class);\n }\n\n @Test\n public void subscribeTwice() {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n server.enqueue(new MockResponse().setBody(\"Hey\"));\n\n Single observable = service.body();\n\n RecordingSingleObserver observer1 = observerRule.create();\n observable.subscribe(observer1);\n observer1.assertValue(\"Hi\");\n\n RecordingSingleObserver observer2 = observerRule.create();\n observable.subscribe(observer2);\n observer2.assertValue(\"Hey\");\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/SingleThrowingTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\n\nimport io.reactivex.rxjava3.core.Single;\nimport io.reactivex.rxjava3.core.SingleObserver;\nimport io.reactivex.rxjava3.disposables.Disposable;\nimport io.reactivex.rxjava3.exceptions.CompositeException;\nimport io.reactivex.rxjava3.exceptions.Exceptions;\nimport io.reactivex.rxjava3.plugins.RxJavaPlugins;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Ignore;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.rules.TestRule;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class SingleThrowingTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final TestRule resetRule = new RxJavaPluginsResetRule();\n\n @Rule\n public final RecordingSingleObserver.Rule subscriberRule = new RecordingSingleObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Single body();\n\n @GET(\"/\")\n Single> response();\n\n @GET(\"/\")\n Single> result();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createSynchronous())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyThrowingInOnSuccessDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSingleObserver observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onSuccess(String value) {\n throw e;\n }\n });\n\n assertThat(throwableRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void bodyThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSingleObserver observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .body()\n .subscribe(\n new ForwardingObserver(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void responseThrowingInOnSuccessDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSingleObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onSuccess(Response value) {\n throw e;\n }\n });\n\n assertThat(throwableRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Test\n public void responseThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSingleObserver> observer = subscriberRule.create();\n final AtomicReference errorRef = new AtomicReference<>();\n final RuntimeException e = new RuntimeException();\n service\n .response()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onError(Throwable throwable) {\n if (!errorRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n throw e;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(errorRef.get(), e);\n }\n\n @Test\n public void resultThrowingInOnSuccessDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSingleObserver> observer = subscriberRule.create();\n final RuntimeException e = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onSuccess(Result value) {\n throw e;\n }\n });\n\n assertThat(throwableRef.get()).hasCauseThat().isSameInstanceAs(e);\n }\n\n @Ignore(\"Single's contract is onNext|onError so we have no way of triggering this case\")\n @Test\n public void resultThrowingInOnErrorDeliveredToPlugin() {\n server.enqueue(new MockResponse());\n\n final AtomicReference throwableRef = new AtomicReference<>();\n RxJavaPlugins.setErrorHandler(\n throwable -> {\n if (!throwableRef.compareAndSet(null, throwable)) {\n throw Exceptions.propagate(throwable);\n }\n });\n\n RecordingSingleObserver> observer = subscriberRule.create();\n final RuntimeException first = new RuntimeException();\n final RuntimeException second = new RuntimeException();\n service\n .result()\n .subscribe(\n new ForwardingObserver>(observer) {\n @Override\n public void onSuccess(Result value) {\n // The only way to trigger onError for Result is if onSuccess throws.\n throw first;\n }\n\n @Override\n public void onError(Throwable throwable) {\n throw second;\n }\n });\n\n //noinspection ThrowableResultOfMethodCallIgnored\n CompositeException composite = (CompositeException) throwableRef.get();\n assertThat(composite.getExceptions()).containsExactly(first, second);\n }\n\n private abstract static class ForwardingObserver implements SingleObserver {\n private final SingleObserver delegate;\n\n ForwardingObserver(SingleObserver delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public void onSubscribe(Disposable disposable) {\n delegate.onSubscribe(disposable);\n }\n\n @Override\n public void onSuccess(T value) {\n delegate.onSuccess(value);\n }\n\n @Override\n public void onError(Throwable throwable) {\n delegate.onError(throwable);\n }\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/SingleWithSchedulerTest.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport io.reactivex.rxjava3.core.Single;\nimport io.reactivex.rxjava3.schedulers.TestScheduler;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class SingleWithSchedulerTest {\n @Rule public final MockWebServer server = new MockWebServer();\n @Rule public final RecordingSingleObserver.Rule observerRule = new RecordingSingleObserver.Rule();\n\n interface Service {\n @GET(\"/\")\n Single body();\n\n @GET(\"/\")\n Single> response();\n\n @GET(\"/\")\n Single> result();\n }\n\n private final TestScheduler scheduler = new TestScheduler();\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(RxJava3CallAdapterFactory.createWithScheduler(scheduler))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingSingleObserver observer = observerRule.create();\n service.body().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue();\n }\n\n @Test\n public void responseUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingSingleObserver observer = observerRule.create();\n service.response().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue();\n }\n\n @Test\n public void resultUsesScheduler() {\n server.enqueue(new MockResponse());\n\n RecordingSingleObserver observer = observerRule.create();\n service.result().subscribe(observer);\n observer.assertNoEvents();\n\n scheduler.triggerActions();\n observer.assertAnyValue();\n }\n}\n" }, { "path": "retrofit-adapters/rxjava3/src/test/java/retrofit2/adapter/rxjava3/StringConverterFactory.java", "content": "/*\n * Copyright (C) 2020 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.rxjava3;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\nfinal class StringConverterFactory extends Converter.Factory {\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return ResponseBody::string;\n }\n\n @Override\n public Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n return value -> RequestBody.create(MediaType.get(\"text/plain\"), value);\n }\n}\n" }, { "path": "retrofit-adapters/scala/README.md", "content": "Scala Adapter\n=============\n\nAn `Adapter` for adapting Scala `Future`.\n\n\nUsage\n-----\n\nAdd `ScalaCallAdapterFactory` as a `Call` adapter when building your `Retrofit` instance:\n```java\nRetrofit retrofit = new Retrofit.Builder()\n .baseUrl(\"https://example.com/\")\n .addCallAdapterFactory(ScalaCallAdapterFactory.create())\n .build();\n```\n\nYour service methods can now use `Future` as their return type.\n```java\ninterface MyService {\n @GET(\"/user\")\n Future getUser();\n}\n```\n\n\nDownload\n--------\n\nDownload [the latest JAR][2] or grab via [Maven][3]:\n```xml\n\n com.squareup.retrofit2\n adapter-scala\n latest.version\n\n```\nor [Gradle][3]:\n```groovy\nimplementation 'com.squareup.retrofit2:adapter-scala:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=adapter-scala&v=LATEST\n [3]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22adapter-scala%22\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-adapters/scala/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n api libs.scalaLibrary\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.guava\n testImplementation libs.okhttp.mockwebserver\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.adapter.scala'\n }\n}\n" }, { "path": "retrofit-adapters/scala/gradle.properties", "content": "POM_ARTIFACT_ID=adapter-scala\nPOM_NAME=Adapter: Scala\nPOM_DESCRIPTION=A Retrofit CallAdapter for Scala's Future.\n" }, { "path": "retrofit-adapters/scala/src/main/java/retrofit2/adapter/scala/BodyCallAdapter.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.scala;\n\nimport java.lang.reflect.Type;\nimport retrofit2.Call;\nimport retrofit2.CallAdapter;\nimport retrofit2.Callback;\nimport retrofit2.HttpException;\nimport retrofit2.Response;\nimport scala.concurrent.Future;\nimport scala.concurrent.Promise;\n\nfinal class BodyCallAdapter implements CallAdapter> {\n private final Type responseType;\n\n BodyCallAdapter(Type responseType) {\n this.responseType = responseType;\n }\n\n @Override\n public Type responseType() {\n return responseType;\n }\n\n @Override\n public Future adapt(Call call) {\n Promise promise = Promise.apply();\n\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n if (response.isSuccessful()) {\n promise.success(response.body());\n } else {\n promise.failure(new HttpException(response));\n }\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n promise.failure(t);\n }\n });\n\n return promise.future();\n }\n}\n" }, { "path": "retrofit-adapters/scala/src/main/java/retrofit2/adapter/scala/ResponseCallAdapter.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.scala;\n\nimport java.lang.reflect.Type;\nimport retrofit2.Call;\nimport retrofit2.CallAdapter;\nimport retrofit2.Callback;\nimport retrofit2.Response;\nimport scala.concurrent.Future;\nimport scala.concurrent.Promise;\n\nfinal class ResponseCallAdapter implements CallAdapter>> {\n private final Type responseType;\n\n ResponseCallAdapter(Type responseType) {\n this.responseType = responseType;\n }\n\n @Override\n public Type responseType() {\n return responseType;\n }\n\n @Override\n public Future> adapt(Call call) {\n Promise> promise = Promise.apply();\n\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n promise.success(response);\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n promise.failure(t);\n }\n });\n\n return promise.future();\n }\n}\n" }, { "path": "retrofit-adapters/scala/src/main/java/retrofit2/adapter/scala/ScalaCallAdapterFactory.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.scala;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport retrofit2.CallAdapter;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport scala.concurrent.Future;\n\n/**\n * A {@linkplain CallAdapter.Factory call adapter} which creates Scala futures.\n *\n *

Adding this class to {@link Retrofit} allows you to return {@link Future} from service\n * methods.\n *\n * 

\n * interface MyService {\n *   @GET(\"user/me\")\n *   Future<User> getUser()\n * }\n *
\n *\n * There are two configurations supported for the {@code Future} type parameter:\n *\n *
    \n *
  • Direct body (e.g., {@code Future}) returns the deserialized body for 2XX responses,\n * sets {@link retrofit2.HttpException HttpException} errors for non-2XX responses, and sets\n * {@link IOException} for network errors.\n *
  • Response wrapped body (e.g., {@code Future>}) returns a {@link Response}\n * object for all HTTP responses and sets {@link IOException} for network errors\n *
\n */\npublic final class ScalaCallAdapterFactory extends CallAdapter.Factory {\n public static ScalaCallAdapterFactory create() {\n return new ScalaCallAdapterFactory();\n }\n\n private ScalaCallAdapterFactory() {}\n\n @Override\n public @Nullable CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n if (getRawType(returnType) != Future.class) {\n return null;\n }\n if (!(returnType instanceof ParameterizedType)) {\n throw new IllegalStateException(\n \"Future return type must be parameterized as Future or Future\");\n }\n Type innerType = getParameterUpperBound(0, (ParameterizedType) returnType);\n\n if (getRawType(innerType) != Response.class) {\n // Generic type is not Response. Use it for body-only adapter.\n return new BodyCallAdapter<>(innerType);\n }\n\n if (!(innerType instanceof ParameterizedType)) {\n throw new IllegalStateException(\n \"Response must be parameterized as Response or Response\");\n }\n\n Type responseType = getParameterUpperBound(0, (ParameterizedType) innerType);\n return new ResponseCallAdapter<>(responseType);\n }\n}\n" }, { "path": "retrofit-adapters/scala/src/main/java/retrofit2/adapter/scala/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.adapter.scala;\n" }, { "path": "retrofit-adapters/scala/src/test/java/retrofit2/adapter/scala/FutureTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.scala;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static java.util.concurrent.TimeUnit.SECONDS;\nimport static okhttp3.mockwebserver.SocketPolicy.DISCONNECT_AFTER_REQUEST;\nimport static org.junit.Assert.fail;\n\nimport java.io.IOException;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.HttpException;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport scala.concurrent.Await;\nimport scala.concurrent.Future;\nimport scala.concurrent.duration.Duration;\n\npublic final class FutureTest {\n @Rule public final MockWebServer server = new MockWebServer();\n\n interface Service {\n @GET(\"/\")\n Future body();\n\n @GET(\"/\")\n Future> response();\n }\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(ScalaCallAdapterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodySuccess200() throws Exception {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n Future future = service.body();\n String result = Await.result(future, Duration.create(5, SECONDS));\n assertThat(result).isEqualTo(\"Hi\");\n }\n\n @Test\n public void bodySuccess404() {\n server.enqueue(new MockResponse().setResponseCode(404));\n\n Future future = service.body();\n try {\n Await.result(future, Duration.create(5, SECONDS));\n fail();\n } catch (Exception e) {\n assertThat(e).isInstanceOf(HttpException.class); // Required for backwards compatibility.\n assertThat(e).isInstanceOf(retrofit2.HttpException.class);\n assertThat(e).hasMessageThat().isEqualTo(\"HTTP 404 Client Error\");\n }\n }\n\n @Test\n public void bodyFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n Future future = service.body();\n try {\n Await.result(future, Duration.create(5, SECONDS));\n fail();\n } catch (Exception e) {\n assertThat(e).isInstanceOf(IOException.class);\n }\n }\n\n @Test\n public void responseSuccess200() throws Exception {\n server.enqueue(new MockResponse().setBody(\"Hi\"));\n\n Future> future = service.response();\n Response response = Await.result(future, Duration.create(5, SECONDS));\n assertThat(response.isSuccessful()).isTrue();\n assertThat(response.body()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void responseSuccess404() throws Exception {\n server.enqueue(new MockResponse().setResponseCode(404).setBody(\"Hi\"));\n\n Future> future = service.response();\n Response response = Await.result(future, Duration.create(5, SECONDS));\n assertThat(response.isSuccessful()).isFalse();\n assertThat(response.errorBody().string()).isEqualTo(\"Hi\");\n }\n\n @Test\n public void responseFailure() {\n server.enqueue(new MockResponse().setSocketPolicy(DISCONNECT_AFTER_REQUEST));\n\n Future> future = service.response();\n try {\n Await.result(future, Duration.create(5, SECONDS));\n fail();\n } catch (Exception e) {\n assertThat(e).isInstanceOf(IOException.class);\n }\n }\n}\n" }, { "path": "retrofit-adapters/scala/src/test/java/retrofit2/adapter/scala/ScalaCallAdapterFactoryTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.scala;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport com.google.common.reflect.TypeToken;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport java.util.List;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.CallAdapter;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport scala.concurrent.Future;\n\npublic final class ScalaCallAdapterFactoryTest {\n private static final Annotation[] NO_ANNOTATIONS = new Annotation[0];\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private final CallAdapter.Factory factory = ScalaCallAdapterFactory.create();\n private Retrofit retrofit;\n\n @Before\n public void setUp() {\n retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new StringConverterFactory())\n .addCallAdapterFactory(factory)\n .build();\n }\n\n @Test\n public void responseType() {\n Type bodyClass = new TypeToken>() {}.getType();\n assertThat(factory.get(bodyClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type bodyWildcard = new TypeToken>() {}.getType();\n assertThat(factory.get(bodyWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type bodyGeneric = new TypeToken>>() {}.getType();\n assertThat(factory.get(bodyGeneric, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(new TypeToken>() {}.getType());\n Type responseClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(responseClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type responseWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(responseWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type resultClass = new TypeToken>>() {}.getType();\n assertThat(factory.get(resultClass, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n Type resultWildcard = new TypeToken>>() {}.getType();\n assertThat(factory.get(resultWildcard, NO_ANNOTATIONS, retrofit).responseType())\n .isEqualTo(String.class);\n }\n\n @Test\n public void nonListenableFutureReturnsNull() {\n CallAdapter adapter = factory.get(String.class, NO_ANNOTATIONS, retrofit);\n assertThat(adapter).isNull();\n }\n\n @Test\n public void rawTypeThrows() {\n Type observableType = new TypeToken() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"Future return type must be parameterized as Future or Future\");\n }\n }\n\n @Test\n public void rawResponseTypeThrows() {\n Type observableType = new TypeToken>() {}.getType();\n try {\n factory.get(observableType, NO_ANNOTATIONS, retrofit);\n fail();\n } catch (IllegalStateException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Response must be parameterized as Response or Response\");\n }\n }\n}\n" }, { "path": "retrofit-adapters/scala/src/test/java/retrofit2/adapter/scala/StringConverterFactory.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.adapter.scala;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\nfinal class StringConverterFactory extends Converter.Factory {\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return ResponseBody::string;\n }\n\n @Override\n public Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n return value -> RequestBody.create(MediaType.get(\"text/plain\"), value);\n }\n}\n" }, { "path": "retrofit-bom/build.gradle", "content": "import com.vanniktech.maven.publish.JavaPlatform\n\napply plugin: 'java-platform'\napply plugin: 'com.vanniktech.maven.publish'\n\nmavenPublishing {\n configure(new JavaPlatform())\n}\n\ndependencies {\n constraints {\n rootProject.subprojects { subproject ->\n subproject.plugins.withId('com.vanniktech.maven.publish') {\n // Exclude self project from BOM.\n if (subproject != this.project) {\n api subproject\n }\n }\n }\n }\n}\n" }, { "path": "retrofit-bom/gradle.properties", "content": "POM_ARTIFACT_ID=retrofit-bom\nPOM_NAME=Retrofit BOM\nPOM_DESCRIPTION=A BOM for managing Retrofit dependencies.\n" }, { "path": "retrofit-converters/README.md", "content": "Retrofit Converters\n===================\n\nRetrofit ships with support for OkHttp's `RequestBody` and `ResponseBody` types but the library is\ncontent-format agnostic. The child modules contained herein are additional converters for other\npopular formats.\n\nTo use, supply an instance of your desired converter when building your `Retrofit` instance.\n\n```java\nRetrofit retrofit = new Retrofit.Builder()\n .baseUrl(\"https://api.example.com\")\n .addConverterFactory(GsonConverterFactory.create())\n .build();\n```\n" }, { "path": "retrofit-converters/gson/README.md", "content": "Gson Converter\n==============\n\nA `Converter` which uses [Gson][1] for serialization to and from JSON.\n\nA default `Gson` instance will be created or one can be configured and passed to the\n`GsonConverterFactory` to further control the serialization.\n\n\nDownload\n--------\n\nDownload [the latest JAR][2] or grab via [Maven][3]:\n```xml\n\n com.squareup.retrofit2\n converter-gson\n latest.version\n\n```\nor [Gradle][3]:\n```groovy\nimplementation 'com.squareup.retrofit2:converter-gson:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n\n [1]: https://github.com/google/gson\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=converter-gson&v=LATEST\n [3]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22converter-gson%22\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-converters/gson/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n api libs.gson\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.okhttp.mockwebserver\n testImplementation libs.testParameterInjector\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.converter.gson'\n }\n}\n" }, { "path": "retrofit-converters/gson/gradle.properties", "content": "POM_ARTIFACT_ID=converter-gson\nPOM_NAME=Converter: Gson\nPOM_DESCRIPTION=A Retrofit Converter which uses Gson for serialization.\n" }, { "path": "retrofit-converters/gson/src/main/java/retrofit2/converter/gson/GsonConverterFactory.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.gson;\n\nimport com.google.gson.Gson;\nimport com.google.gson.TypeAdapter;\nimport com.google.gson.reflect.TypeToken;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Call;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\n/**\n * A {@linkplain Converter.Factory converter} which uses Gson for JSON.\n *\n *

Because Gson is so flexible in the types it supports, this converter assumes that it can\n * handle all types. If you are mixing JSON serialization with something else (such as protocol\n * buffers), you must {@linkplain Retrofit.Builder#addConverterFactory(Converter.Factory) add this\n * instance} last to allow the other converters a chance to see their types.\n */\npublic final class GsonConverterFactory extends Converter.Factory {\n /**\n * Create an instance using a default {@link Gson} instance for conversion. Encoding to JSON and\n * decoding from JSON (when no charset is specified by a header) will use UTF-8.\n */\n public static GsonConverterFactory create() {\n return create(new Gson());\n }\n\n /**\n * Create an instance using {@code gson} for conversion. Encoding to JSON and decoding from JSON\n * (when no charset is specified by a header) will use UTF-8.\n */\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static GsonConverterFactory create(Gson gson) {\n if (gson == null) throw new NullPointerException(\"gson == null\");\n return new GsonConverterFactory(gson, false);\n }\n\n private final Gson gson;\n private final boolean streaming;\n\n private GsonConverterFactory(Gson gson, boolean streaming) {\n this.gson = gson;\n this.streaming = streaming;\n }\n\n /**\n * Return a new factory which streams serialization of request messages to bytes on the HTTP thread\n * This is either the calling thread for {@link Call#execute()}, or one of OkHttp's background\n * threads for {@link Call#enqueue}. Response bytes are always converted to message instances on\n * one of OkHttp's background threads.\n */\n public GsonConverterFactory withStreaming() {\n return new GsonConverterFactory(gson, true);\n }\n\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n TypeAdapter adapter = gson.getAdapter(TypeToken.get(type));\n return new GsonResponseBodyConverter<>(gson, adapter);\n }\n\n @Override\n public Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n TypeAdapter adapter = gson.getAdapter(TypeToken.get(type));\n return new GsonRequestBodyConverter<>(gson, adapter, streaming);\n }\n}\n" }, { "path": "retrofit-converters/gson/src/main/java/retrofit2/converter/gson/GsonRequestBodyConverter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.gson;\n\nimport static java.nio.charset.StandardCharsets.UTF_8;\n\nimport com.google.gson.Gson;\nimport com.google.gson.TypeAdapter;\nimport com.google.gson.stream.JsonWriter;\nimport java.io.IOException;\nimport java.io.OutputStreamWriter;\nimport java.io.Writer;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okio.Buffer;\nimport okio.BufferedSink;\nimport retrofit2.Converter;\n\nfinal class GsonRequestBodyConverter implements Converter {\n static final MediaType MEDIA_TYPE = MediaType.get(\"application/json; charset=UTF-8\");\n\n private final Gson gson;\n private final TypeAdapter adapter;\n private final boolean streaming;\n\n GsonRequestBodyConverter(Gson gson, TypeAdapter adapter, boolean streaming) {\n this.gson = gson;\n this.adapter = adapter;\n this.streaming = streaming;\n }\n\n @Override\n public RequestBody convert(T value) throws IOException {\n if (streaming) {\n return new GsonStreamingRequestBody<>(gson, adapter, value);\n }\n\n Buffer buffer = new Buffer();\n writeJson(buffer, gson, adapter, value);\n return RequestBody.create(MEDIA_TYPE, buffer.readByteString());\n }\n\n static void writeJson(BufferedSink sink, Gson gson, TypeAdapter adapter, T value)\n throws IOException {\n Writer writer = new OutputStreamWriter(sink.outputStream(), UTF_8);\n JsonWriter jsonWriter = gson.newJsonWriter(writer);\n adapter.write(jsonWriter, value);\n jsonWriter.close();\n }\n}\n" }, { "path": "retrofit-converters/gson/src/main/java/retrofit2/converter/gson/GsonResponseBodyConverter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.gson;\n\nimport com.google.gson.Gson;\nimport com.google.gson.JsonIOException;\nimport com.google.gson.TypeAdapter;\nimport com.google.gson.stream.JsonReader;\nimport com.google.gson.stream.JsonToken;\nimport java.io.IOException;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\n\nfinal class GsonResponseBodyConverter implements Converter {\n private final Gson gson;\n private final TypeAdapter adapter;\n\n GsonResponseBodyConverter(Gson gson, TypeAdapter adapter) {\n this.gson = gson;\n this.adapter = adapter;\n }\n\n @Override\n public T convert(ResponseBody value) throws IOException {\n JsonReader jsonReader = gson.newJsonReader(value.charStream());\n try {\n T result = adapter.read(jsonReader);\n if (jsonReader.peek() != JsonToken.END_DOCUMENT) {\n throw new JsonIOException(\"JSON document was not fully consumed.\");\n }\n return result;\n } finally {\n value.close();\n }\n }\n}\n" }, { "path": "retrofit-converters/gson/src/main/java/retrofit2/converter/gson/GsonStreamingRequestBody.java", "content": "/*\n * Copyright (C) 2025 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.gson;\n\nimport static retrofit2.converter.gson.GsonRequestBodyConverter.MEDIA_TYPE;\nimport static retrofit2.converter.gson.GsonRequestBodyConverter.writeJson;\n\nimport com.google.gson.Gson;\nimport com.google.gson.TypeAdapter;\nimport java.io.IOException;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okio.BufferedSink;\n\nfinal class GsonStreamingRequestBody extends RequestBody {\n private final Gson gson;\n private final TypeAdapter adapter;\n private final T value;\n\n public GsonStreamingRequestBody(Gson gson, TypeAdapter adapter, T value) {\n this.gson = gson;\n this.adapter = adapter;\n this.value = value;\n }\n\n @Override\n public MediaType contentType() {\n return MEDIA_TYPE;\n }\n\n @Override\n public void writeTo(BufferedSink sink) throws IOException {\n writeJson(sink, gson, adapter, value);\n }\n}\n" }, { "path": "retrofit-converters/gson/src/main/java/retrofit2/converter/gson/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.converter.gson;\n" }, { "path": "retrofit-converters/gson/src/test/java/retrofit2/converter/gson/GsonConverterFactoryTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.gson;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\nimport static org.junit.Assume.assumeTrue;\n\nimport com.google.gson.Gson;\nimport com.google.gson.GsonBuilder;\nimport com.google.gson.JsonIOException;\nimport com.google.gson.TypeAdapter;\nimport com.google.gson.stream.JsonReader;\nimport com.google.gson.stream.JsonToken;\nimport com.google.gson.stream.JsonWriter;\nimport com.google.testing.junit.testparameterinjector.TestParameter;\nimport com.google.testing.junit.testparameterinjector.TestParameterInjector;\nimport java.io.EOFException;\nimport java.io.IOException;\nimport java.util.concurrent.CountDownLatch;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport okhttp3.mockwebserver.RecordedRequest;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.runner.RunWith;\nimport retrofit2.Call;\nimport retrofit2.Callback;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.Body;\nimport retrofit2.http.GET;\nimport retrofit2.http.POST;\n\n@RunWith(TestParameterInjector.class)\npublic final class GsonConverterFactoryTest {\n interface AnInterface {\n String getName();\n }\n\n static class AnImplementation implements AnInterface {\n private final String theName;\n\n AnImplementation(String name) {\n theName = name;\n }\n\n @Override\n public String getName() {\n return theName;\n }\n }\n\n static final class ErroringValue {\n static final TypeAdapter BROKEN_ADAPTER =\n new TypeAdapter() {\n @Override\n public void write(JsonWriter out, ErroringValue value) throws IOException {\n throw new EOFException(\"oops!\");\n }\n\n @Override\n @SuppressWarnings(\"CheckReturnValue\")\n public ErroringValue read(JsonReader reader) throws IOException {\n reader.beginObject();\n reader.nextName();\n String theName = reader.nextString();\n return new ErroringValue(theName);\n }\n };\n\n final String theName;\n\n ErroringValue(String theName) {\n this.theName = theName;\n }\n }\n\n static class AnInterfaceAdapter extends TypeAdapter {\n @Override\n public void write(JsonWriter jsonWriter, AnInterface anInterface) throws IOException {\n jsonWriter.beginObject();\n jsonWriter.name(\"name\").value(anInterface.getName());\n jsonWriter.endObject();\n }\n\n @Override\n public AnInterface read(JsonReader jsonReader) throws IOException {\n jsonReader.beginObject();\n\n String name = null;\n while (jsonReader.peek() != JsonToken.END_OBJECT) {\n switch (jsonReader.nextName()) {\n case \"name\":\n name = jsonReader.nextString();\n break;\n }\n }\n\n jsonReader.endObject();\n return new AnImplementation(name);\n }\n }\n\n interface Service {\n @POST(\"/\")\n Call anImplementation(@Body AnImplementation impl);\n\n @POST(\"/\")\n Call anInterface(@Body AnInterface impl);\n\n @GET(\"/\")\n Call readErroringValue();\n\n @POST(\"/\")\n Call writeErroringValue(@Body ErroringValue value);\n }\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private final boolean streaming;\n private final Service service;\n\n public GsonConverterFactoryTest(@TestParameter boolean streaming) {\n this.streaming = streaming;\n\n Gson gson =\n new GsonBuilder()\n .registerTypeAdapter(AnInterface.class, new AnInterfaceAdapter())\n .registerTypeAdapter(ErroringValue.class, ErroringValue.BROKEN_ADAPTER)\n .setLenient()\n .create();\n\n GsonConverterFactory factory = GsonConverterFactory.create(gson);\n if (streaming) {\n factory = factory.withStreaming();\n }\n\n Retrofit retrofit =\n new Retrofit.Builder() //\n .baseUrl(server.url(\"/\")) //\n .addConverterFactory(factory) //\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void anInterface() throws IOException, InterruptedException {\n server.enqueue(new MockResponse().setBody(\"{\\\"name\\\":\\\"value\\\"}\"));\n\n Call call = service.anInterface(new AnImplementation(\"value\"));\n Response response = call.execute();\n AnInterface body = response.body();\n assertThat(body.getName()).isEqualTo(\"value\");\n\n RecordedRequest request = server.takeRequest();\n assertThat(request.getBody().readUtf8()).isEqualTo(\"{\\\"name\\\":\\\"value\\\"}\");\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/json; charset=UTF-8\");\n }\n\n @Test\n public void anImplementation() throws IOException, InterruptedException {\n server.enqueue(new MockResponse().setBody(\"{\\\"theName\\\":\\\"value\\\"}\"));\n\n Call call = service.anImplementation(new AnImplementation(\"value\"));\n Response response = call.execute();\n AnImplementation body = response.body();\n assertThat(body.theName).isEqualTo(\"value\");\n\n RecordedRequest request = server.takeRequest();\n assertThat(request.getBody().readUtf8()).isEqualTo(\"{\\\"theName\\\":\\\"value\\\"}\");\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/json; charset=UTF-8\");\n }\n\n @Test\n public void serializeUsesConfiguration() throws IOException, InterruptedException {\n server.enqueue(new MockResponse().setBody(\"{}\"));\n\n service.anImplementation(new AnImplementation(null)).execute();\n\n RecordedRequest request = server.takeRequest();\n assertThat(request.getBody().readUtf8()).isEqualTo(\"{}\"); // Null value was not serialized.\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/json; charset=UTF-8\");\n }\n\n @Test\n public void deserializeUsesConfiguration() throws IOException, InterruptedException {\n server.enqueue(new MockResponse().setBody(\"{/* a comment! */}\"));\n\n Response response =\n service.anImplementation(new AnImplementation(\"value\")).execute();\n assertThat(response.body().getName()).isNull();\n }\n\n @Test\n public void requireFullResponseDocumentConsumption() throws Exception {\n server.enqueue(new MockResponse().setBody(\"{\\\"theName\\\":\\\"value\\\"}\"));\n\n Call call = service.readErroringValue();\n try {\n call.execute();\n fail();\n } catch (JsonIOException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"JSON document was not fully consumed.\");\n }\n }\n\n @Test\n public void serializeIsStreamed() throws InterruptedException {\n assumeTrue(streaming);\n\n Call call = service.writeErroringValue(new ErroringValue(\"hi\"));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n\n // If streaming were broken, the call to enqueue would throw the exception synchronously.\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n latch.countDown();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n throwableRef.set(t);\n latch.countDown();\n }\n });\n latch.await();\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(EOFException.class);\n assertThat(throwable).hasMessageThat().isEqualTo(\"oops!\");\n }\n}\n" }, { "path": "retrofit-converters/guava/README.md", "content": "Guava Converter\n===============\n\nA `Converter` which supports [Guava][1]'s `Optional` by delegating to other converters for `T`\nand then wrapping it into `Optional`.\n\n\nDownload\n--------\n\nDownload [the latest JAR][2] or grab via [Maven][3]:\n```xml\n\n com.squareup.retrofit2\n converter-guava\n latest.version\n\n```\nor [Gradle][3]:\n```groovy\nimplementation 'com.squareup.retrofit2:converter-guava:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n [1]: https://github.com/google/guava\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=converter-guava&v=LATEST\n [3]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22converter-guava%22\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-converters/guava/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n api libs.guava\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.findBugsAnnotations\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.okhttp.mockwebserver\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.converter.guava'\n }\n}\n" }, { "path": "retrofit-converters/guava/gradle.properties", "content": "POM_ARTIFACT_ID=converter-guava\nPOM_NAME=Converter: Guava\nPOM_DESCRIPTION=A Retrofit Converter for Guava's Optional type." }, { "path": "retrofit-converters/guava/src/main/java/retrofit/converter/guava/GuavaOptionalConverterFactory.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit.converter.guava;\n\nimport com.google.common.base.Optional;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\n/**\n * A {@linkplain Converter.Factory converter} for {@code Optional} which delegates to another\n * converter to deserialize {@code T} and then wraps it into {@link Optional}.\n */\npublic final class GuavaOptionalConverterFactory extends Converter.Factory {\n public static GuavaOptionalConverterFactory create() {\n return new GuavaOptionalConverterFactory();\n }\n\n private GuavaOptionalConverterFactory() {}\n\n @Override\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n if (getRawType(type) != Optional.class) {\n return null;\n }\n\n Type innerType = getParameterUpperBound(0, (ParameterizedType) type);\n Converter delegate =\n retrofit.responseBodyConverter(innerType, annotations);\n return new OptionalConverter<>(delegate);\n }\n}\n" }, { "path": "retrofit-converters/guava/src/main/java/retrofit/converter/guava/OptionalConverter.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit.converter.guava;\n\nimport com.google.common.base.Optional;\nimport java.io.IOException;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\n\nfinal class OptionalConverter implements Converter> {\n private final Converter delegate;\n\n OptionalConverter(Converter delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public Optional convert(ResponseBody value) throws IOException {\n return Optional.fromNullable(delegate.convert(value));\n }\n}\n" }, { "path": "retrofit-converters/guava/src/main/java/retrofit/converter/guava/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit.converter.guava;\n" }, { "path": "retrofit-converters/guava/src/main/resources/META-INF/proguard/retrofit2-guava-converter.pro", "content": "# Keep generic signature of Optional (R8 full mode strips signatures from non-kept items).\n-keep,allowoptimization,allowshrinking,allowobfuscation class com.google.common.base.Optional\n" }, { "path": "retrofit-converters/guava/src/test/java/retrofit/converter/guava/AlwaysNullConverterFactory.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit.converter.guava;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\nfinal class AlwaysNullConverterFactory extends Converter.Factory {\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return value -> null;\n }\n}\n" }, { "path": "retrofit-converters/guava/src/test/java/retrofit/converter/guava/GuavaOptionalConverterFactoryTest.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit.converter.guava;\n\nimport static com.google.common.truth.Truth.assertThat;\n\nimport com.google.common.base.Optional;\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport okhttp3.ResponseBody;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Call;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class GuavaOptionalConverterFactoryTest {\n interface Service {\n @GET(\"/\")\n Call> optional();\n\n @GET(\"/\")\n Call object();\n }\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(GuavaOptionalConverterFactory.create())\n .addConverterFactory(new AlwaysNullConverterFactory())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void optional() throws IOException {\n server.enqueue(new MockResponse());\n\n Optional optional = service.optional().execute().body();\n assertThat(optional).isNotNull();\n assertThat(optional.isPresent()).isFalse();\n }\n\n @Test\n public void onlyMatchesOptional() throws IOException {\n server.enqueue(new MockResponse());\n\n Object body = service.object().execute().body();\n assertThat(body).isNull();\n }\n\n @Test\n public void delegates() throws IOException {\n final Object object = new Object();\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(\n new Converter.Factory() {\n @Nullable\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n if (getRawType(type) != Object.class) {\n return null;\n }\n return value -> object;\n }\n })\n .addConverterFactory(GuavaOptionalConverterFactory.create())\n .build();\n\n server.enqueue(new MockResponse());\n\n Service service = retrofit.create(Service.class);\n Optional optional = service.optional().execute().body();\n assertThat(optional).isNotNull();\n assertThat(optional.get()).isSameInstanceAs(object);\n }\n}\n" }, { "path": "retrofit-converters/jackson/README.md", "content": "Jackson Converter\n=================\n\nA `Converter` which uses [Jackson][1] for serialization.\n\nA default `ObjectMapper` instance will be created or one can be configured and passed to the\n`JacksonConverterFactory` construction to further control the serialization.\n\nMulti-Format Support\n--------------------\n\nThis converter is not limited to JSON. Jackson supports many data formats through its\n[dataformat modules][4], and this converter works with any of them by supplying the appropriate\nmapper and media type.\n\n### XML\n\n```java\nimport com.fasterxml.jackson.dataformat.xml.XmlMapper;\n\nRetrofit retrofit = new Retrofit.Builder()\n .baseUrl(\"https://example.com/\")\n .addConverterFactory(\n JacksonConverterFactory.create(\n new XmlMapper(),\n MediaType.get(\"application/xml\")))\n .build();\n```\n\nRequires the `jackson-dataformat-xml` dependency.\n\n### CBOR\n\n```java\nimport com.fasterxml.jackson.dataformat.cbor.databind.CBORMapper;\n\nRetrofit retrofit = new Retrofit.Builder()\n .baseUrl(\"https://example.com/\")\n .addConverterFactory(\n JacksonConverterFactory.create(\n new CBORMapper(),\n MediaType.get(\"application/cbor\")))\n .build();\n```\n\nRequires the `jackson-dataformat-cbor` dependency.\n\n### Other Formats\n\nThe same pattern applies to other Jackson dataformat modules such as YAML, Smile, Ion, and more.\nSimply use the corresponding mapper (e.g., `YAMLMapper`, `SmileMapper`) and media type.\n\n\nDownload\n--------\n\nDownload [the latest JAR][2] or grab via [Maven][3]:\n```xml\n\n com.squareup.retrofit2\n converter-jackson\n latest.version\n\n```\nor [Gradle][3]:\n```groovy\nimplementation 'com.squareup.retrofit2:converter-jackson:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n\n [1]: https://github.com/FasterXML/jackson\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=converter-jackson&v=LATEST\n [3]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22converter-jackson%22\n [4]: https://github.com/FasterXML/jackson#data-format-modules\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n\n" }, { "path": "retrofit-converters/jackson/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n api libs.jacksonDatabind\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.okhttp.mockwebserver\n testImplementation libs.testParameterInjector\n testImplementation libs.jacksonDataformatCbor\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.converter.jackson'\n }\n}\n" }, { "path": "retrofit-converters/jackson/gradle.properties", "content": "POM_ARTIFACT_ID=converter-jackson\nPOM_NAME=Converter: Jackson\nPOM_DESCRIPTION=A Retrofit Converter which uses Jackson for serialization.\n" }, { "path": "retrofit-converters/jackson/src/main/java/retrofit2/converter/jackson/JacksonConverterFactory.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jackson;\n\nimport com.fasterxml.jackson.databind.JavaType;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport com.fasterxml.jackson.databind.ObjectReader;\nimport com.fasterxml.jackson.databind.ObjectWriter;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Call;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\n/**\n * A {@linkplain Converter.Factory converter} which uses Jackson.\n *\n *

Because Jackson is so flexible in the types it supports, this converter assumes that it can\n * handle all types. If you are mixing JSON serialization with something else (such as protocol\n * buffers), you must {@linkplain Retrofit.Builder#addConverterFactory(Converter.Factory) add this\n * instance} last to allow the other converters a chance to see their types.\n */\npublic final class JacksonConverterFactory extends Converter.Factory {\n private static final MediaType DEFAULT_MEDIA_TYPE =\n MediaType.get(\"application/json; charset=UTF-8\");\n\n /** Create an instance using a default {@link ObjectMapper} instance for conversion. */\n public static JacksonConverterFactory create() {\n return new JacksonConverterFactory(new ObjectMapper(), DEFAULT_MEDIA_TYPE, false);\n }\n\n /** Create an instance using {@code mapper} for conversion. */\n public static JacksonConverterFactory create(ObjectMapper mapper) {\n return create(mapper, DEFAULT_MEDIA_TYPE);\n }\n\n /** Create an instance using {@code mapper} and {@code mediaType} for conversion. */\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static JacksonConverterFactory create(ObjectMapper mapper, MediaType mediaType) {\n if (mapper == null) throw new NullPointerException(\"mapper == null\");\n if (mediaType == null) throw new NullPointerException(\"mediaType == null\");\n return new JacksonConverterFactory(mapper, mediaType, false);\n }\n\n private final ObjectMapper mapper;\n private final MediaType mediaType;\n private final boolean streaming;\n\n private JacksonConverterFactory(ObjectMapper mapper, MediaType mediaType, boolean streaming) {\n this.mapper = mapper;\n this.mediaType = mediaType;\n this.streaming = streaming;\n }\n\n /**\n * Return a new factory which streams serialization of request messages to bytes on the HTTP thread\n * This is either the calling thread for {@link Call#execute()}, or one of OkHttp's background\n * threads for {@link Call#enqueue}. Response bytes are always converted to message instances on\n * one of OkHttp's background threads.\n */\n public JacksonConverterFactory withStreaming() {\n return new JacksonConverterFactory(mapper, mediaType, true);\n }\n\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n JavaType javaType = mapper.getTypeFactory().constructType(type);\n ObjectReader reader = mapper.readerFor(javaType);\n return new JacksonResponseBodyConverter<>(reader);\n }\n\n @Override\n public Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n JavaType javaType = mapper.getTypeFactory().constructType(type);\n ObjectWriter writer = mapper.writerFor(javaType);\n return new JacksonRequestBodyConverter<>(writer, mediaType, streaming);\n }\n}\n" }, { "path": "retrofit-converters/jackson/src/main/java/retrofit2/converter/jackson/JacksonRequestBodyConverter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jackson;\n\nimport com.fasterxml.jackson.databind.ObjectWriter;\nimport java.io.IOException;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport retrofit2.Converter;\n\nfinal class JacksonRequestBodyConverter implements Converter {\n private final ObjectWriter adapter;\n private final MediaType mediaType;\n private final boolean streaming;\n\n JacksonRequestBodyConverter(ObjectWriter adapter, MediaType mediaType, boolean streaming) {\n this.adapter = adapter;\n this.mediaType = mediaType;\n this.streaming = streaming;\n }\n\n @Override\n public RequestBody convert(T value) throws IOException {\n if (streaming) {\n return new JacksonStreamingRequestBody(adapter, value, mediaType);\n }\n\n byte[] bytes = adapter.writeValueAsBytes(value);\n return RequestBody.create(mediaType, bytes);\n }\n}\n" }, { "path": "retrofit-converters/jackson/src/main/java/retrofit2/converter/jackson/JacksonResponseBodyConverter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jackson;\n\nimport com.fasterxml.jackson.databind.ObjectReader;\nimport java.io.IOException;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\n\nfinal class JacksonResponseBodyConverter implements Converter {\n private final ObjectReader adapter;\n\n JacksonResponseBodyConverter(ObjectReader adapter) {\n this.adapter = adapter;\n }\n\n @Override\n public T convert(ResponseBody value) throws IOException {\n try {\n return adapter.readValue(value.byteStream());\n } finally {\n value.close();\n }\n }\n}\n" }, { "path": "retrofit-converters/jackson/src/main/java/retrofit2/converter/jackson/JacksonStreamingRequestBody.java", "content": "/*\n * Copyright (C) 2025 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jackson;\n\nimport com.fasterxml.jackson.databind.ObjectWriter;\nimport java.io.IOException;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okio.BufferedSink;\n\nfinal class JacksonStreamingRequestBody extends RequestBody {\n private final ObjectWriter adapter;\n private final Object value;\n private final MediaType mediaType;\n\n public JacksonStreamingRequestBody(ObjectWriter adapter, Object value, MediaType mediaType) {\n this.adapter = adapter;\n this.value = value;\n this.mediaType = mediaType;\n }\n\n @Override\n public MediaType contentType() {\n return mediaType;\n }\n\n @Override\n public void writeTo(BufferedSink sink) throws IOException {\n adapter.writeValue(sink.outputStream(), value);\n }\n}\n" }, { "path": "retrofit-converters/jackson/src/main/java/retrofit2/converter/jackson/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.converter.jackson;\n" }, { "path": "retrofit-converters/jackson/src/test/java/retrofit2/converter/jackson/JacksonCborConverterFactoryTest.java", "content": "/*\n * Copyright (C) 2024 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jackson;\n\nimport static com.google.common.truth.Truth.assertThat;\n\nimport com.fasterxml.jackson.dataformat.cbor.databind.CBORMapper;\nimport java.io.IOException;\nimport okhttp3.MediaType;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport okhttp3.mockwebserver.RecordedRequest;\nimport okio.Buffer;\nimport okio.ByteString;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Call;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.Body;\nimport retrofit2.http.POST;\n\npublic class JacksonCborConverterFactoryTest {\n static class IntWrapper {\n public int value;\n\n public IntWrapper(int v) {\n value = v;\n }\n\n protected IntWrapper() {}\n }\n\n interface Service {\n @POST(\"/\")\n Call post(@Body IntWrapper person);\n }\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(\n JacksonConverterFactory.create(new CBORMapper(), MediaType.get(\"application/cbor\")))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void post() throws IOException, InterruptedException {\n server.enqueue(\n new MockResponse()\n .setBody(new Buffer().write(ByteString.decodeHex(\"bf6576616c7565182aff\"))));\n\n Call call = service.post(new IntWrapper(12));\n Response response = call.execute();\n assertThat(response.body().value).isEqualTo(42);\n\n RecordedRequest request = server.takeRequest();\n assertThat(request.getBody().readByteString())\n .isEqualTo(ByteString.decodeHex(\"bf6576616c75650cff\"));\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/cbor\");\n }\n}\n" }, { "path": "retrofit-converters/jackson/src/test/java/retrofit2/converter/jackson/JacksonConverterFactoryTest.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jackson;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assume.assumeTrue;\n\nimport com.fasterxml.jackson.annotation.JsonAutoDetect;\nimport com.fasterxml.jackson.core.JsonGenerator;\nimport com.fasterxml.jackson.core.JsonParser;\nimport com.fasterxml.jackson.core.JsonToken;\nimport com.fasterxml.jackson.databind.DeserializationContext;\nimport com.fasterxml.jackson.databind.MapperFeature;\nimport com.fasterxml.jackson.databind.ObjectMapper;\nimport com.fasterxml.jackson.databind.SerializerProvider;\nimport com.fasterxml.jackson.databind.deser.std.StdDeserializer;\nimport com.fasterxml.jackson.databind.module.SimpleModule;\nimport com.fasterxml.jackson.databind.ser.std.StdSerializer;\nimport com.google.testing.junit.testparameterinjector.TestParameter;\nimport com.google.testing.junit.testparameterinjector.TestParameterInjector;\nimport java.io.EOFException;\nimport java.io.IOException;\nimport java.util.concurrent.CountDownLatch;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport okhttp3.mockwebserver.RecordedRequest;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.runner.RunWith;\nimport retrofit2.Call;\nimport retrofit2.Callback;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.Body;\nimport retrofit2.http.POST;\n\n@RunWith(TestParameterInjector.class)\npublic final class JacksonConverterFactoryTest {\n interface AnInterface {\n String getName();\n }\n\n static class AnImplementation implements AnInterface {\n private String theName;\n\n AnImplementation() {}\n\n AnImplementation(String name) {\n theName = name;\n }\n\n @Override\n public String getName() {\n return theName;\n }\n }\n\n static class AnInterfaceSerializer extends StdSerializer {\n AnInterfaceSerializer() {\n super(AnInterface.class);\n }\n\n @Override\n public void serialize(\n AnInterface anInterface, JsonGenerator jsonGenerator, SerializerProvider serializerProvider)\n throws IOException {\n jsonGenerator.writeStartObject();\n jsonGenerator.writeFieldName(\"name\");\n jsonGenerator.writeString(anInterface.getName());\n jsonGenerator.writeEndObject();\n }\n }\n\n static class AnInterfaceDeserializer extends StdDeserializer {\n AnInterfaceDeserializer() {\n super(AnInterface.class);\n }\n\n @Override\n public AnInterface deserialize(JsonParser jp, DeserializationContext ctxt) throws IOException {\n if (jp.getCurrentToken() != JsonToken.START_OBJECT) {\n throw new AssertionError(\"Expected start object.\");\n }\n\n String name = null;\n\n while (jp.nextToken() != JsonToken.END_OBJECT) {\n switch (jp.getCurrentName()) {\n case \"name\":\n name = jp.getValueAsString();\n break;\n }\n }\n\n return new AnImplementation(name);\n }\n }\n\n static final class ErroringValue {\n final String theName;\n\n ErroringValue(String theName) {\n this.theName = theName;\n }\n }\n\n static final class ErroringValueSerializer extends StdSerializer {\n ErroringValueSerializer() {\n super(ErroringValue.class);\n }\n\n @Override\n public void serialize(\n ErroringValue erroringValue,\n JsonGenerator jsonGenerator,\n SerializerProvider serializerProvider)\n throws IOException {\n throw new EOFException(\"oops!\");\n }\n }\n\n interface Service {\n @POST(\"/\")\n Call anImplementation(@Body AnImplementation impl);\n\n @POST(\"/\")\n Call anInterface(@Body AnInterface impl);\n\n @POST(\"/\")\n Call erroringValue(@Body ErroringValue value);\n }\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private final Service service;\n private final boolean streaming;\n\n public JacksonConverterFactoryTest(@TestParameter boolean streaming) {\n this.streaming = streaming;\n\n SimpleModule module = new SimpleModule();\n module.addSerializer(AnInterface.class, new AnInterfaceSerializer());\n module.addSerializer(ErroringValue.class, new ErroringValueSerializer());\n module.addDeserializer(AnInterface.class, new AnInterfaceDeserializer());\n ObjectMapper mapper = new ObjectMapper();\n mapper.registerModule(module);\n mapper.configure(MapperFeature.AUTO_DETECT_GETTERS, false);\n mapper.configure(MapperFeature.AUTO_DETECT_SETTERS, false);\n mapper.configure(MapperFeature.AUTO_DETECT_IS_GETTERS, false);\n mapper.setVisibilityChecker(\n mapper\n .getSerializationConfig()\n .getDefaultVisibilityChecker()\n .withFieldVisibility(JsonAutoDetect.Visibility.ANY));\n\n JacksonConverterFactory factory = JacksonConverterFactory.create(mapper);\n if (streaming) {\n factory = factory.withStreaming();\n }\n\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).addConverterFactory(factory).build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void anInterface() throws IOException, InterruptedException {\n server.enqueue(new MockResponse().setBody(\"{\\\"name\\\":\\\"value\\\"}\"));\n\n Call call = service.anInterface(new AnImplementation(\"value\"));\n Response response = call.execute();\n AnInterface body = response.body();\n assertThat(body.getName()).isEqualTo(\"value\");\n\n RecordedRequest request = server.takeRequest();\n assertThat(request.getBody().readUtf8()).isEqualTo(\"{\\\"name\\\":\\\"value\\\"}\");\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/json; charset=UTF-8\");\n }\n\n @Test\n public void anImplementation() throws IOException, InterruptedException {\n server.enqueue(new MockResponse().setBody(\"{\\\"theName\\\":\\\"value\\\"}\"));\n\n Call call = service.anImplementation(new AnImplementation(\"value\"));\n Response response = call.execute();\n AnImplementation body = response.body();\n assertThat(body.theName).isEqualTo(\"value\");\n\n RecordedRequest request = server.takeRequest();\n // TODO figure out how to get Jackson to stop using AnInterface's serializer here.\n assertThat(request.getBody().readUtf8()).isEqualTo(\"{\\\"name\\\":\\\"value\\\"}\");\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/json; charset=UTF-8\");\n }\n\n @Test\n public void serializeIsStreamed() throws InterruptedException {\n assumeTrue(streaming);\n\n Call call = service.erroringValue(new ErroringValue(\"hi\"));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n\n // If streaming were broken, the call to enqueue would throw the exception synchronously.\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n latch.countDown();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n throwableRef.set(t);\n latch.countDown();\n }\n });\n latch.await();\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(EOFException.class);\n assertThat(throwable).hasMessageThat().isEqualTo(\"oops!\");\n }\n}\n" }, { "path": "retrofit-converters/java8/README.md", "content": "Java 8 Converter (Deprecated)\n=============================\n\nA `Converter` which supports Java 8's `Optional` by delegating to other converters for `T`\nand then wrapping it into `Optional`.\n\nThis converter is no longer needed. Support for `Optional` is built-in to Retrofit and now works\nwithout configuration.\n" }, { "path": "retrofit-converters/java8/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.okhttp.mockwebserver\n testImplementation libs.findBugsAnnotations\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.converter.java8'\n }\n}\n" }, { "path": "retrofit-converters/java8/gradle.properties", "content": "POM_ARTIFACT_ID=converter-java8\nPOM_NAME=Converter: Java 8\nPOM_DESCRIPTION=A Retrofit Converter for Java 8's Optional type.\n" }, { "path": "retrofit-converters/java8/src/main/java/retrofit/converter/java8/Java8OptionalConverterFactory.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit.converter.java8;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport java.util.Optional;\nimport javax.annotation.Nullable;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\n/**\n * @deprecated Retrofit includes support for Optional. This no longer needs to be added to the\n * Retrofit instance explicitly.\n *

A {@linkplain Converter.Factory converter} for {@code Optional} which delegates to\n * another converter to deserialize {@code T} and then wraps it into {@link Optional}.\n */\n@Deprecated\npublic final class Java8OptionalConverterFactory extends Converter.Factory {\n public static Java8OptionalConverterFactory create() {\n return new Java8OptionalConverterFactory();\n }\n\n private Java8OptionalConverterFactory() {}\n\n @Override\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n if (getRawType(type) != Optional.class) {\n return null;\n }\n\n Type innerType = getParameterUpperBound(0, (ParameterizedType) type);\n Converter delegate =\n retrofit.responseBodyConverter(innerType, annotations);\n return new OptionalConverter<>(delegate);\n }\n}\n" }, { "path": "retrofit-converters/java8/src/main/java/retrofit/converter/java8/OptionalConverter.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit.converter.java8;\n\nimport java.io.IOException;\nimport java.util.Optional;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\n\nfinal class OptionalConverter implements Converter> {\n private final Converter delegate;\n\n OptionalConverter(Converter delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public Optional convert(ResponseBody value) throws IOException {\n return Optional.ofNullable(delegate.convert(value));\n }\n}\n" }, { "path": "retrofit-converters/java8/src/main/java/retrofit/converter/java8/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit.converter.java8;\n" }, { "path": "retrofit-converters/java8/src/test/java/retrofit/converter/java8/AlwaysNullConverterFactory.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit.converter.java8;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\nfinal class AlwaysNullConverterFactory extends Converter.Factory {\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n return value -> null;\n }\n}\n" }, { "path": "retrofit-converters/java8/src/test/java/retrofit/converter/java8/Java8OptionalConverterFactoryTest.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit.converter.java8;\n\nimport static com.google.common.truth.Truth.assertThat;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport java.util.Optional;\nimport javax.annotation.Nullable;\nimport okhttp3.ResponseBody;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Call;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class Java8OptionalConverterFactoryTest {\n interface Service {\n @GET(\"/\")\n Call> optional();\n\n @GET(\"/\")\n Call object();\n }\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(Java8OptionalConverterFactory.create())\n .addConverterFactory(new AlwaysNullConverterFactory())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void optional() throws IOException {\n server.enqueue(new MockResponse());\n\n Optional optional = service.optional().execute().body();\n assertThat(optional).isNotNull();\n assertThat(optional.isPresent()).isFalse();\n }\n\n @Test\n public void onlyMatchesOptional() throws IOException {\n server.enqueue(new MockResponse());\n\n Object body = service.object().execute().body();\n assertThat(body).isNull();\n }\n\n @Test\n public void delegates() throws IOException {\n Object object = new Object();\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(\n new Converter.Factory() {\n @Nullable\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n if (getRawType(type) != Object.class) {\n return null;\n }\n return value -> object;\n }\n })\n .addConverterFactory(Java8OptionalConverterFactory.create())\n .build();\n\n server.enqueue(new MockResponse());\n\n Service service = retrofit.create(Service.class);\n Optional optional = service.optional().execute().body();\n assertThat(optional).isNotNull();\n assertThat(optional.get()).isSameInstanceAs(object);\n }\n}\n" }, { "path": "retrofit-converters/jaxb/README.md", "content": "JAXB Converter\n==============\n\nA `Converter` which uses [JAXB][1] for serialization to and from XML.\n\nA default `JAXBContext` instance will be created or one can be configured and passed\nto `JaxbConverterFactory.create()` to further control the serialization.\n\n**Note that JAXB does not work on Android.**\n\nDownload\n--------\n\nDownload [the latest JAR][2] or grab via [Maven][3]:\n```xml\n\n com.squareup.retrofit2\n converter-jaxb\n latest.version\n\n```\nor [Gradle][3]:\n```groovy\nimplementation 'com.squareup.retrofit2:converter-jaxb:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n\n [1]: https://github.com/eclipse-ee4j/jaxb-ri\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=converter-jaxb&v=LATEST\n [3]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22converter-jaxb%22\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-converters/jaxb/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n api libs.jaxbApi\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.jaxbImpl\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.okhttp.mockwebserver\n testImplementation libs.findBugsAnnotations\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.converter.jaxb'\n }\n}\n" }, { "path": "retrofit-converters/jaxb/gradle.properties", "content": "POM_ARTIFACT_ID=converter-jaxb\nPOM_NAME=Converter: JAXB\nPOM_DESCRIPTION=A Retrofit Converter which uses JAXB for serialization.\n" }, { "path": "retrofit-converters/jaxb/src/main/java/retrofit2/converter/jaxb/JaxbConverterFactory.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jaxb;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport javax.xml.bind.JAXBContext;\nimport javax.xml.bind.JAXBException;\nimport javax.xml.bind.annotation.XmlRootElement;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\n/**\n * A {@linkplain Converter.Factory converter} which uses JAXB for XML. All validation events are\n * ignored.\n */\npublic final class JaxbConverterFactory extends Converter.Factory {\n static final MediaType XML = MediaType.get(\"application/xml; charset=utf-8\");\n\n /** Create an instance using a default {@link JAXBContext} instance for conversion. */\n public static JaxbConverterFactory create() {\n return new JaxbConverterFactory(null);\n }\n\n /** Create an instance using {@code context} for conversion. */\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static JaxbConverterFactory create(JAXBContext context) {\n if (context == null) throw new NullPointerException(\"context == null\");\n return new JaxbConverterFactory(context);\n }\n\n /** If null, a new JAXB context will be created for each type to be converted. */\n private final @Nullable JAXBContext context;\n\n private JaxbConverterFactory(@Nullable JAXBContext context) {\n this.context = context;\n }\n\n @Override\n public @Nullable Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n if (type instanceof Class && ((Class) type).isAnnotationPresent(XmlRootElement.class)) {\n return new JaxbRequestConverter<>(contextForType((Class) type), (Class) type);\n }\n return null;\n }\n\n @Override\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n if (type instanceof Class && ((Class) type).isAnnotationPresent(XmlRootElement.class)) {\n return new JaxbResponseConverter<>(contextForType((Class) type), (Class) type);\n }\n return null;\n }\n\n private JAXBContext contextForType(Class type) {\n try {\n return context != null ? context : JAXBContext.newInstance(type);\n } catch (JAXBException e) {\n throw new IllegalArgumentException(e);\n }\n }\n}\n" }, { "path": "retrofit-converters/jaxb/src/main/java/retrofit2/converter/jaxb/JaxbRequestConverter.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jaxb;\n\nimport java.io.IOException;\nimport javax.xml.bind.JAXBContext;\nimport javax.xml.bind.JAXBException;\nimport javax.xml.bind.Marshaller;\nimport javax.xml.stream.XMLOutputFactory;\nimport javax.xml.stream.XMLStreamException;\nimport javax.xml.stream.XMLStreamWriter;\nimport okhttp3.RequestBody;\nimport okio.Buffer;\nimport retrofit2.Converter;\n\nfinal class JaxbRequestConverter implements Converter {\n final XMLOutputFactory xmlOutputFactory = XMLOutputFactory.newInstance();\n final JAXBContext context;\n final Class type;\n\n JaxbRequestConverter(JAXBContext context, Class type) {\n this.context = context;\n this.type = type;\n }\n\n @Override\n public RequestBody convert(final T value) throws IOException {\n Buffer buffer = new Buffer();\n try {\n Marshaller marshaller = context.createMarshaller();\n\n XMLStreamWriter xmlWriter =\n xmlOutputFactory.createXMLStreamWriter(\n buffer.outputStream(), JaxbConverterFactory.XML.charset().name());\n marshaller.marshal(value, xmlWriter);\n } catch (JAXBException | XMLStreamException e) {\n throw new RuntimeException(e);\n }\n return RequestBody.create(JaxbConverterFactory.XML, buffer.readByteString());\n }\n}\n" }, { "path": "retrofit-converters/jaxb/src/main/java/retrofit2/converter/jaxb/JaxbResponseConverter.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jaxb;\n\nimport java.io.IOException;\nimport javax.xml.bind.JAXBContext;\nimport javax.xml.bind.JAXBException;\nimport javax.xml.bind.Unmarshaller;\nimport javax.xml.stream.XMLInputFactory;\nimport javax.xml.stream.XMLStreamException;\nimport javax.xml.stream.XMLStreamReader;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\n\nfinal class JaxbResponseConverter implements Converter {\n final XMLInputFactory xmlInputFactory = XMLInputFactory.newInstance();\n final JAXBContext context;\n final Class type;\n\n JaxbResponseConverter(JAXBContext context, Class type) {\n this.context = context;\n this.type = type;\n\n // Prevent XML External Entity attacks (XXE).\n xmlInputFactory.setProperty(XMLInputFactory.IS_SUPPORTING_EXTERNAL_ENTITIES, false);\n xmlInputFactory.setProperty(XMLInputFactory.SUPPORT_DTD, false);\n }\n\n @Override\n public T convert(ResponseBody value) throws IOException {\n try {\n Unmarshaller unmarshaller = context.createUnmarshaller();\n XMLStreamReader streamReader = xmlInputFactory.createXMLStreamReader(value.charStream());\n return unmarshaller.unmarshal(streamReader, type).getValue();\n } catch (JAXBException | XMLStreamException e) {\n throw new RuntimeException(e);\n } finally {\n value.close();\n }\n }\n}\n" }, { "path": "retrofit-converters/jaxb/src/main/java/retrofit2/converter/jaxb/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.converter.jaxb;\n" }, { "path": "retrofit-converters/jaxb/src/test/java/retrofit2/converter/jaxb/Contact.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jaxb;\n\nimport java.util.ArrayList;\nimport java.util.Arrays;\nimport java.util.List;\nimport javax.xml.bind.annotation.XmlElement;\nimport javax.xml.bind.annotation.XmlRootElement;\n\n@XmlRootElement(name = \"contact\")\nfinal class Contact {\n @XmlElement(required = true)\n public final String name;\n\n @XmlElement(name = \"phone_number\")\n public final List phone_numbers;\n\n @SuppressWarnings(\"unused\") // Used by JAXB.\n private Contact() {\n this(\"\", new ArrayList());\n }\n\n public Contact(String name, List phoneNumbers) {\n this.name = name;\n this.phone_numbers = phoneNumbers;\n }\n\n @Override\n public boolean equals(Object o) {\n return o instanceof Contact\n && ((Contact) o).name.equals(name)\n && ((Contact) o).phone_numbers.equals(phone_numbers);\n }\n\n @Override\n public int hashCode() {\n return Arrays.asList(name, phone_numbers).hashCode();\n }\n}\n" }, { "path": "retrofit-converters/jaxb/src/test/java/retrofit2/converter/jaxb/JaxbConverterFactoryTest.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jaxb;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static junit.framework.TestCase.fail;\n\nimport java.util.Collections;\nimport javax.xml.bind.JAXBContext;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport okhttp3.mockwebserver.RecordedRequest;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Call;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.Body;\nimport retrofit2.http.GET;\nimport retrofit2.http.POST;\n\npublic final class JaxbConverterFactoryTest {\n static final Contact SAMPLE_CONTACT =\n new Contact(\"Jenny\", Collections.singletonList(new PhoneNumber(\"867-5309\", Type.MOBILE)));\n\n static final String SAMPLE_CONTACT_XML =\n \"\"\n + \"\"\n + \"\"\n + \"Jenny\"\n + \"\"\n + \"867-5309\"\n + \"\"\n + \"\";\n\n interface Service {\n @POST(\"/\")\n Call postXml(@Body Contact contact);\n\n @GET(\"/\")\n Call getXml();\n }\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private Service service;\n\n @Before\n public void setUp() {\n JaxbConverterFactory factory = JaxbConverterFactory.create();\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).addConverterFactory(factory).build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void xmlRequestBody() throws Exception {\n server.enqueue(new MockResponse());\n\n Call call = service.postXml(SAMPLE_CONTACT);\n call.execute();\n\n RecordedRequest request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/xml; charset=utf-8\");\n assertThat(request.getBody().readUtf8()).isEqualTo(SAMPLE_CONTACT_XML);\n }\n\n @Test\n public void xmlResponseBody() throws Exception {\n server.enqueue(new MockResponse().setBody(SAMPLE_CONTACT_XML));\n\n Call call = service.getXml();\n Response response = call.execute();\n assertThat(response.body()).isEqualTo(SAMPLE_CONTACT);\n }\n\n @Test\n public void characterEncoding() throws Exception {\n server.enqueue(\n new MockResponse()\n .setBody(\n \"\"\n + \"\"\n + \"\"\n + \"Бронтозавр \\uD83E\\uDD95 ティラノサウルス・レックス 🦖\"\n + \"\"));\n\n Call call = service.getXml();\n Response response = call.execute();\n assertThat(response.body().name)\n .isEqualTo(\"Бронтозавр \\uD83E\\uDD95 ティラノサウルス・レックス \\uD83E\\uDD96\");\n }\n\n @Test\n public void userSuppliedJaxbContext() throws Exception {\n JAXBContext context = JAXBContext.newInstance(Contact.class);\n JaxbConverterFactory factory = JaxbConverterFactory.create(context);\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).addConverterFactory(factory).build();\n service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n Call call = service.postXml(SAMPLE_CONTACT);\n call.execute();\n\n RecordedRequest request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/xml; charset=utf-8\");\n assertThat(request.getBody().readUtf8()).isEqualTo(SAMPLE_CONTACT_XML);\n }\n\n @Test\n public void malformedXml() throws Exception {\n server.enqueue(new MockResponse().setBody(\"This is not XML\"));\n\n Call call = service.getXml();\n try {\n call.execute();\n fail();\n } catch (RuntimeException expected) {\n assertThat(expected).hasMessageThat().contains(\"ParseError\");\n }\n }\n\n @Test\n public void unrecognizedField() throws Exception {\n server.enqueue(\n new MockResponse()\n .setBody(\n \"\"\n + \"\"\n + \"\"\n + \"Jenny\"\n + \"21\"\n + \"\"\n + \"867-5309\"\n + \"\"\n + \"\"));\n\n Call call = service.getXml();\n Response response = call.execute();\n assertThat(response.body().name).isEqualTo(\"Jenny\");\n }\n\n @Test\n public void externalEntity() throws Exception {\n server.enqueue(\n new MockResponse()\n .setBody(\n \"\"\n + \"\"\n + \"\"\n + \"]>\"\n + \"\"\n + \"&secret;\"\n + \"\"));\n server.enqueue(new MockResponse().setBody(\"hello\"));\n\n Call call = service.getXml();\n try {\n Response response = call.execute();\n response.body();\n fail();\n } catch (RuntimeException expected) {\n assertThat(expected).hasMessageThat().contains(\"ParseError\");\n }\n\n assertThat(server.getRequestCount()).isEqualTo(1);\n }\n\n @Test\n public void externalDtd() throws Exception {\n server.enqueue(\n new MockResponse()\n .setBody(\n \"\"\n + \"\"\n + \"\"\n + \"\"\n + \"&secret;\"\n + \"\"));\n server.enqueue(\n new MockResponse()\n .setBody(\n \"\"\n + \"\\n\"\n + \"\\n\"\n + \"\"));\n\n Call call = service.getXml();\n try {\n Response response = call.execute();\n response.body();\n fail();\n } catch (RuntimeException expected) {\n assertThat(expected).hasMessageThat().contains(\"ParseError\");\n }\n\n assertThat(server.getRequestCount()).isEqualTo(1);\n }\n}\n" }, { "path": "retrofit-converters/jaxb/src/test/java/retrofit2/converter/jaxb/PhoneNumber.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jaxb;\n\nimport java.util.Arrays;\nimport javax.annotation.Nullable;\nimport javax.xml.bind.annotation.XmlAttribute;\nimport javax.xml.bind.annotation.XmlElement;\n\nfinal class PhoneNumber {\n @XmlElement(required = true)\n public final String number;\n\n @XmlAttribute public final Type type;\n\n @SuppressWarnings(\"unused\") // Used by JAXB.\n private PhoneNumber() {\n this(\"\", Type.OTHER);\n }\n\n PhoneNumber(String number, @Nullable Type type) {\n this.number = number;\n this.type = type;\n }\n\n @Override\n public boolean equals(Object o) {\n return o instanceof PhoneNumber\n && ((PhoneNumber) o).number.equals(number)\n && ((PhoneNumber) o).type.equals(type);\n }\n\n @Override\n public int hashCode() {\n return Arrays.asList(number, type).hashCode();\n }\n}\n" }, { "path": "retrofit-converters/jaxb/src/test/java/retrofit2/converter/jaxb/Type.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jaxb;\n\nenum Type {\n OTHER,\n MOBILE\n}\n" }, { "path": "retrofit-converters/jaxb3/README.md", "content": "JAXB Converter\n==============\n\nA `Converter` which uses [JAXB][1] 3.x (`jakarta.xml.bind` package) for serialization to and from XML.\n\nA default `JAXBContext` instance will be created or one can be configured and passed\nto `JaxbConverterFactory.create()` to further control the serialization.\n\n**Note that JAXB does not work on Android.**\n\nDownload\n--------\n\nDownload [the latest JAR][2] or grab via [Maven][3]:\n```xml\n\n com.squareup.retrofit2\n converter-jaxb3\n latest.version\n\n```\nor [Gradle][3]:\n```groovy\nimplementation 'com.squareup.retrofit2:converter-jaxb3:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n\n [1]: https://github.com/eclipse-ee4j/jaxb-ri\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=converter-jaxb3&v=LATEST\n [3]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22converter-jaxb%322\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-converters/jaxb3/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n api libs.jaxb3Api\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.jaxb3Impl\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.okhttp.mockwebserver\n testImplementation libs.findBugsAnnotations\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.converter.jaxb3'\n }\n}\n" }, { "path": "retrofit-converters/jaxb3/gradle.properties", "content": "POM_ARTIFACT_ID=converter-jaxb3\nPOM_NAME=Converter: JAXB3\nPOM_DESCRIPTION=A Retrofit Converter which uses JAXB 3 for serialization.\n" }, { "path": "retrofit-converters/jaxb3/src/main/java/retrofit2/converter/jaxb3/JaxbConverterFactory.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jaxb3;\n\nimport jakarta.xml.bind.JAXBContext;\nimport jakarta.xml.bind.JAXBException;\nimport jakarta.xml.bind.annotation.XmlRootElement;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\n/**\n * A {@linkplain Converter.Factory converter} which uses JAXB for XML. All validation events are\n * ignored.\n */\npublic final class JaxbConverterFactory extends Converter.Factory {\n static final MediaType XML = MediaType.get(\"application/xml; charset=utf-8\");\n\n /** Create an instance using a default {@link JAXBContext} instance for conversion. */\n public static JaxbConverterFactory create() {\n return new JaxbConverterFactory(null);\n }\n\n /** Create an instance using {@code context} for conversion. */\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static JaxbConverterFactory create(JAXBContext context) {\n if (context == null) throw new NullPointerException(\"context == null\");\n return new JaxbConverterFactory(context);\n }\n\n /** If null, a new JAXB context will be created for each type to be converted. */\n private final @Nullable JAXBContext context;\n\n private JaxbConverterFactory(@Nullable JAXBContext context) {\n this.context = context;\n }\n\n @Override\n public @Nullable Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n if (type instanceof Class && ((Class) type).isAnnotationPresent(XmlRootElement.class)) {\n return new JaxbRequestConverter<>(contextForType((Class) type), (Class) type);\n }\n return null;\n }\n\n @Override\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n if (type instanceof Class && ((Class) type).isAnnotationPresent(XmlRootElement.class)) {\n return new JaxbResponseConverter<>(contextForType((Class) type), (Class) type);\n }\n return null;\n }\n\n private JAXBContext contextForType(Class type) {\n try {\n return context != null ? context : JAXBContext.newInstance(type);\n } catch (JAXBException e) {\n throw new IllegalArgumentException(e);\n }\n }\n}\n" }, { "path": "retrofit-converters/jaxb3/src/main/java/retrofit2/converter/jaxb3/JaxbRequestConverter.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jaxb3;\n\nimport jakarta.xml.bind.JAXBContext;\nimport jakarta.xml.bind.JAXBException;\nimport jakarta.xml.bind.Marshaller;\nimport java.io.IOException;\nimport javax.xml.stream.XMLOutputFactory;\nimport javax.xml.stream.XMLStreamException;\nimport javax.xml.stream.XMLStreamWriter;\nimport okhttp3.RequestBody;\nimport okio.Buffer;\nimport retrofit2.Converter;\n\nfinal class JaxbRequestConverter implements Converter {\n final XMLOutputFactory xmlOutputFactory = XMLOutputFactory.newInstance();\n final JAXBContext context;\n final Class type;\n\n JaxbRequestConverter(JAXBContext context, Class type) {\n this.context = context;\n this.type = type;\n }\n\n @Override\n public RequestBody convert(final T value) throws IOException {\n Buffer buffer = new Buffer();\n try {\n Marshaller marshaller = context.createMarshaller();\n\n XMLStreamWriter xmlWriter =\n xmlOutputFactory.createXMLStreamWriter(\n buffer.outputStream(), JaxbConverterFactory.XML.charset().name());\n marshaller.marshal(value, xmlWriter);\n } catch (JAXBException | XMLStreamException e) {\n throw new RuntimeException(e);\n }\n return RequestBody.create(JaxbConverterFactory.XML, buffer.readByteString());\n }\n}\n" }, { "path": "retrofit-converters/jaxb3/src/main/java/retrofit2/converter/jaxb3/JaxbResponseConverter.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jaxb3;\n\nimport jakarta.xml.bind.JAXBContext;\nimport jakarta.xml.bind.JAXBException;\nimport jakarta.xml.bind.Unmarshaller;\nimport java.io.IOException;\nimport javax.xml.stream.XMLInputFactory;\nimport javax.xml.stream.XMLStreamException;\nimport javax.xml.stream.XMLStreamReader;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\n\nfinal class JaxbResponseConverter implements Converter {\n final XMLInputFactory xmlInputFactory = XMLInputFactory.newInstance();\n final JAXBContext context;\n final Class type;\n\n JaxbResponseConverter(JAXBContext context, Class type) {\n this.context = context;\n this.type = type;\n\n // Prevent XML External Entity attacks (XXE).\n xmlInputFactory.setProperty(XMLInputFactory.IS_SUPPORTING_EXTERNAL_ENTITIES, false);\n xmlInputFactory.setProperty(XMLInputFactory.SUPPORT_DTD, false);\n }\n\n @Override\n public T convert(ResponseBody value) throws IOException {\n try {\n Unmarshaller unmarshaller = context.createUnmarshaller();\n XMLStreamReader streamReader = xmlInputFactory.createXMLStreamReader(value.charStream());\n return unmarshaller.unmarshal(streamReader, type).getValue();\n } catch (JAXBException | XMLStreamException e) {\n throw new RuntimeException(e);\n } finally {\n value.close();\n }\n }\n}\n" }, { "path": "retrofit-converters/jaxb3/src/main/java/retrofit2/converter/jaxb3/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.converter.jaxb3;\n" }, { "path": "retrofit-converters/jaxb3/src/test/java/retrofit2/converter/jaxb3/Contact.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jaxb3;\n\nimport jakarta.xml.bind.annotation.XmlElement;\nimport jakarta.xml.bind.annotation.XmlRootElement;\nimport java.util.ArrayList;\nimport java.util.Arrays;\nimport java.util.List;\n\n@XmlRootElement(name = \"contact\")\nfinal class Contact {\n @XmlElement(required = true)\n public final String name;\n\n @XmlElement(name = \"phone_number\")\n public final List phone_numbers;\n\n @SuppressWarnings(\"unused\") // Used by JAXB.\n private Contact() {\n this(\"\", new ArrayList());\n }\n\n public Contact(String name, List phoneNumbers) {\n this.name = name;\n this.phone_numbers = phoneNumbers;\n }\n\n @Override\n public boolean equals(Object o) {\n return o instanceof Contact\n && ((Contact) o).name.equals(name)\n && ((Contact) o).phone_numbers.equals(phone_numbers);\n }\n\n @Override\n public int hashCode() {\n return Arrays.asList(name, phone_numbers).hashCode();\n }\n}\n" }, { "path": "retrofit-converters/jaxb3/src/test/java/retrofit2/converter/jaxb3/JaxbConverterFactoryTest.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jaxb3;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static junit.framework.TestCase.fail;\n\nimport jakarta.xml.bind.JAXBContext;\nimport java.util.Collections;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport okhttp3.mockwebserver.RecordedRequest;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Call;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.Body;\nimport retrofit2.http.GET;\nimport retrofit2.http.POST;\n\npublic final class JaxbConverterFactoryTest {\n static final Contact SAMPLE_CONTACT =\n new Contact(\"Jenny\", Collections.singletonList(new PhoneNumber(\"867-5309\", Type.MOBILE)));\n\n static final String SAMPLE_CONTACT_XML =\n \"\"\n + \"\"\n + \"\"\n + \"Jenny\"\n + \"\"\n + \"867-5309\"\n + \"\"\n + \"\";\n\n interface Service {\n @POST(\"/\")\n Call postXml(@Body Contact contact);\n\n @GET(\"/\")\n Call getXml();\n }\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private Service service;\n\n @Before\n public void setUp() {\n JaxbConverterFactory factory = JaxbConverterFactory.create();\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).addConverterFactory(factory).build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void xmlRequestBody() throws Exception {\n server.enqueue(new MockResponse());\n\n Call call = service.postXml(SAMPLE_CONTACT);\n call.execute();\n\n RecordedRequest request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/xml; charset=utf-8\");\n assertThat(request.getBody().readUtf8()).isEqualTo(SAMPLE_CONTACT_XML);\n }\n\n @Test\n public void xmlResponseBody() throws Exception {\n server.enqueue(new MockResponse().setBody(SAMPLE_CONTACT_XML));\n\n Call call = service.getXml();\n Response response = call.execute();\n assertThat(response.body()).isEqualTo(SAMPLE_CONTACT);\n }\n\n @Test\n public void characterEncoding() throws Exception {\n server.enqueue(\n new MockResponse()\n .setBody(\n \"\"\n + \"\"\n + \"\"\n + \"Бронтозавр \\uD83E\\uDD95 ティラノサウルス・レックス 🦖\"\n + \"\"));\n\n Call call = service.getXml();\n Response response = call.execute();\n assertThat(response.body().name)\n .isEqualTo(\"Бронтозавр \\uD83E\\uDD95 ティラノサウルス・レックス \\uD83E\\uDD96\");\n }\n\n @Test\n public void userSuppliedJaxbContext() throws Exception {\n JAXBContext context = JAXBContext.newInstance(Contact.class);\n JaxbConverterFactory factory = JaxbConverterFactory.create(context);\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).addConverterFactory(factory).build();\n service = retrofit.create(Service.class);\n\n server.enqueue(new MockResponse());\n\n Call call = service.postXml(SAMPLE_CONTACT);\n call.execute();\n\n RecordedRequest request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/xml; charset=utf-8\");\n assertThat(request.getBody().readUtf8()).isEqualTo(SAMPLE_CONTACT_XML);\n }\n\n @Test\n public void malformedXml() throws Exception {\n server.enqueue(new MockResponse().setBody(\"This is not XML\"));\n\n Call call = service.getXml();\n try {\n call.execute();\n fail();\n } catch (RuntimeException expected) {\n assertThat(expected).hasMessageThat().contains(\"ParseError\");\n }\n }\n\n @Test\n public void unrecognizedField() throws Exception {\n server.enqueue(\n new MockResponse()\n .setBody(\n \"\"\n + \"\"\n + \"\"\n + \"Jenny\"\n + \"21\"\n + \"\"\n + \"867-5309\"\n + \"\"\n + \"\"));\n\n Call call = service.getXml();\n Response response = call.execute();\n assertThat(response.body().name).isEqualTo(\"Jenny\");\n }\n\n @Test\n public void externalEntity() throws Exception {\n server.enqueue(\n new MockResponse()\n .setBody(\n \"\"\n + \"\"\n + \"\"\n + \"]>\"\n + \"\"\n + \"&secret;\"\n + \"\"));\n server.enqueue(new MockResponse().setBody(\"hello\"));\n\n Call call = service.getXml();\n try {\n Response response = call.execute();\n response.body();\n fail();\n } catch (RuntimeException expected) {\n assertThat(expected).hasMessageThat().contains(\"ParseError\");\n }\n\n assertThat(server.getRequestCount()).isEqualTo(1);\n }\n\n @Test\n public void externalDtd() throws Exception {\n server.enqueue(\n new MockResponse()\n .setBody(\n \"\"\n + \"\"\n + \"\"\n + \"\"\n + \"&secret;\"\n + \"\"));\n server.enqueue(\n new MockResponse()\n .setBody(\n \"\"\n + \"\\n\"\n + \"\\n\"\n + \"\"));\n\n Call call = service.getXml();\n try {\n Response response = call.execute();\n response.body();\n fail();\n } catch (RuntimeException expected) {\n assertThat(expected).hasMessageThat().contains(\"ParseError\");\n }\n\n assertThat(server.getRequestCount()).isEqualTo(1);\n }\n}\n" }, { "path": "retrofit-converters/jaxb3/src/test/java/retrofit2/converter/jaxb3/PhoneNumber.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jaxb3;\n\nimport jakarta.xml.bind.annotation.XmlAttribute;\nimport jakarta.xml.bind.annotation.XmlElement;\nimport java.util.Arrays;\nimport javax.annotation.Nullable;\n\nfinal class PhoneNumber {\n @XmlElement(required = true)\n public final String number;\n\n @XmlAttribute public final Type type;\n\n @SuppressWarnings(\"unused\") // Used by JAXB.\n private PhoneNumber() {\n this(\"\", Type.OTHER);\n }\n\n PhoneNumber(String number, @Nullable Type type) {\n this.number = number;\n this.type = type;\n }\n\n @Override\n public boolean equals(Object o) {\n return o instanceof PhoneNumber\n && ((PhoneNumber) o).number.equals(number)\n && ((PhoneNumber) o).type.equals(type);\n }\n\n @Override\n public int hashCode() {\n return Arrays.asList(number, type).hashCode();\n }\n}\n" }, { "path": "retrofit-converters/jaxb3/src/test/java/retrofit2/converter/jaxb3/Type.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.jaxb3;\n\nenum Type {\n OTHER,\n MOBILE\n}\n" }, { "path": "retrofit-converters/kotlinx-serialization/README.md", "content": "# kotlinx.serialization Converter\n\nA `Converter` which uses [kotlinx.serialization][1] for serialization.\n\nGiven a `TextFormat` or `BinaryFormat`, call `asConverterFactory()` in order to\ncreate a `Converter.Factory`. You will need to supply a `MediaType` for use as the\n`Content-Type` header for request bodies.\n\n```kotlin\nval retrofit = Retrofit.Builder()\n .baseUrl(\"https://example.com/\")\n .addConverterFactory(\n Json.asConverterFactory(\n \"application/json; charset=utf-8\".toMediaType()))\n .build()\n```\n\n\n## Download\n\nDownload [the latest JAR][2] or grab via [Maven][3]:\n```xml\n\n com.squareup.retrofit2\n converter-kotlinx-serialization\n latest.version\n\n```\nor [Gradle][3]:\n```groovy\nimplementation 'com.squareup.retrofit2:converter-kotlinx-serialization:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n\n [1]: https://github.com/Kotlin/kotlinx.serialization\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=converter-kotlinx-serialization&v=LATEST\n [3]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22converter-kotlinx-serialization%22\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-converters/kotlinx-serialization/build.gradle", "content": "apply plugin: 'org.jetbrains.kotlin.jvm'\napply plugin: 'org.jetbrains.kotlin.plugin.serialization'\napply plugin: 'com.vanniktech.maven.publish'\napply plugin: 'org.jetbrains.dokka'\n\ndependencies {\n api projects.retrofit\n api libs.kotlinx.serialization.core\n\n testImplementation libs.junit\n testImplementation libs.okhttp.mockwebserver\n testImplementation libs.kotlinx.serialization.proto\n testImplementation libs.kotlinx.serialization.json\n}\n" }, { "path": "retrofit-converters/kotlinx-serialization/gradle.properties", "content": "POM_ARTIFACT_ID=converter-kotlinx-serialization\nPOM_NAME=Converter: kotlinx.serialization\nPOM_DESCRIPTION=A Retrofit Converter which uses kotlinx.serialization for serialization.\n" }, { "path": "retrofit-converters/kotlinx-serialization/src/main/java/retrofit2/converter/kotlinx/serialization/DeserializationStrategyConverter.kt", "content": "package retrofit2.converter.kotlinx.serialization\n\nimport kotlinx.serialization.DeserializationStrategy\nimport okhttp3.ResponseBody\nimport retrofit2.Converter\n\ninternal class DeserializationStrategyConverter(\n private val loader: DeserializationStrategy,\n private val serializer: Serializer\n) : Converter {\n override fun convert(value: ResponseBody) = serializer.fromResponseBody(loader, value)\n}\n" }, { "path": "retrofit-converters/kotlinx-serialization/src/main/java/retrofit2/converter/kotlinx/serialization/Factory.kt", "content": "@file:JvmName(\"KotlinSerializationConverterFactory\")\n\npackage retrofit2.converter.kotlinx.serialization\n\nimport retrofit2.converter.kotlinx.serialization.Serializer.FromBytes\nimport retrofit2.converter.kotlinx.serialization.Serializer.FromString\nimport java.lang.reflect.Type\nimport kotlinx.serialization.BinaryFormat\nimport kotlinx.serialization.StringFormat\nimport okhttp3.MediaType\nimport okhttp3.RequestBody\nimport okhttp3.ResponseBody\nimport retrofit2.Converter\nimport retrofit2.Retrofit\n\ninternal class Factory(\n private val contentType: MediaType,\n private val serializer: Serializer\n) : Converter.Factory() {\n @Suppress(\"RedundantNullableReturnType\") // Retaining interface contract.\n override fun responseBodyConverter(\n type: Type,\n annotations: Array,\n retrofit: Retrofit\n ): Converter? {\n val loader = serializer.serializer(type)\n return DeserializationStrategyConverter(loader, serializer)\n }\n\n @Suppress(\"RedundantNullableReturnType\") // Retaining interface contract.\n override fun requestBodyConverter(\n type: Type,\n parameterAnnotations: Array,\n methodAnnotations: Array,\n retrofit: Retrofit\n ): Converter<*, RequestBody>? {\n val saver = serializer.serializer(type)\n return SerializationStrategyConverter(contentType, saver, serializer)\n }\n}\n\n/**\n * Return a [Converter.Factory] which uses Kotlin serialization for string-based payloads.\n *\n * Because Kotlin serialization is so flexible in the types it supports, this converter assumes\n * that it can handle all types. If you are mixing this with something else, you must add this\n * instance last to allow the other converters a chance to see their types.\n */\n@JvmName(\"create\")\nfun StringFormat.asConverterFactory(contentType: MediaType): Converter.Factory {\n return Factory(contentType, FromString(this))\n}\n\n/**\n * Return a [Converter.Factory] which uses Kotlin serialization for byte-based payloads.\n *\n * Because Kotlin serialization is so flexible in the types it supports, this converter assumes\n * that it can handle all types. If you are mixing this with something else, you must add this\n * instance last to allow the other converters a chance to see their types.\n */\n@JvmName(\"create\")\nfun BinaryFormat.asConverterFactory(contentType: MediaType): Converter.Factory {\n return Factory(contentType, FromBytes(this))\n}\n" }, { "path": "retrofit-converters/kotlinx-serialization/src/main/java/retrofit2/converter/kotlinx/serialization/SerializationStrategyConverter.kt", "content": "package retrofit2.converter.kotlinx.serialization\n\nimport kotlinx.serialization.SerializationStrategy\nimport okhttp3.MediaType\nimport okhttp3.RequestBody\nimport retrofit2.Converter\n\ninternal class SerializationStrategyConverter(\n private val contentType: MediaType,\n private val saver: SerializationStrategy,\n private val serializer: Serializer\n) : Converter {\n override fun convert(value: T) = serializer.toRequestBody(contentType, saver, value)\n}\n" }, { "path": "retrofit-converters/kotlinx-serialization/src/main/java/retrofit2/converter/kotlinx/serialization/Serializer.kt", "content": "package retrofit2.converter.kotlinx.serialization\n\nimport java.lang.reflect.Type\nimport kotlinx.serialization.BinaryFormat\nimport kotlinx.serialization.DeserializationStrategy\nimport kotlinx.serialization.KSerializer\nimport kotlinx.serialization.SerialFormat\nimport kotlinx.serialization.SerializationStrategy\nimport kotlinx.serialization.StringFormat\nimport kotlinx.serialization.serializer\nimport okhttp3.MediaType\nimport okhttp3.RequestBody\nimport okhttp3.RequestBody.Companion.toRequestBody\nimport okhttp3.ResponseBody\n\ninternal sealed class Serializer {\n abstract fun fromResponseBody(loader: DeserializationStrategy, body: ResponseBody): T\n abstract fun toRequestBody(contentType: MediaType, saver: SerializationStrategy, value: T): RequestBody\n\n protected abstract val format: SerialFormat\n\n fun serializer(type: Type): KSerializer = format.serializersModule.serializer(type)\n\n class FromString(override val format: StringFormat) : Serializer() {\n override fun fromResponseBody(loader: DeserializationStrategy, body: ResponseBody): T {\n val string = body.string()\n return format.decodeFromString(loader, string)\n }\n\n override fun toRequestBody(contentType: MediaType, saver: SerializationStrategy, value: T): RequestBody {\n val string = format.encodeToString(saver, value)\n return string.toRequestBody(contentType)\n }\n }\n\n class FromBytes(override val format: BinaryFormat) : Serializer() {\n override fun fromResponseBody(loader: DeserializationStrategy, body: ResponseBody): T {\n val bytes = body.bytes()\n return format.decodeFromByteArray(loader, bytes)\n }\n\n override fun toRequestBody(contentType: MediaType, saver: SerializationStrategy, value: T): RequestBody {\n val bytes = format.encodeToByteArray(saver, value)\n return bytes.toRequestBody(contentType, 0, bytes.size)\n }\n }\n}\n" }, { "path": "retrofit-converters/kotlinx-serialization/src/test/java/retrofit2/converter/kotlinx/serialization/KotlinSerializationConverterFactoryBytesTest.kt", "content": "package retrofit2.converter.kotlinx.serialization\n\nimport kotlinx.serialization.ExperimentalSerializationApi\nimport kotlinx.serialization.Serializable\nimport kotlinx.serialization.protobuf.ProtoBuf\nimport kotlinx.serialization.protobuf.ProtoNumber\nimport okhttp3.MediaType\nimport okhttp3.MediaType.Companion.toMediaType\nimport okhttp3.mockwebserver.MockResponse\nimport okhttp3.mockwebserver.MockWebServer\nimport okio.Buffer\nimport okio.ByteString\nimport org.junit.Assert.assertEquals\nimport org.junit.Before\nimport org.junit.Rule\nimport org.junit.Test\nimport retrofit2.Call\nimport retrofit2.Retrofit\nimport retrofit2.http.Body\nimport retrofit2.http.GET\nimport retrofit2.http.POST\n\nprivate val bobBytes = ByteString.of(0x0a, 0x03, 'B'.code.toByte(), 'o'.code.toByte(), 'b'.code.toByte())\n\n@ExperimentalSerializationApi\nclass KotlinSerializationConverterFactoryBytesTest {\n @get:Rule val server = MockWebServer()\n\n private lateinit var service: Service\n\n interface Service {\n @GET(\"/\") fun deserialize(): Call\n @POST(\"/\") fun serialize(@Body user: User): Call\n }\n\n @Serializable\n data class User(@ProtoNumber(1) val name: String)\n\n @Before fun setUp() {\n val contentType = \"application/x-protobuf\".toMediaType()\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(ProtoBuf.asConverterFactory(contentType))\n .build()\n service = retrofit.create(Service::class.java)\n }\n\n @Test fun deserialize() {\n server.enqueue(MockResponse().setBody(Buffer().write(bobBytes)))\n val user = service.deserialize().execute().body()!!\n assertEquals(User(\"Bob\"), user)\n }\n\n @Test fun serialize() {\n server.enqueue(MockResponse())\n service.serialize(User(\"Bob\")).execute()\n val request = server.takeRequest()\n assertEquals(bobBytes, request.body.readByteString())\n assertEquals(\"application/x-protobuf\", request.headers[\"Content-Type\"])\n }\n}\n" }, { "path": "retrofit-converters/kotlinx-serialization/src/test/java/retrofit2/converter/kotlinx/serialization/KotlinSerializationConverterFactoryStringTest.kt", "content": "package retrofit2.converter.kotlinx.serialization\n\nimport kotlinx.serialization.Serializable\nimport kotlinx.serialization.json.Json\nimport okhttp3.MediaType\nimport okhttp3.MediaType.Companion.toMediaType\nimport okhttp3.mockwebserver.MockResponse\nimport okhttp3.mockwebserver.MockWebServer\nimport org.junit.Assert.assertEquals\nimport org.junit.Before\nimport org.junit.Rule\nimport org.junit.Test\nimport retrofit2.Call\nimport retrofit2.Retrofit\nimport retrofit2.http.Body\nimport retrofit2.http.GET\nimport retrofit2.http.POST\n\nclass KotlinSerializationConverterFactoryStringTest {\n @get:Rule val server = MockWebServer()\n\n private lateinit var service: Service\n\n interface Service {\n @GET(\"/\") fun deserialize(): Call\n @POST(\"/\") fun serialize(@Body user: User): Call\n }\n\n @Serializable\n data class User(val name: String)\n\n @Before fun setUp() {\n val contentType = \"application/json; charset=utf-8\".toMediaType()\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(Json.asConverterFactory(contentType))\n .build()\n service = retrofit.create(Service::class.java)\n }\n\n @Test fun deserialize() {\n server.enqueue(MockResponse().setBody(\"\"\"{\"name\":\"Bob\"}\"\"\"))\n val user = service.deserialize().execute().body()!!\n assertEquals(User(\"Bob\"), user)\n }\n\n @Test fun serialize() {\n server.enqueue(MockResponse())\n service.serialize(User(\"Bob\")).execute()\n val request = server.takeRequest()\n assertEquals(\"\"\"{\"name\":\"Bob\"}\"\"\", request.body.readUtf8())\n assertEquals(\"application/json; charset=utf-8\", request.headers[\"Content-Type\"])\n }\n}\n" }, { "path": "retrofit-converters/kotlinx-serialization/src/test/java/retrofit2/converter/kotlinx/serialization/KotlinxSerializationConverterFactoryContextualListTest.kt", "content": "package retrofit2.converter.kotlinx.serialization\n\nimport kotlinx.serialization.KSerializer\nimport kotlinx.serialization.Serializable\nimport kotlinx.serialization.descriptors.PrimitiveKind\nimport kotlinx.serialization.descriptors.PrimitiveSerialDescriptor\nimport kotlinx.serialization.encoding.Decoder\nimport kotlinx.serialization.encoding.Encoder\nimport kotlinx.serialization.json.Json\nimport kotlinx.serialization.modules.SerializersModule\nimport kotlinx.serialization.modules.contextual\nimport okhttp3.MediaType\nimport okhttp3.MediaType.Companion.toMediaType\nimport okhttp3.mockwebserver.MockResponse\nimport okhttp3.mockwebserver.MockWebServer\nimport org.junit.Assert.assertEquals\nimport org.junit.Before\nimport org.junit.Rule\nimport org.junit.Test\nimport retrofit2.Call\nimport retrofit2.Retrofit\nimport retrofit2.http.Body\nimport retrofit2.http.GET\nimport retrofit2.http.POST\n\nclass KotlinxSerializationConverterFactoryContextualListTest {\n @get:Rule\n val server = MockWebServer()\n\n private lateinit var service: Service\n\n interface Service {\n @GET(\"/\")\n fun deserialize(): Call>\n\n @POST(\"/\")\n fun serialize(@Body users: List): Call\n }\n\n data class User(val name: String)\n\n object UserSerializer : KSerializer {\n override val descriptor = PrimitiveSerialDescriptor(\"User\", PrimitiveKind.STRING)\n\n override fun deserialize(decoder: Decoder): User =\n decoder.decodeSerializableValue(UserResponse.serializer()).run {\n User(name)\n }\n\n override fun serialize(encoder: Encoder, value: User): Unit =\n encoder.encodeSerializableValue(UserResponse.serializer(), UserResponse(value.name))\n\n @Serializable\n private data class UserResponse(val name: String)\n }\n\n private val json = Json {\n serializersModule = SerializersModule {\n contextual(UserSerializer)\n }\n }\n\n @Before\n fun setUp() {\n val contentType = \"application/json; charset=utf-8\".toMediaType()\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(json.asConverterFactory(contentType))\n .build()\n service = retrofit.create(Service::class.java)\n }\n\n @Test\n fun deserialize() {\n server.enqueue(MockResponse().setBody(\"\"\"[{\"name\":\"Bob\"}]\"\"\"))\n val user = service.deserialize().execute().body()!!\n assertEquals(listOf(User(\"Bob\")), user)\n }\n\n @Test\n fun serialize() {\n server.enqueue(MockResponse())\n service.serialize(listOf(User(\"Bob\"))).execute()\n val request = server.takeRequest()\n assertEquals(\"\"\"[{\"name\":\"Bob\"}]\"\"\", request.body.readUtf8())\n assertEquals(\"application/json; charset=utf-8\", request.headers[\"Content-Type\"])\n }\n}\n" }, { "path": "retrofit-converters/kotlinx-serialization/src/test/java/retrofit2/converter/kotlinx/serialization/KotlinxSerializationConverterFactoryContextualTest.kt", "content": "package retrofit2.converter.kotlinx.serialization\n\nimport kotlinx.serialization.KSerializer\nimport kotlinx.serialization.Serializable\nimport kotlinx.serialization.descriptors.PrimitiveKind\nimport kotlinx.serialization.descriptors.PrimitiveSerialDescriptor\nimport kotlinx.serialization.encoding.Decoder\nimport kotlinx.serialization.encoding.Encoder\nimport kotlinx.serialization.json.Json\nimport kotlinx.serialization.modules.SerializersModule\nimport kotlinx.serialization.modules.contextual\nimport okhttp3.MediaType\nimport okhttp3.MediaType.Companion.toMediaType\nimport okhttp3.mockwebserver.MockResponse\nimport okhttp3.mockwebserver.MockWebServer\nimport org.junit.Assert.assertEquals\nimport org.junit.Before\nimport org.junit.Rule\nimport org.junit.Test\nimport retrofit2.Call\nimport retrofit2.Retrofit\nimport retrofit2.http.Body\nimport retrofit2.http.GET\nimport retrofit2.http.POST\n\nclass KotlinxSerializationConverterFactoryContextualTest {\n @get:Rule\n val server = MockWebServer()\n\n private lateinit var service: Service\n\n interface Service {\n @GET(\"/\")\n fun deserialize(): Call\n\n @POST(\"/\")\n fun serialize(@Body user: User): Call\n }\n\n data class User(val name: String)\n\n object UserSerializer : KSerializer {\n override val descriptor = PrimitiveSerialDescriptor(\"User\", PrimitiveKind.STRING)\n\n override fun deserialize(decoder: Decoder): User =\n decoder.decodeSerializableValue(UserResponse.serializer()).run {\n User(name)\n }\n\n override fun serialize(encoder: Encoder, value: User): Unit =\n encoder.encodeSerializableValue(UserResponse.serializer(), UserResponse(value.name))\n\n @Serializable\n private data class UserResponse(val name: String)\n }\n\n private val json = Json {\n serializersModule = SerializersModule {\n contextual(UserSerializer)\n }\n }\n\n @Before\n fun setUp() {\n val contentType = \"application/json; charset=utf-8\".toMediaType()\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(json.asConverterFactory(contentType))\n .build()\n service = retrofit.create(Service::class.java)\n }\n\n @Test\n fun deserialize() {\n server.enqueue(MockResponse().setBody(\"\"\"{\"name\":\"Bob\"}\"\"\"))\n val user = service.deserialize().execute().body()!!\n assertEquals(User(\"Bob\"), user)\n }\n\n @Test\n fun serialize() {\n server.enqueue(MockResponse())\n service.serialize(User(\"Bob\")).execute()\n val request = server.takeRequest()\n assertEquals(\"\"\"{\"name\":\"Bob\"}\"\"\", request.body.readUtf8())\n assertEquals(\"application/json; charset=utf-8\", request.headers[\"Content-Type\"])\n }\n}\n" }, { "path": "retrofit-converters/moshi/README.md", "content": "Moshi Converter\n===============\n\nA `Converter` which uses [Moshi][1] for serialization to and from JSON.\n\nA default `Moshi` instance will be created or one can be configured and passed to\n`MoshiConverterFactory.create()` to further control the serialization.\n\n\nDownload\n--------\n\nDownload [the latest JAR][2] or grab via [Maven][3]:\n```xml\n\n com.squareup.retrofit2\n converter-moshi\n latest.version\n\n```\nor [Gradle][3]:\n```groovy\nimplementation 'com.squareup.retrofit2:converter-moshi:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n\n [1]: https://github.com/square/moshi\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=converter-moshi&v=LATEST\n [3]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22converter-moshi%22\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-converters/moshi/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n api libs.moshi\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.okhttp.mockwebserver\n testImplementation libs.testParameterInjector\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.converter.moshi'\n }\n}\n" }, { "path": "retrofit-converters/moshi/gradle.properties", "content": "POM_ARTIFACT_ID=converter-moshi\nPOM_NAME=Converter: Moshi\nPOM_DESCRIPTION=A Retrofit Converter which uses Moshi for serialization.\n" }, { "path": "retrofit-converters/moshi/src/main/java/retrofit2/converter/moshi/MoshiConverterFactory.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.moshi;\n\nimport static java.util.Collections.unmodifiableSet;\n\nimport com.squareup.moshi.JsonAdapter;\nimport com.squareup.moshi.JsonQualifier;\nimport com.squareup.moshi.Moshi;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport java.util.Collections;\nimport java.util.LinkedHashSet;\nimport java.util.Set;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Call;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\n/**\n * A {@linkplain Converter.Factory converter} which uses Moshi for JSON.\n *\n *

Because Moshi is so flexible in the types it supports, this converter assumes that it can\n * handle all types. If you are mixing JSON serialization with something else (such as protocol\n * buffers), you must {@linkplain Retrofit.Builder#addConverterFactory(Converter.Factory) add this\n * instance} last to allow the other converters a chance to see their types.\n *\n *

Any {@link JsonQualifier @JsonQualifier}-annotated annotations on the parameter will be used\n * when looking up a request body converter and those on the method will be used when looking up a\n * response body converter.\n */\npublic final class MoshiConverterFactory extends Converter.Factory {\n /** Create an instance using a default {@link Moshi} instance for conversion. */\n public static MoshiConverterFactory create() {\n return create(new Moshi.Builder().build());\n }\n\n /** Create an instance using {@code moshi} for conversion. */\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static MoshiConverterFactory create(Moshi moshi) {\n if (moshi == null) throw new NullPointerException(\"moshi == null\");\n return new MoshiConverterFactory(moshi, false, false, false, false);\n }\n\n private final Moshi moshi;\n private final boolean lenient;\n private final boolean failOnUnknown;\n private final boolean serializeNulls;\n private final boolean streaming;\n\n private MoshiConverterFactory(\n Moshi moshi,\n boolean lenient,\n boolean failOnUnknown,\n boolean serializeNulls,\n boolean streaming) {\n this.moshi = moshi;\n this.lenient = lenient;\n this.failOnUnknown = failOnUnknown;\n this.serializeNulls = serializeNulls;\n this.streaming = streaming;\n }\n\n /** Return a new factory which uses {@linkplain JsonAdapter#lenient() lenient} adapters. */\n public MoshiConverterFactory asLenient() {\n return new MoshiConverterFactory(moshi, true, failOnUnknown, serializeNulls, streaming);\n }\n\n /** Return a new factory which uses {@link JsonAdapter#failOnUnknown()} adapters. */\n public MoshiConverterFactory failOnUnknown() {\n return new MoshiConverterFactory(moshi, lenient, true, serializeNulls, streaming);\n }\n\n /** Return a new factory which includes null values into the serialized JSON. */\n public MoshiConverterFactory withNullSerialization() {\n return new MoshiConverterFactory(moshi, lenient, failOnUnknown, true, streaming);\n }\n\n /**\n * Return a new factory which streams serialization of request messages to bytes on the HTTP thread\n * This is either the calling thread for {@link Call#execute()}, or one of OkHttp's background\n * threads for {@link Call#enqueue}. Response bytes are always converted to message instances on\n * one of OkHttp's background threads.\n */\n public MoshiConverterFactory withStreaming() {\n return new MoshiConverterFactory(moshi, lenient, failOnUnknown, serializeNulls, true);\n }\n\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n JsonAdapter adapter = moshi.adapter(type, jsonAnnotations(annotations));\n if (lenient) {\n adapter = adapter.lenient();\n }\n if (failOnUnknown) {\n adapter = adapter.failOnUnknown();\n }\n if (serializeNulls) {\n adapter = adapter.serializeNulls();\n }\n return new MoshiResponseBodyConverter<>(adapter);\n }\n\n @Override\n public Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n JsonAdapter adapter = moshi.adapter(type, jsonAnnotations(parameterAnnotations));\n if (lenient) {\n adapter = adapter.lenient();\n }\n if (failOnUnknown) {\n adapter = adapter.failOnUnknown();\n }\n if (serializeNulls) {\n adapter = adapter.serializeNulls();\n }\n return new MoshiRequestBodyConverter<>(adapter, streaming);\n }\n\n private static Set jsonAnnotations(Annotation[] annotations) {\n Set result = null;\n for (Annotation annotation : annotations) {\n if (annotation.annotationType().isAnnotationPresent(JsonQualifier.class)) {\n if (result == null) result = new LinkedHashSet<>();\n result.add(annotation);\n }\n }\n return result != null ? unmodifiableSet(result) : Collections.emptySet();\n }\n}\n" }, { "path": "retrofit-converters/moshi/src/main/java/retrofit2/converter/moshi/MoshiRequestBodyConverter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.moshi;\n\nimport com.squareup.moshi.JsonAdapter;\nimport com.squareup.moshi.JsonWriter;\nimport java.io.IOException;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okio.Buffer;\nimport retrofit2.Converter;\n\nfinal class MoshiRequestBodyConverter implements Converter {\n static final MediaType MEDIA_TYPE = MediaType.get(\"application/json; charset=UTF-8\");\n\n private final JsonAdapter adapter;\n private final boolean streaming;\n\n MoshiRequestBodyConverter(JsonAdapter adapter, boolean streaming) {\n this.adapter = adapter;\n this.streaming = streaming;\n }\n\n @Override\n public RequestBody convert(T value) throws IOException {\n if (streaming) {\n return new MoshiStreamingRequestBody<>(adapter, value);\n }\n\n Buffer buffer = new Buffer();\n JsonWriter writer = JsonWriter.of(buffer);\n adapter.toJson(writer, value);\n return RequestBody.create(MEDIA_TYPE, buffer.readByteString());\n }\n}\n" }, { "path": "retrofit-converters/moshi/src/main/java/retrofit2/converter/moshi/MoshiResponseBodyConverter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.moshi;\n\nimport com.squareup.moshi.JsonAdapter;\nimport com.squareup.moshi.JsonDataException;\nimport com.squareup.moshi.JsonReader;\nimport java.io.IOException;\nimport okhttp3.ResponseBody;\nimport okio.BufferedSource;\nimport okio.ByteString;\nimport retrofit2.Converter;\n\nfinal class MoshiResponseBodyConverter implements Converter {\n private static final ByteString UTF8_BOM = ByteString.decodeHex(\"EFBBBF\");\n\n private final JsonAdapter adapter;\n\n MoshiResponseBodyConverter(JsonAdapter adapter) {\n this.adapter = adapter;\n }\n\n @Override\n public T convert(ResponseBody value) throws IOException {\n BufferedSource source = value.source();\n try {\n // Moshi has no document-level API so the responsibility of BOM skipping falls to whatever\n // is delegating to it. Since it's a UTF-8-only library as well we only honor the UTF-8 BOM.\n if (source.rangeEquals(0, UTF8_BOM)) {\n source.skip(UTF8_BOM.size());\n }\n JsonReader reader = JsonReader.of(source);\n T result = adapter.fromJson(reader);\n if (reader.peek() != JsonReader.Token.END_DOCUMENT) {\n throw new JsonDataException(\"JSON document was not fully consumed.\");\n }\n return result;\n } finally {\n value.close();\n }\n }\n}\n" }, { "path": "retrofit-converters/moshi/src/main/java/retrofit2/converter/moshi/MoshiStreamingRequestBody.java", "content": "/*\n * Copyright (C) 2025 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.moshi;\n\nimport static retrofit2.converter.moshi.MoshiRequestBodyConverter.MEDIA_TYPE;\n\nimport com.squareup.moshi.JsonAdapter;\nimport java.io.IOException;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okio.BufferedSink;\n\nfinal class MoshiStreamingRequestBody extends RequestBody {\n private final JsonAdapter adapter;\n private final T value;\n\n public MoshiStreamingRequestBody(JsonAdapter adapter, T value) {\n this.adapter = adapter;\n this.value = value;\n }\n\n @Override\n public MediaType contentType() {\n return MEDIA_TYPE;\n }\n\n @Override\n public void writeTo(BufferedSink sink) throws IOException {\n adapter.toJson(sink, value);\n }\n}\n" }, { "path": "retrofit-converters/moshi/src/main/java/retrofit2/converter/moshi/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.converter.moshi;\n" }, { "path": "retrofit-converters/moshi/src/test/java/retrofit2/converter/moshi/MoshiConverterFactoryTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.moshi;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\nimport static org.junit.Assert.assertEquals;\nimport static org.junit.Assert.fail;\nimport static org.junit.Assume.assumeTrue;\n\nimport com.google.testing.junit.testparameterinjector.TestParameter;\nimport com.google.testing.junit.testparameterinjector.TestParameterInjector;\nimport com.squareup.moshi.FromJson;\nimport com.squareup.moshi.JsonDataException;\nimport com.squareup.moshi.JsonQualifier;\nimport com.squareup.moshi.JsonReader;\nimport com.squareup.moshi.JsonWriter;\nimport com.squareup.moshi.Moshi;\nimport com.squareup.moshi.ToJson;\nimport java.io.EOFException;\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.annotation.Retention;\nimport java.nio.charset.StandardCharsets;\nimport java.util.concurrent.CountDownLatch;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport okhttp3.mockwebserver.RecordedRequest;\nimport okio.Buffer;\nimport okio.ByteString;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.runner.RunWith;\nimport retrofit2.Call;\nimport retrofit2.Callback;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.Body;\nimport retrofit2.http.GET;\nimport retrofit2.http.POST;\n\n@RunWith(TestParameterInjector.class)\npublic final class MoshiConverterFactoryTest {\n @Retention(RUNTIME)\n @JsonQualifier\n @interface Qualifier {}\n\n @Retention(RUNTIME)\n @interface NonQualifer {}\n\n interface AnInterface {\n String getName();\n }\n\n static class AnImplementation implements AnInterface {\n private final String theName;\n\n AnImplementation(String name) {\n theName = name;\n }\n\n @Override\n public String getName() {\n return theName;\n }\n }\n\n static final class ErroringValue {\n final String theName;\n\n ErroringValue(String theName) {\n this.theName = theName;\n }\n }\n\n static class Adapters {\n @ToJson\n public void write(JsonWriter jsonWriter, AnInterface anInterface) throws IOException {\n jsonWriter.beginObject();\n jsonWriter.name(\"name\").value(anInterface.getName());\n jsonWriter.endObject();\n }\n\n @FromJson\n public AnInterface read(JsonReader jsonReader) throws IOException {\n jsonReader.beginObject();\n\n String name = null;\n while (jsonReader.hasNext()) {\n switch (jsonReader.nextName()) {\n case \"name\":\n name = jsonReader.nextString();\n break;\n }\n }\n\n jsonReader.endObject();\n return new AnImplementation(name);\n }\n\n @ToJson\n public void write(JsonWriter writer, @Qualifier String value) throws IOException {\n writer.value(\"qualified!\");\n }\n\n @FromJson\n @Qualifier\n public String readQualified(JsonReader reader) throws IOException {\n String string = reader.nextString();\n if (string.equals(\"qualified!\")) {\n return \"it worked!\";\n }\n throw new AssertionError(\"Found: \" + string);\n }\n\n @FromJson\n public ErroringValue readWithoutEndingObject(JsonReader reader) throws IOException {\n reader.beginObject();\n reader.skipName();\n String theName = reader.nextString();\n return new ErroringValue(theName);\n }\n\n @ToJson\n public void write(JsonWriter writer, ErroringValue value) throws IOException {\n throw new EOFException(\"oops!\");\n }\n }\n\n interface Service {\n @POST(\"/\")\n Call anImplementation(@Body AnImplementation impl);\n\n @POST(\"/\")\n Call anInterface(@Body AnInterface impl);\n\n @GET(\"/\")\n Call readErroringValue();\n\n @POST(\"/\")\n Call writeErroringValue(@Body ErroringValue value);\n\n @POST(\"/\")\n @Qualifier\n @NonQualifer //\n Call annotations(@Body @Qualifier @NonQualifer String body);\n }\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private final Service service;\n private final Service serviceLenient;\n private final Service serviceNulls;\n private final Service serviceFailOnUnknown;\n private final boolean streaming;\n\n public MoshiConverterFactoryTest(@TestParameter boolean streaming) {\n this.streaming = streaming;\n\n Moshi moshi =\n new Moshi.Builder()\n .add(\n (type, annotations, moshi1) -> {\n for (Annotation annotation : annotations) {\n if (!annotation.annotationType().isAnnotationPresent(JsonQualifier.class)) {\n throw new AssertionError(\"Non-@JsonQualifier annotation: \" + annotation);\n }\n }\n return null;\n })\n .add(new Adapters())\n .build();\n\n MoshiConverterFactory factory = MoshiConverterFactory.create(moshi);\n if (streaming) {\n factory = factory.withStreaming();\n }\n\n MoshiConverterFactory factoryLenient = factory.asLenient();\n MoshiConverterFactory factoryNulls = factory.withNullSerialization();\n MoshiConverterFactory factoryFailOnUnknown = factory.failOnUnknown();\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).addConverterFactory(factory).build();\n Retrofit retrofitLenient =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).addConverterFactory(factoryLenient).build();\n Retrofit retrofitNulls =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).addConverterFactory(factoryNulls).build();\n Retrofit retrofitFailOnUnknown =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(factoryFailOnUnknown)\n .build();\n service = retrofit.create(Service.class);\n serviceLenient = retrofitLenient.create(Service.class);\n serviceNulls = retrofitNulls.create(Service.class);\n serviceFailOnUnknown = retrofitFailOnUnknown.create(Service.class);\n }\n\n @Test\n public void anInterface() throws IOException, InterruptedException {\n server.enqueue(new MockResponse().setBody(\"{\\\"name\\\":\\\"value\\\"}\"));\n\n Call call = service.anInterface(new AnImplementation(\"value\"));\n Response response = call.execute();\n AnInterface body = response.body();\n assertThat(body.getName()).isEqualTo(\"value\");\n\n RecordedRequest request = server.takeRequest();\n assertThat(request.getBody().readUtf8()).isEqualTo(\"{\\\"name\\\":\\\"value\\\"}\");\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/json; charset=UTF-8\");\n }\n\n @Test\n public void anImplementation() throws IOException, InterruptedException {\n server.enqueue(new MockResponse().setBody(\"{\\\"theName\\\":\\\"value\\\"}\"));\n\n Call call = service.anImplementation(new AnImplementation(\"value\"));\n Response response = call.execute();\n AnImplementation body = response.body();\n assertThat(body.theName).isEqualTo(\"value\");\n\n RecordedRequest request = server.takeRequest();\n assertThat(request.getBody().readUtf8()).isEqualTo(\"{\\\"theName\\\":\\\"value\\\"}\");\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/json; charset=UTF-8\");\n }\n\n @Test\n public void annotations() throws IOException, InterruptedException {\n server.enqueue(new MockResponse().setBody(\"\\\"qualified!\\\"\"));\n\n Call call = service.annotations(\"value\");\n Response response = call.execute();\n assertThat(response.body()).isEqualTo(\"it worked!\");\n\n RecordedRequest request = server.takeRequest();\n assertThat(request.getBody().readUtf8()).isEqualTo(\"\\\"qualified!\\\"\");\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/json; charset=UTF-8\");\n }\n\n @Test\n public void asLenient() throws IOException, InterruptedException {\n MockResponse malformedResponse = new MockResponse().setBody(\"{\\\"theName\\\":value}\");\n server.enqueue(malformedResponse);\n server.enqueue(malformedResponse);\n\n Call call = service.anImplementation(new AnImplementation(\"value\"));\n try {\n call.execute();\n fail();\n } catch (IOException e) {\n assertEquals(\n e.getMessage(),\n \"Use JsonReader.setLenient(true) to accept malformed JSON at path $.theName\");\n }\n\n Call call2 = serviceLenient.anImplementation(new AnImplementation(\"value\"));\n Response response = call2.execute();\n AnImplementation body = response.body();\n assertThat(body.theName).isEqualTo(\"value\");\n }\n\n @Test\n public void withNulls() throws IOException, InterruptedException {\n server.enqueue(new MockResponse().setBody(\"{}\"));\n\n Call call = serviceNulls.anImplementation(new AnImplementation(null));\n call.execute();\n assertEquals(\"{\\\"theName\\\":null}\", server.takeRequest().getBody().readUtf8());\n }\n\n @Test\n public void failOnUnknown() throws IOException, InterruptedException {\n server.enqueue(new MockResponse().setBody(\"{\\\"taco\\\":\\\"delicious\\\"}\"));\n\n Call call = serviceFailOnUnknown.anImplementation(new AnImplementation(null));\n try {\n call.execute();\n fail();\n } catch (JsonDataException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Cannot skip unexpected NAME at $.taco\");\n }\n }\n\n @Test\n public void utf8BomSkipped() throws IOException {\n Buffer responseBody =\n new Buffer().write(ByteString.decodeHex(\"EFBBBF\")).writeUtf8(\"{\\\"theName\\\":\\\"value\\\"}\");\n MockResponse malformedResponse = new MockResponse().setBody(responseBody);\n server.enqueue(malformedResponse);\n\n Call call = service.anImplementation(new AnImplementation(\"value\"));\n Response response = call.execute();\n AnImplementation body = response.body();\n assertThat(body.theName).isEqualTo(\"value\");\n }\n\n @Test\n public void nonUtf8BomIsNotSkipped() throws IOException {\n Buffer responseBody =\n new Buffer()\n .write(ByteString.decodeHex(\"FEFF\"))\n .writeString(\"{\\\"theName\\\":\\\"value\\\"}\", StandardCharsets.UTF_16);\n MockResponse malformedResponse = new MockResponse().setBody(responseBody);\n server.enqueue(malformedResponse);\n\n Call call = service.anImplementation(new AnImplementation(\"value\"));\n try {\n call.execute();\n fail();\n } catch (IOException expected) {\n }\n }\n\n @Test\n public void requireFullResponseDocumentConsumption() throws Exception {\n server.enqueue(new MockResponse().setBody(\"{\\\"theName\\\":\\\"value\\\"}\"));\n\n Call call = service.readErroringValue();\n try {\n call.execute();\n fail();\n } catch (JsonDataException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"JSON document was not fully consumed.\");\n }\n }\n\n @Test\n public void serializeIsStreamed() throws InterruptedException {\n assumeTrue(streaming);\n\n Call call = service.writeErroringValue(new ErroringValue(\"hi\"));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n\n // If streaming were broken, the call to enqueue would throw the exception synchronously.\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n latch.countDown();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n throwableRef.set(t);\n latch.countDown();\n }\n });\n latch.await();\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(EOFException.class);\n assertThat(throwable).hasMessageThat().isEqualTo(\"oops!\");\n }\n}\n" }, { "path": "retrofit-converters/protobuf/README.md", "content": "Google Protocol Buffer Converter\n================================\n\nA `Converter` which uses [Protocol Buffer][1] binary serialization.\n\n\nDownload\n--------\n\nDownload [the latest JAR][2] or grab via [Maven][3]:\n```xml\n\n com.squareup.retrofit2\n converter-protobuf\n latest.version\n\n```\nor [Gradle][3]:\n```groovy\nimplementation 'com.squareup.retrofit2:converter-protobuf:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n\n [1]: https://developers.google.com/protocol-buffers/\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=converter-protobuf&v=LATEST\n [3]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22converter-protobuf%22\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-converters/protobuf/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.google.protobuf'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n api libs.protobuf\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.okhttp.mockwebserver\n testImplementation libs.testParameterInjector\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.converter.protobuf'\n }\n}\n\nprotobuf {\n protoc {\n artifact = libs.protoc.get()\n }\n}\n" }, { "path": "retrofit-converters/protobuf/gradle.properties", "content": "POM_ARTIFACT_ID=converter-protobuf\nPOM_NAME=Converter: Protocol Buffers\nPOM_DESCRIPTION=A Retrofit Converter which uses Protocol Buffers for serialization.\n" }, { "path": "retrofit-converters/protobuf/src/main/java/retrofit2/converter/protobuf/ProtoConverterFactory.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.protobuf;\n\nimport com.google.protobuf.ExtensionRegistryLite;\nimport com.google.protobuf.MessageLite;\nimport com.google.protobuf.Parser;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Field;\nimport java.lang.reflect.InvocationTargetException;\nimport java.lang.reflect.Method;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Call;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\n/**\n * A {@linkplain Converter.Factory converter} which uses Protocol Buffers.\n *\n *

This converter only applies for types which extend from {@link MessageLite} (or one of its\n * subclasses).\n */\npublic final class ProtoConverterFactory extends Converter.Factory {\n public static ProtoConverterFactory create() {\n return new ProtoConverterFactory(null, false);\n }\n\n /** Create an instance which uses {@code registry} when deserializing. */\n public static ProtoConverterFactory createWithRegistry(@Nullable ExtensionRegistryLite registry) {\n return new ProtoConverterFactory(registry, false);\n }\n\n private final @Nullable ExtensionRegistryLite registry;\n private final boolean streaming;\n\n private ProtoConverterFactory(@Nullable ExtensionRegistryLite registry, boolean streaming) {\n this.registry = registry;\n this.streaming = streaming;\n }\n\n /**\n * Return a new factory which streams serialization of request messages to bytes on the HTTP thread\n * This is either the calling thread for {@link Call#execute()}, or one of OkHttp's background\n * threads for {@link Call#enqueue}. Response bytes are always converted to message instances on\n * one of OkHttp's background threads.\n */\n public ProtoConverterFactory withStreaming() {\n return new ProtoConverterFactory(registry, true);\n }\n\n @Override\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n if (!(type instanceof Class)) {\n return null;\n }\n Class c = (Class) type;\n if (!MessageLite.class.isAssignableFrom(c)) {\n return null;\n }\n\n Parser parser;\n try {\n Method method = c.getDeclaredMethod(\"parser\");\n //noinspection unchecked\n parser = (Parser) method.invoke(null);\n } catch (InvocationTargetException e) {\n throw new RuntimeException(e.getCause());\n } catch (NoSuchMethodException | IllegalAccessException ignored) {\n // If the method is missing, fall back to original static field for pre-3.0 support.\n try {\n Field field = c.getDeclaredField(\"PARSER\");\n //noinspection unchecked\n parser = (Parser) field.get(null);\n } catch (NoSuchFieldException | IllegalAccessException e) {\n throw new IllegalArgumentException(\n \"Found a protobuf message but \"\n + c.getName()\n + \" had no parser() method or PARSER field.\",\n e);\n }\n }\n return new ProtoResponseBodyConverter<>(parser, registry);\n }\n\n @Override\n public @Nullable Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n if (!(type instanceof Class)) {\n return null;\n }\n if (!MessageLite.class.isAssignableFrom((Class) type)) {\n return null;\n }\n return new ProtoRequestBodyConverter<>(streaming);\n }\n}\n" }, { "path": "retrofit-converters/protobuf/src/main/java/retrofit2/converter/protobuf/ProtoRequestBodyConverter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.protobuf;\n\nimport com.google.protobuf.MessageLite;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport retrofit2.Converter;\n\nfinal class ProtoRequestBodyConverter implements Converter {\n static final MediaType MEDIA_TYPE = MediaType.get(\"application/x-protobuf\");\n\n private final boolean streaming;\n\n ProtoRequestBodyConverter(boolean streaming) {\n this.streaming = streaming;\n }\n\n @Override\n public RequestBody convert(T value) {\n if (streaming) {\n return new ProtoStreamingRequestBody(value);\n }\n\n byte[] bytes = value.toByteArray();\n return RequestBody.create(MEDIA_TYPE, bytes);\n }\n}\n" }, { "path": "retrofit-converters/protobuf/src/main/java/retrofit2/converter/protobuf/ProtoResponseBodyConverter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.protobuf;\n\nimport com.google.protobuf.ExtensionRegistryLite;\nimport com.google.protobuf.InvalidProtocolBufferException;\nimport com.google.protobuf.MessageLite;\nimport com.google.protobuf.Parser;\nimport java.io.IOException;\nimport javax.annotation.Nullable;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\n\nfinal class ProtoResponseBodyConverter\n implements Converter {\n private final Parser parser;\n private final @Nullable ExtensionRegistryLite registry;\n\n ProtoResponseBodyConverter(Parser parser, @Nullable ExtensionRegistryLite registry) {\n this.parser = parser;\n this.registry = registry;\n }\n\n @Override\n public T convert(ResponseBody value) throws IOException {\n try {\n return registry == null\n ? parser.parseFrom(value.byteStream())\n : parser.parseFrom(value.byteStream(), registry);\n } catch (InvalidProtocolBufferException e) {\n throw new RuntimeException(e); // Despite extending IOException, this is data mismatch.\n } finally {\n value.close();\n }\n }\n}\n" }, { "path": "retrofit-converters/protobuf/src/main/java/retrofit2/converter/protobuf/ProtoStreamingRequestBody.java", "content": "/*\n * Copyright (C) 2025 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.protobuf;\n\nimport static retrofit2.converter.protobuf.ProtoRequestBodyConverter.MEDIA_TYPE;\n\nimport com.google.protobuf.MessageLite;\nimport java.io.IOException;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okio.BufferedSink;\n\nfinal class ProtoStreamingRequestBody extends RequestBody {\n private final MessageLite value;\n\n public ProtoStreamingRequestBody(MessageLite value) {\n this.value = value;\n }\n\n @Override\n public MediaType contentType() {\n return MEDIA_TYPE;\n }\n\n @Override\n public void writeTo(BufferedSink sink) throws IOException {\n value.writeTo(sink.outputStream());\n }\n}\n" }, { "path": "retrofit-converters/protobuf/src/main/java/retrofit2/converter/protobuf/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.converter.protobuf;\n" }, { "path": "retrofit-converters/protobuf/src/main/resources/META-INF/proguard/retrofit2-protobuf-converter.pro", "content": "# Parser looked up reflectively.\n-keepclassmembers class * implements com.google.protobuf.MessageLite {\n public static com.google.protobuf.Parser parser();\n\n # Fallback for v2.x.\n public static com.google.protobuf.Parser PARSER;\n}\n" }, { "path": "retrofit-converters/protobuf/src/test/java/retrofit2/converter/protobuf/FallbackParserFinderTest.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.protobuf;\n\nimport static com.google.common.truth.Truth.assertThat;\n\nimport com.google.protobuf.MessageLite;\nimport com.google.protobuf.Parser;\nimport java.lang.annotation.Annotation;\nimport okhttp3.ResponseBody;\nimport org.junit.Test;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\nimport retrofit2.converter.protobuf.PhoneProtos.Phone;\n\npublic final class FallbackParserFinderTest {\n @Test\n public void converterFactoryFallsBackToParserField() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(\"http://localhost/\").build();\n ProtoConverterFactory factory = ProtoConverterFactory.create();\n Converter converter =\n factory.responseBodyConverter(FakePhone.class, new Annotation[0], retrofit);\n assertThat(converter).isNotNull();\n }\n\n @SuppressWarnings(\"unused\") // Used reflectively.\n public abstract static class FakePhone implements MessageLite {\n public static final Parser PARSER = Phone.parser();\n }\n}\n" }, { "path": "retrofit-converters/protobuf/src/test/java/retrofit2/converter/protobuf/ProtoConverterFactoryTest.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.protobuf;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\nimport static org.junit.Assume.assumeTrue;\nimport static retrofit2.converter.protobuf.PhoneProtos.Phone;\n\nimport com.google.protobuf.AbstractMessageLite;\nimport com.google.protobuf.CodedOutputStream;\nimport com.google.protobuf.ExtensionRegistry;\nimport com.google.protobuf.InvalidProtocolBufferException;\nimport com.google.protobuf.MessageLite;\nimport com.google.protobuf.Parser;\nimport com.google.testing.junit.testparameterinjector.TestParameter;\nimport com.google.testing.junit.testparameterinjector.TestParameterInjector;\nimport java.io.EOFException;\nimport java.io.IOException;\nimport java.util.List;\nimport java.util.concurrent.CountDownLatch;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport okhttp3.mockwebserver.RecordedRequest;\nimport okio.Buffer;\nimport okio.ByteString;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.runner.RunWith;\nimport retrofit2.Call;\nimport retrofit2.Callback;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.Body;\nimport retrofit2.http.GET;\nimport retrofit2.http.POST;\n\n@RunWith(TestParameterInjector.class)\npublic final class ProtoConverterFactoryTest {\n interface Service {\n @GET(\"/\")\n Call get();\n\n @POST(\"/\")\n Call post(@Body MessageLite impl);\n\n @GET(\"/\")\n Call wrongClass();\n\n @GET(\"/\")\n Call> wrongType();\n }\n\n interface ServiceWithRegistry {\n @GET(\"/\")\n Call get();\n }\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private final Service service;\n private final ServiceWithRegistry serviceWithRegistry;\n private final boolean streaming;\n\n public ProtoConverterFactoryTest(@TestParameter boolean streaming) {\n this.streaming = streaming;\n\n ExtensionRegistry registry = ExtensionRegistry.newInstance();\n PhoneProtos.registerAllExtensions(registry);\n\n ProtoConverterFactory factory = ProtoConverterFactory.create();\n ProtoConverterFactory factoryWithRegistry = ProtoConverterFactory.createWithRegistry(registry);\n if (streaming) {\n factory = factory.withStreaming();\n factoryWithRegistry = factoryWithRegistry.withStreaming();\n }\n\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(server.url(\"/\")).addConverterFactory(factory).build();\n service = retrofit.create(Service.class);\n\n Retrofit retrofitWithRegistry =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(factoryWithRegistry)\n .build();\n serviceWithRegistry = retrofitWithRegistry.create(ServiceWithRegistry.class);\n }\n\n @Test\n public void serializeAndDeserialize() throws IOException, InterruptedException {\n ByteString encoded = ByteString.decodeBase64(\"Cg4oNTE5KSA4NjctNTMwOQ==\");\n server.enqueue(new MockResponse().setBody(new Buffer().write(encoded)));\n\n Call call = service.post(Phone.newBuilder().setNumber(\"(519) 867-5309\").build());\n Response response = call.execute();\n Phone body = response.body();\n assertThat(body.getNumber()).isEqualTo(\"(519) 867-5309\");\n\n RecordedRequest request = server.takeRequest();\n assertThat(request.getBody().readByteString()).isEqualTo(encoded);\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/x-protobuf\");\n }\n\n @Test\n public void deserializeEmpty() throws IOException {\n server.enqueue(new MockResponse());\n\n Call call = service.get();\n Response response = call.execute();\n Phone body = response.body();\n assertThat(body.hasNumber()).isFalse();\n }\n\n @Test\n public void deserializeUsesRegistry() throws IOException {\n ByteString encoded = ByteString.decodeBase64(\"Cg4oNTE5KSA4NjctNTMwORAB\");\n server.enqueue(new MockResponse().setBody(new Buffer().write(encoded)));\n\n Call call = serviceWithRegistry.get();\n Response response = call.execute();\n Phone body = response.body();\n assertThat(body.getNumber()).isEqualTo(\"(519) 867-5309\");\n assertThat(body.getExtension(PhoneProtos.voicemail)).isEqualTo(true);\n }\n\n @Test\n public void deserializeWrongClass() throws IOException {\n ByteString encoded = ByteString.decodeBase64(\"Cg4oNTE5KSA4NjctNTMwOQ==\");\n server.enqueue(new MockResponse().setBody(new Buffer().write(encoded)));\n\n try {\n service.wrongClass();\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Unable to create converter for class java.lang.String\\n\"\n + \" for method Service.wrongClass\");\n assertThat(e.getCause())\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Could not locate ResponseBody converter for class java.lang.String.\\n\"\n + \" Tried:\\n\"\n + \" * retrofit2.BuiltInConverters\\n\"\n + \" * retrofit2.converter.protobuf.ProtoConverterFactory\\n\"\n + \" * retrofit2.OptionalConverterFactory\");\n }\n }\n\n @Test\n public void deserializeWrongType() throws IOException {\n ByteString encoded = ByteString.decodeBase64(\"Cg4oNTE5KSA4NjctNTMwOQ==\");\n server.enqueue(new MockResponse().setBody(new Buffer().write(encoded)));\n\n try {\n service.wrongType();\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Unable to create converter for java.util.List\\n\"\n + \" for method Service.wrongType\");\n assertThat(e.getCause())\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Could not locate ResponseBody converter for java.util.List.\\n\"\n + \" Tried:\\n\"\n + \" * retrofit2.BuiltInConverters\\n\"\n + \" * retrofit2.converter.protobuf.ProtoConverterFactory\\n\"\n + \" * retrofit2.OptionalConverterFactory\");\n }\n }\n\n @Test\n public void deserializeWrongValue() throws IOException {\n ByteString encoded = ByteString.decodeBase64(\"////\");\n server.enqueue(new MockResponse().setBody(new Buffer().write(encoded)));\n\n Call call = service.get();\n try {\n call.execute();\n fail();\n } catch (RuntimeException e) {\n Throwable cause = e.getCause();\n assertThat(cause).isInstanceOf(InvalidProtocolBufferException.class);\n assertThat(cause).hasMessageThat().contains(\"input ended unexpectedly\");\n }\n }\n\n @Test\n public void serializeIsStreamed() throws InterruptedException {\n assumeTrue(streaming);\n\n Call call =\n service.post(new ThrowingPhone(Phone.newBuilder().setNumber(\"(519) 867-5309\").build()));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n\n // If streaming were broken, the call to enqueue would throw the exception synchronously.\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n latch.countDown();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n throwableRef.set(t);\n latch.countDown();\n }\n });\n latch.await();\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(EOFException.class);\n assertThat(throwable).hasMessageThat().isEqualTo(\"oops!\");\n }\n\n private static final class ThrowingPhone extends AbstractMessageLite {\n private final Phone delegate;\n\n private ThrowingPhone(Phone delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public void writeTo(CodedOutputStream output) throws IOException {\n throw new EOFException(\"oops!\");\n }\n\n @Override\n public int getSerializedSize() {\n return delegate.getSerializedSize();\n }\n\n @Override\n public Parser getParserForType() {\n return delegate.getParserForType();\n }\n\n @Override\n public MessageLite.Builder newBuilderForType() {\n return delegate.newBuilderForType();\n }\n\n @Override\n public MessageLite.Builder toBuilder() {\n return delegate.toBuilder();\n }\n\n @Override\n public MessageLite getDefaultInstanceForType() {\n return delegate.getDefaultInstanceForType();\n }\n\n @Override\n public boolean isInitialized() {\n return delegate.isInitialized();\n }\n }\n}\n" }, { "path": "retrofit-converters/protobuf/src/test/proto/phone.proto", "content": "package retrofit2.converter.protobuf;\n\noption java_package = \"retrofit2.converter.protobuf\";\noption java_outer_classname = \"PhoneProtos\";\n\nmessage Phone {\n optional string number = 1;\n\n extensions 2;\n}\n\nextend Phone {\n optional bool voicemail = 2;\n}\n" }, { "path": "retrofit-converters/scalars/README.md", "content": "Java Scalars Converter\n======================\n\nA `Converter` which supports converting strings and both primitives and their boxed types to\n`text/plain` bodies.\n\n\nDownload\n--------\n\nDownload [the latest JAR][1] or grab via [Maven][2]:\n```xml\n\n com.squareup.retrofit2\n converter-scalars\n latest.version\n\n```\nor [Gradle][2]:\n```groovy\nimplementation 'com.squareup.retrofit2:converter-scalars:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n\n [1]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=converter-scalars&v=LATEST\n [2]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22converter-scalars%22\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-converters/scalars/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.okhttp.mockwebserver\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.converter.scalars'\n }\n}\n" }, { "path": "retrofit-converters/scalars/gradle.properties", "content": "POM_ARTIFACT_ID=converter-scalars\nPOM_NAME=Converter: Scalars\nPOM_DESCRIPTION=A Retrofit Converter for Java's scalar value types.\n" }, { "path": "retrofit-converters/scalars/src/main/java/retrofit2/converter/scalars/ScalarRequestBodyConverter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.scalars;\n\nimport java.io.IOException;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport retrofit2.Converter;\n\nfinal class ScalarRequestBodyConverter implements Converter {\n static final ScalarRequestBodyConverter INSTANCE = new ScalarRequestBodyConverter<>();\n private static final MediaType MEDIA_TYPE = MediaType.get(\"text/plain; charset=UTF-8\");\n\n private ScalarRequestBodyConverter() {}\n\n @Override\n public RequestBody convert(T value) throws IOException {\n return RequestBody.create(MEDIA_TYPE, String.valueOf(value));\n }\n}\n" }, { "path": "retrofit-converters/scalars/src/main/java/retrofit2/converter/scalars/ScalarResponseBodyConverters.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.scalars;\n\nimport java.io.IOException;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\n\nfinal class ScalarResponseBodyConverters {\n private ScalarResponseBodyConverters() {}\n\n static final class StringResponseBodyConverter implements Converter {\n static final StringResponseBodyConverter INSTANCE = new StringResponseBodyConverter();\n\n @Override\n public String convert(ResponseBody value) throws IOException {\n return value.string();\n }\n }\n\n static final class BooleanResponseBodyConverter implements Converter {\n static final BooleanResponseBodyConverter INSTANCE = new BooleanResponseBodyConverter();\n\n @Override\n public Boolean convert(ResponseBody value) throws IOException {\n return Boolean.valueOf(value.string());\n }\n }\n\n static final class ByteResponseBodyConverter implements Converter {\n static final ByteResponseBodyConverter INSTANCE = new ByteResponseBodyConverter();\n\n @Override\n public Byte convert(ResponseBody value) throws IOException {\n return Byte.valueOf(value.string());\n }\n }\n\n static final class CharacterResponseBodyConverter implements Converter {\n static final CharacterResponseBodyConverter INSTANCE = new CharacterResponseBodyConverter();\n\n @Override\n public Character convert(ResponseBody value) throws IOException {\n String body = value.string();\n if (body.length() != 1) {\n throw new IOException(\n \"Expected body of length 1 for Character conversion but was \" + body.length());\n }\n return body.charAt(0);\n }\n }\n\n static final class DoubleResponseBodyConverter implements Converter {\n static final DoubleResponseBodyConverter INSTANCE = new DoubleResponseBodyConverter();\n\n @Override\n public Double convert(ResponseBody value) throws IOException {\n return Double.valueOf(value.string());\n }\n }\n\n static final class FloatResponseBodyConverter implements Converter {\n static final FloatResponseBodyConverter INSTANCE = new FloatResponseBodyConverter();\n\n @Override\n public Float convert(ResponseBody value) throws IOException {\n return Float.valueOf(value.string());\n }\n }\n\n static final class IntegerResponseBodyConverter implements Converter {\n static final IntegerResponseBodyConverter INSTANCE = new IntegerResponseBodyConverter();\n\n @Override\n public Integer convert(ResponseBody value) throws IOException {\n return Integer.valueOf(value.string());\n }\n }\n\n static final class LongResponseBodyConverter implements Converter {\n static final LongResponseBodyConverter INSTANCE = new LongResponseBodyConverter();\n\n @Override\n public Long convert(ResponseBody value) throws IOException {\n return Long.valueOf(value.string());\n }\n }\n\n static final class ShortResponseBodyConverter implements Converter {\n static final ShortResponseBodyConverter INSTANCE = new ShortResponseBodyConverter();\n\n @Override\n public Short convert(ResponseBody value) throws IOException {\n return Short.valueOf(value.string());\n }\n }\n}\n" }, { "path": "retrofit-converters/scalars/src/main/java/retrofit2/converter/scalars/ScalarsConverterFactory.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.scalars;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\nimport retrofit2.converter.scalars.ScalarResponseBodyConverters.BooleanResponseBodyConverter;\nimport retrofit2.converter.scalars.ScalarResponseBodyConverters.ByteResponseBodyConverter;\nimport retrofit2.converter.scalars.ScalarResponseBodyConverters.CharacterResponseBodyConverter;\nimport retrofit2.converter.scalars.ScalarResponseBodyConverters.DoubleResponseBodyConverter;\nimport retrofit2.converter.scalars.ScalarResponseBodyConverters.FloatResponseBodyConverter;\nimport retrofit2.converter.scalars.ScalarResponseBodyConverters.IntegerResponseBodyConverter;\nimport retrofit2.converter.scalars.ScalarResponseBodyConverters.LongResponseBodyConverter;\nimport retrofit2.converter.scalars.ScalarResponseBodyConverters.ShortResponseBodyConverter;\nimport retrofit2.converter.scalars.ScalarResponseBodyConverters.StringResponseBodyConverter;\n\n/**\n * A {@linkplain Converter.Factory converter} for strings and both primitives and their boxed types\n * to {@code text/plain} bodies.\n */\npublic final class ScalarsConverterFactory extends Converter.Factory {\n public static ScalarsConverterFactory create() {\n return new ScalarsConverterFactory();\n }\n\n private ScalarsConverterFactory() {}\n\n @Override\n public @Nullable Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n if (type == String.class\n || type == boolean.class\n || type == Boolean.class\n || type == byte.class\n || type == Byte.class\n || type == char.class\n || type == Character.class\n || type == double.class\n || type == Double.class\n || type == float.class\n || type == Float.class\n || type == int.class\n || type == Integer.class\n || type == long.class\n || type == Long.class\n || type == short.class\n || type == Short.class) {\n return ScalarRequestBodyConverter.INSTANCE;\n }\n return null;\n }\n\n @Override\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n if (type == String.class) {\n return StringResponseBodyConverter.INSTANCE;\n }\n if (type == Boolean.class || type == boolean.class) {\n return BooleanResponseBodyConverter.INSTANCE;\n }\n if (type == Byte.class || type == byte.class) {\n return ByteResponseBodyConverter.INSTANCE;\n }\n if (type == Character.class || type == char.class) {\n return CharacterResponseBodyConverter.INSTANCE;\n }\n if (type == Double.class || type == double.class) {\n return DoubleResponseBodyConverter.INSTANCE;\n }\n if (type == Float.class || type == float.class) {\n return FloatResponseBodyConverter.INSTANCE;\n }\n if (type == Integer.class || type == int.class) {\n return IntegerResponseBodyConverter.INSTANCE;\n }\n if (type == Long.class || type == long.class) {\n return LongResponseBodyConverter.INSTANCE;\n }\n if (type == Short.class || type == short.class) {\n return ShortResponseBodyConverter.INSTANCE;\n }\n return null;\n }\n}\n" }, { "path": "retrofit-converters/scalars/src/main/java/retrofit2/converter/scalars/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.converter.scalars;\n" }, { "path": "retrofit-converters/scalars/src/test/java/retrofit2/converter/scalars/ScalarsConverterFactoryTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.scalars;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport java.io.IOException;\nimport okhttp3.ResponseBody;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport okhttp3.mockwebserver.RecordedRequest;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Call;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.Body;\nimport retrofit2.http.GET;\nimport retrofit2.http.POST;\n\npublic final class ScalarsConverterFactoryTest {\n interface Service {\n @POST(\"/\")\n Call object(@Body Object body);\n\n @POST(\"/\")\n Call stringObject(@Body String body);\n\n @POST(\"/\")\n Call booleanPrimitive(@Body boolean body);\n\n @POST(\"/\")\n Call booleanObject(@Body Boolean body);\n\n @POST(\"/\")\n Call bytePrimitive(@Body byte body);\n\n @POST(\"/\")\n Call byteObject(@Body Byte body);\n\n @POST(\"/\")\n Call charPrimitive(@Body char body);\n\n @POST(\"/\")\n Call charObject(@Body Character body);\n\n @POST(\"/\")\n Call doublePrimitive(@Body double body);\n\n @POST(\"/\")\n Call doubleObject(@Body Double body);\n\n @POST(\"/\")\n Call floatPrimitive(@Body float body);\n\n @POST(\"/\")\n Call floatObject(@Body Float body);\n\n @POST(\"/\")\n Call integerPrimitive(@Body int body);\n\n @POST(\"/\")\n Call integerObject(@Body Integer body);\n\n @POST(\"/\")\n Call longPrimitive(@Body long body);\n\n @POST(\"/\")\n Call longObject(@Body Long body);\n\n @POST(\"/\")\n Call shortPrimitive(@Body short body);\n\n @POST(\"/\")\n Call shortObject(@Body Short body);\n\n @GET(\"/\")\n Call object();\n\n @GET(\"/\")\n Call stringObject();\n\n @GET(\"/\")\n Call booleanObject();\n\n @GET(\"/\")\n Call byteObject();\n\n @GET(\"/\")\n Call charObject();\n\n @GET(\"/\")\n Call doubleObject();\n\n @GET(\"/\")\n Call floatObject();\n\n @GET(\"/\")\n Call integerObject();\n\n @GET(\"/\")\n Call longObject();\n\n @GET(\"/\")\n Call shortObject();\n }\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(ScalarsConverterFactory.create())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void unsupportedRequestTypesNotMatched() {\n try {\n service.object(null);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Unable to create @Body converter for class java.lang.Object (parameter #1)\\n\"\n + \" for method Service.object\");\n assertThat(e.getCause())\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Could not locate RequestBody converter for class java.lang.Object.\\n\"\n + \" Tried:\\n\"\n + \" * retrofit2.BuiltInConverters\\n\"\n + \" * retrofit2.converter.scalars.ScalarsConverterFactory\\n\"\n + \" * retrofit2.OptionalConverterFactory\");\n }\n }\n\n @Test\n public void supportedRequestTypes() throws IOException, InterruptedException {\n RecordedRequest request;\n\n server.enqueue(new MockResponse());\n service.stringObject(\"string\").execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"6\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"string\");\n\n server.enqueue(new MockResponse());\n service.booleanPrimitive(true).execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"4\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"true\");\n\n server.enqueue(new MockResponse());\n service.booleanObject(false).execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"5\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"false\");\n\n server.enqueue(new MockResponse());\n service.bytePrimitive((byte) 0).execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"1\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"0\");\n\n server.enqueue(new MockResponse());\n service.byteObject((byte) 1).execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"1\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"1\");\n\n server.enqueue(new MockResponse());\n service.charPrimitive('a').execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"1\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"a\");\n\n server.enqueue(new MockResponse());\n service.charObject('b').execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"1\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"b\");\n\n server.enqueue(new MockResponse());\n service.doublePrimitive(2.2d).execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"3\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"2.2\");\n\n server.enqueue(new MockResponse());\n service.doubleObject(3.3d).execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"3\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"3.3\");\n\n server.enqueue(new MockResponse());\n service.floatPrimitive(4.4f).execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"3\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"4.4\");\n\n server.enqueue(new MockResponse());\n service.floatObject(5.5f).execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"3\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"5.5\");\n\n server.enqueue(new MockResponse());\n service.integerPrimitive(6).execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"1\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"6\");\n\n server.enqueue(new MockResponse());\n service.integerObject(7).execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"1\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"7\");\n\n server.enqueue(new MockResponse());\n service.longPrimitive(8L).execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"1\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"8\");\n\n server.enqueue(new MockResponse());\n service.longObject(9L).execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"1\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"9\");\n\n server.enqueue(new MockResponse());\n service.shortPrimitive((short) 10).execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"2\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"10\");\n\n server.enqueue(new MockResponse());\n service.shortObject((short) 11).execute();\n request = server.takeRequest();\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"text/plain; charset=UTF-8\");\n assertThat(request.getHeader(\"Content-Length\")).isEqualTo(\"2\");\n assertThat(request.getBody().readUtf8()).isEqualTo(\"11\");\n }\n\n @Test\n public void unsupportedResponseTypesNotMatched() {\n try {\n service.object();\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Unable to create converter for class java.lang.Object\\n\"\n + \" for method Service.object\");\n assertThat(e.getCause())\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Could not locate ResponseBody converter for class java.lang.Object.\\n\"\n + \" Tried:\\n\"\n + \" * retrofit2.BuiltInConverters\\n\"\n + \" * retrofit2.converter.scalars.ScalarsConverterFactory\\n\"\n + \" * retrofit2.OptionalConverterFactory\");\n }\n }\n\n @Test\n public void supportedResponseTypes() throws IOException, InterruptedException {\n server.enqueue(new MockResponse().setBody(\"test\"));\n Response stringResponse = service.stringObject().execute();\n assertThat(stringResponse.body()).isEqualTo(\"test\");\n\n server.enqueue(new MockResponse().setBody(\"true\"));\n Response booleanResponse = service.booleanObject().execute();\n assertThat(booleanResponse.body()).isTrue();\n\n server.enqueue(new MockResponse().setBody(\"5\"));\n Response byteResponse = service.byteObject().execute();\n assertThat(byteResponse.body()).isEqualTo((byte) 5);\n\n server.enqueue(new MockResponse().setBody(\"b\"));\n Response characterResponse = service.charObject().execute();\n assertThat(characterResponse.body()).isEqualTo('b');\n\n server.enqueue(new MockResponse().setBody(\"\"));\n try {\n service.charObject().execute();\n fail();\n } catch (IOException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Expected body of length 1 for Character conversion but was 0\");\n }\n\n server.enqueue(new MockResponse().setBody(\"bb\"));\n try {\n service.charObject().execute();\n fail();\n } catch (IOException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Expected body of length 1 for Character conversion but was 2\");\n }\n\n server.enqueue(new MockResponse().setBody(\"13.13\"));\n Response doubleResponse = service.doubleObject().execute();\n assertThat(doubleResponse.body()).isEqualTo(13.13);\n\n server.enqueue(new MockResponse().setBody(\"13.13\"));\n Response floatResponse = service.floatObject().execute();\n assertThat(floatResponse.body()).isEqualTo(13.13f);\n\n server.enqueue(new MockResponse().setBody(\"13\"));\n Response integerResponse = service.integerObject().execute();\n assertThat(integerResponse.body()).isEqualTo(13);\n\n server.enqueue(new MockResponse().setBody(\"1347\"));\n Response longResponse = service.longObject().execute();\n assertThat(longResponse.body()).isEqualTo(1347L);\n\n server.enqueue(new MockResponse().setBody(\"134\"));\n Response shortResponse = service.shortObject().execute();\n assertThat(shortResponse.body()).isEqualTo((short) 134);\n }\n}\n" }, { "path": "retrofit-converters/scalars/src/test/java/retrofit2/converter/scalars/ScalarsConverterPrimitivesFactoryTest.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.scalars;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport retrofit2.Call;\nimport retrofit2.CallAdapter;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\npublic final class ScalarsConverterPrimitivesFactoryTest {\n interface Service {\n @GET(\"/\")\n boolean booleanPrimitive();\n\n @GET(\"/\")\n byte bytePrimitive();\n\n @GET(\"/\")\n char charPrimitive();\n\n @GET(\"/\")\n double doublePrimitive();\n\n @GET(\"/\")\n float floatPrimitive();\n\n @GET(\"/\")\n int integerPrimitive();\n\n @GET(\"/\")\n long longPrimitive();\n\n @GET(\"/\")\n short shortPrimitive();\n }\n\n static class DirectCallIOException extends RuntimeException {\n DirectCallIOException(String message, IOException e) {\n super(message, e);\n }\n }\n\n static class DirectCallAdapterFactory extends CallAdapter.Factory {\n @Override\n public CallAdapter get(\n final Type returnType, Annotation[] annotations, Retrofit retrofit) {\n return new CallAdapter() {\n @Override\n public Type responseType() {\n return returnType;\n }\n\n @Override\n public Object adapt(Call call) {\n try {\n return call.execute().body();\n } catch (IOException e) {\n throw new DirectCallIOException(e.getMessage(), e);\n }\n }\n };\n }\n }\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private Service service;\n\n @Before\n public void setUp() {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(ScalarsConverterFactory.create())\n .addCallAdapterFactory(new DirectCallAdapterFactory())\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void supportedResponseTypes() throws IOException, InterruptedException {\n server.enqueue(new MockResponse().setBody(\"true\"));\n boolean booleanResponse = service.booleanPrimitive();\n assertThat(booleanResponse).isTrue();\n\n server.enqueue(new MockResponse().setBody(\"5\"));\n byte byteResponse = service.bytePrimitive();\n assertThat(byteResponse).isEqualTo((byte) 5);\n\n server.enqueue(new MockResponse().setBody(\"b\"));\n char characterResponse = service.charPrimitive();\n assertThat(characterResponse).isEqualTo('b');\n\n server.enqueue(new MockResponse().setBody(\"\"));\n try {\n service.charPrimitive();\n fail();\n } catch (DirectCallIOException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Expected body of length 1 for Character conversion but was 0\");\n }\n\n server.enqueue(new MockResponse().setBody(\"bb\"));\n try {\n service.charPrimitive();\n fail();\n } catch (DirectCallIOException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Expected body of length 1 for Character conversion but was 2\");\n }\n\n server.enqueue(new MockResponse().setBody(\"13.13\"));\n double doubleResponse = service.doublePrimitive();\n assertThat(doubleResponse).isEqualTo(13.13);\n\n server.enqueue(new MockResponse().setBody(\"13.13\"));\n float floatResponse = service.floatPrimitive();\n assertThat(floatResponse).isEqualTo(13.13f);\n\n server.enqueue(new MockResponse().setBody(\"13\"));\n int integerResponse = service.integerPrimitive();\n assertThat(integerResponse).isEqualTo(13);\n\n server.enqueue(new MockResponse().setBody(\"1347\"));\n long longResponse = service.longPrimitive();\n assertThat(longResponse).isEqualTo(1347L);\n\n server.enqueue(new MockResponse().setBody(\"134\"));\n short shortResponse = service.shortPrimitive();\n assertThat(shortResponse).isEqualTo((short) 134);\n }\n}\n" }, { "path": "retrofit-converters/simplexml/README.md", "content": "Simple XML Converter\n====================\n\nDeprecated – Please switch to the JAXB Converter\n------------------------------------------------\n\nThe Simple XML project is no longer maintained. We recommend switching to the\n[JAXB converter](https://github.com/square/retrofit/tree/master/retrofit-converters/jaxb).\n\n-----\n\nA `Converter` which uses [Simple][1] for XML serialization.\n\nA default `Serializer` instance will be created or one can be configured and passed to the\n`SimpleXMLConverter` construction to further control the serialization.\n\n\nAndroid\n-------\n\nSimple depends on artifacts which are already provided by the Android platform. When specifying as\na Maven or Gradle dependency, exclude the following transitive dependencies: `stax:stax-api`,\n`stax:stax`, and `xpp3:xpp3`.\n\n\nDownload\n--------\n\nDownload [the latest JAR][2] or grab via [Maven][3]:\n```xml\n\n com.squareup.retrofit2\n converter-simplexml\n latest.version\n\n```\nor [Gradle][3]:\n```groovy\nimplementation 'com.squareup.retrofit2:converter-simplexml:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n\n [1]: http://simple.sourceforge.net/\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=converter-simplexml&v=LATEST\n [3]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22converter-simplexml%22\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-converters/simplexml/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n api libs.simpleXml\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.okhttp.mockwebserver\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.converter.simplexml'\n }\n}\n" }, { "path": "retrofit-converters/simplexml/gradle.properties", "content": "POM_ARTIFACT_ID=converter-simplexml\nPOM_NAME=Converter: SimpleXML\nPOM_DESCRIPTION=A Retrofit Converter which uses Simple XML for serialization.\n" }, { "path": "retrofit-converters/simplexml/src/main/java/retrofit2/converter/simplexml/SimpleXmlConverterFactory.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.simplexml;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport org.simpleframework.xml.Serializer;\nimport org.simpleframework.xml.core.Persister;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\n/**\n * A {@linkplain Converter.Factory converter} which uses Simple Framework for XML.\n *\n *

This converter only applies for class types. Parameterized types (e.g., {@code List}) are\n * not handled.\n *\n * @deprecated we recommend switching to the JAXB converter.\n */\n@Deprecated\npublic final class SimpleXmlConverterFactory extends Converter.Factory {\n /** Create an instance using a default {@link Persister} instance for conversion. */\n public static SimpleXmlConverterFactory create() {\n return create(new Persister());\n }\n\n /** Create an instance using {@code serializer} for conversion. */\n public static SimpleXmlConverterFactory create(Serializer serializer) {\n return new SimpleXmlConverterFactory(serializer, true);\n }\n\n /** Create an instance using a default {@link Persister} instance for non-strict conversion. */\n public static SimpleXmlConverterFactory createNonStrict() {\n return createNonStrict(new Persister());\n }\n\n /** Create an instance using {@code serializer} for non-strict conversion. */\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static SimpleXmlConverterFactory createNonStrict(Serializer serializer) {\n if (serializer == null) throw new NullPointerException(\"serializer == null\");\n return new SimpleXmlConverterFactory(serializer, false);\n }\n\n private final Serializer serializer;\n private final boolean strict;\n\n private SimpleXmlConverterFactory(Serializer serializer, boolean strict) {\n this.serializer = serializer;\n this.strict = strict;\n }\n\n public boolean isStrict() {\n return strict;\n }\n\n @Override\n public Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n if (!(type instanceof Class)) {\n return null;\n }\n Class cls = (Class) type;\n return new SimpleXmlResponseBodyConverter<>(cls, serializer, strict);\n }\n\n @Override\n public @Nullable Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n if (!(type instanceof Class)) {\n return null;\n }\n return new SimpleXmlRequestBodyConverter<>(serializer);\n }\n}\n" }, { "path": "retrofit-converters/simplexml/src/main/java/retrofit2/converter/simplexml/SimpleXmlRequestBodyConverter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.simplexml;\n\nimport java.io.IOException;\nimport java.io.OutputStreamWriter;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okio.Buffer;\nimport org.simpleframework.xml.Serializer;\nimport retrofit2.Converter;\n\nfinal class SimpleXmlRequestBodyConverter implements Converter {\n private static final MediaType MEDIA_TYPE = MediaType.get(\"application/xml; charset=UTF-8\");\n private static final String CHARSET = \"UTF-8\";\n\n private final Serializer serializer;\n\n SimpleXmlRequestBodyConverter(Serializer serializer) {\n this.serializer = serializer;\n }\n\n @Override\n public RequestBody convert(T value) throws IOException {\n Buffer buffer = new Buffer();\n try {\n OutputStreamWriter osw = new OutputStreamWriter(buffer.outputStream(), CHARSET);\n serializer.write(value, osw);\n osw.flush();\n } catch (RuntimeException | IOException e) {\n throw e;\n } catch (Exception e) {\n throw new RuntimeException(e);\n }\n return RequestBody.create(MEDIA_TYPE, buffer.readByteString());\n }\n}\n" }, { "path": "retrofit-converters/simplexml/src/main/java/retrofit2/converter/simplexml/SimpleXmlResponseBodyConverter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.simplexml;\n\nimport java.io.IOException;\nimport okhttp3.ResponseBody;\nimport org.simpleframework.xml.Serializer;\nimport retrofit2.Converter;\n\nfinal class SimpleXmlResponseBodyConverter implements Converter {\n private final Class cls;\n private final Serializer serializer;\n private final boolean strict;\n\n SimpleXmlResponseBodyConverter(Class cls, Serializer serializer, boolean strict) {\n this.cls = cls;\n this.serializer = serializer;\n this.strict = strict;\n }\n\n @Override\n public T convert(ResponseBody value) throws IOException {\n try {\n T read = serializer.read(cls, value.charStream(), strict);\n if (read == null) {\n throw new IllegalStateException(\"Could not deserialize body as \" + cls);\n }\n return read;\n } catch (RuntimeException | IOException e) {\n throw e;\n } catch (Exception e) {\n throw new RuntimeException(e);\n } finally {\n value.close();\n }\n }\n}\n" }, { "path": "retrofit-converters/simplexml/src/main/java/retrofit2/converter/simplexml/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.converter.simplexml;\n" }, { "path": "retrofit-converters/simplexml/src/test/java/retrofit2/converter/simplexml/MyObject.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.simplexml;\n\nimport org.simpleframework.xml.Default;\nimport org.simpleframework.xml.DefaultType;\nimport org.simpleframework.xml.Element;\n\n@Default(value = DefaultType.FIELD)\nfinal class MyObject {\n @Element private String message;\n @Element private int count;\n\n public MyObject() {}\n\n public MyObject(String message, int count) {\n this.message = message;\n this.count = count;\n }\n\n public void setMessage(String message) {\n this.message = message;\n }\n\n public String getMessage() {\n return message;\n }\n\n public void setCount(int count) {\n this.count = count;\n }\n\n public int getCount() {\n return count;\n }\n\n @Override\n public int hashCode() {\n int result = 1;\n result = result * 31 + count;\n result = result * 31 + (message == null ? 0 : message.hashCode());\n return result;\n }\n\n @Override\n public boolean equals(Object obj) {\n if (obj == this) return true;\n if (!(obj instanceof MyObject)) return false;\n MyObject other = (MyObject) obj;\n return count == other.count\n && (message == null ? other.message == null : message.equals(other.message));\n }\n}\n" }, { "path": "retrofit-converters/simplexml/src/test/java/retrofit2/converter/simplexml/SimpleXmlConverterFactoryTest.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.simplexml;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport java.io.IOException;\nimport java.nio.charset.Charset;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport okhttp3.mockwebserver.RecordedRequest;\nimport okio.Buffer;\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.simpleframework.xml.core.ElementException;\nimport org.simpleframework.xml.core.Persister;\nimport org.simpleframework.xml.stream.Format;\nimport org.simpleframework.xml.stream.HyphenStyle;\nimport org.simpleframework.xml.stream.Verbosity;\nimport retrofit2.Call;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.Body;\nimport retrofit2.http.GET;\nimport retrofit2.http.POST;\n\npublic class SimpleXmlConverterFactoryTest {\n interface Service {\n @GET(\"/\")\n Call get();\n\n @POST(\"/\")\n Call post(@Body MyObject impl);\n\n @GET(\"/\")\n Call wrongClass();\n }\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private Service service;\n\n @Before\n public void setUp() {\n Format format = new Format(0, null, new HyphenStyle(), Verbosity.HIGH);\n Persister persister = new Persister(format);\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(SimpleXmlConverterFactory.create(persister))\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void bodyWays() throws IOException, InterruptedException {\n server.enqueue(\n new MockResponse()\n .setBody(\"hello world10\"));\n\n Call call = service.post(new MyObject(\"hello world\", 10));\n Response response = call.execute();\n MyObject body = response.body();\n assertThat(body.getMessage()).isEqualTo(\"hello world\");\n assertThat(body.getCount()).isEqualTo(10);\n\n RecordedRequest request = server.takeRequest();\n assertThat(request.getBody().readUtf8())\n .isAnyOf(\n \"hello world10\",\n \"10hello world\");\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/xml; charset=UTF-8\");\n }\n\n @Test\n public void honorsCharacterEncoding() throws IOException {\n Buffer buffer =\n new Buffer()\n .writeString(\n \"你好，世界10\",\n Charset.forName(\"GBK\"));\n server.enqueue(\n new MockResponse().setBody(buffer).addHeader(\"Content-Type\", \"text/xml;charset=GBK\"));\n\n Call call = service.get();\n Response response = call.execute();\n MyObject body = response.body();\n assertThat(body.getMessage()).isEqualTo(\"你好，世界\");\n }\n\n @Test\n public void deserializeWrongValue() throws IOException {\n server.enqueue(new MockResponse().setBody(\"\"));\n\n Call call = service.get();\n try {\n call.execute();\n fail();\n } catch (RuntimeException e) {\n Throwable cause = e.getCause();\n assertThat(cause).isInstanceOf(ElementException.class);\n assertThat(cause)\n .hasMessageThat()\n .startsWith(\n \"Element 'foo' does not have a match in class retrofit2.converter.simplexml.MyObject\");\n }\n }\n\n @Test\n public void deserializeWrongClass() throws IOException {\n server.enqueue(\n new MockResponse()\n .setBody(\"hello world10\"));\n\n Call call = service.wrongClass();\n try {\n call.execute();\n fail();\n } catch (RuntimeException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\"Could not deserialize body as class java.lang.String\");\n }\n }\n}\n" }, { "path": "retrofit-converters/wire/README.md", "content": "Wire Converter\n==============\n\nA `Converter` which uses [Wire][1] for protocol buffer-compatible serialization.\n\n\nDownload\n--------\n\nDownload [the latest JAR][2] or grab via [Maven][3]:\n```xml\n\n com.squareup.retrofit2\n converter-wire\n latest.version\n\n```\nor [Gradle][3]:\n```groovy\nimplementation 'com.squareup.retrofit2:converter-wire:latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n\n\n [1]: https://github.com/square/wire\n [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=converter-wire&v=LATEST\n [3]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.retrofit2%22%20a%3A%22converter-wire%22\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-converters/wire/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n api(libs.wireRuntime) {\n // Make sure OkHttp's transitive version wins (itself transitive from Retrofit).\n exclude group: 'com.squareup.okio', module: 'okio'\n }\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.okhttp.mockwebserver\n testImplementation libs.testParameterInjector\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.converter.wire'\n }\n}\n" }, { "path": "retrofit-converters/wire/gradle.properties", "content": "POM_ARTIFACT_ID=converter-wire\nPOM_NAME=Converter: Wire\nPOM_DESCRIPTION=A Retrofit Converter which uses Wire for serialization.\n" }, { "path": "retrofit-converters/wire/src/main/java/retrofit2/converter/wire/WireConverterFactory.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.wire;\n\nimport com.squareup.wire.Message;\nimport com.squareup.wire.ProtoAdapter;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport retrofit2.Call;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\n\n/**\n * A {@linkplain Converter.Factory converter} that uses Wire for protocol buffers.\n *\n *

This converter only applies for types which extend from {@link Message}.\n */\npublic final class WireConverterFactory extends Converter.Factory {\n /**\n * Create an instance which serializes request messages to bytes eagerly on the caller thread\n * when either {@link Call#execute()} or {@link Call#enqueue} is called. Response bytes are\n * always converted to message instances on one of OkHttp's background threads.\n */\n public static WireConverterFactory create() {\n return new WireConverterFactory(false);\n }\n\n private final boolean streaming;\n\n private WireConverterFactory(boolean streaming) {\n this.streaming = streaming;\n }\n\n /**\n * Return a new factory which streams serialization of request messages to bytes on the HTTP thread\n * This is either the calling thread for {@link Call#execute()}, or one of OkHttp's background\n * threads for {@link Call#enqueue}. Response bytes are always converted to message instances on\n * one of OkHttp's background threads.\n */\n public WireConverterFactory withStreaming() {\n return new WireConverterFactory(true);\n }\n\n @Override\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n if (!(type instanceof Class)) {\n return null;\n }\n Class c = (Class) type;\n if (!Message.class.isAssignableFrom(c)) {\n return null;\n }\n //noinspection unchecked\n ProtoAdapter adapter = ProtoAdapter.get((Class) c);\n return new WireResponseBodyConverter<>(adapter);\n }\n\n @Override\n public @Nullable Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n if (!(type instanceof Class)) {\n return null;\n }\n Class c = (Class) type;\n if (!Message.class.isAssignableFrom(c)) {\n return null;\n }\n //noinspection unchecked\n ProtoAdapter adapter = ProtoAdapter.get((Class) c);\n return new WireRequestBodyConverter<>(adapter, streaming);\n }\n}\n" }, { "path": "retrofit-converters/wire/src/main/java/retrofit2/converter/wire/WireRequestBodyConverter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.wire;\n\nimport com.squareup.wire.Message;\nimport com.squareup.wire.ProtoAdapter;\nimport java.io.IOException;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okio.Buffer;\nimport retrofit2.Converter;\n\nfinal class WireRequestBodyConverter> implements Converter {\n static final MediaType MEDIA_TYPE = MediaType.get(\"application/x-protobuf\");\n\n private final ProtoAdapter adapter;\n private final boolean streaming;\n\n WireRequestBodyConverter(ProtoAdapter adapter, boolean streaming) {\n this.adapter = adapter;\n this.streaming = streaming;\n }\n\n @Override\n public RequestBody convert(T value) throws IOException {\n if (streaming) {\n return new WireStreamingRequestBody<>(adapter, value);\n }\n\n Buffer buffer = new Buffer();\n adapter.encode(buffer, value);\n return RequestBody.create(MEDIA_TYPE, buffer.snapshot());\n }\n}\n" }, { "path": "retrofit-converters/wire/src/main/java/retrofit2/converter/wire/WireResponseBodyConverter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.wire;\n\nimport com.squareup.wire.Message;\nimport com.squareup.wire.ProtoAdapter;\nimport java.io.IOException;\nimport okhttp3.ResponseBody;\nimport retrofit2.Converter;\n\nfinal class WireResponseBodyConverter>\n implements Converter {\n private final ProtoAdapter adapter;\n\n WireResponseBodyConverter(ProtoAdapter adapter) {\n this.adapter = adapter;\n }\n\n @Override\n public T convert(ResponseBody value) throws IOException {\n try {\n return adapter.decode(value.source());\n } finally {\n value.close();\n }\n }\n}\n" }, { "path": "retrofit-converters/wire/src/main/java/retrofit2/converter/wire/WireStreamingRequestBody.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.wire;\n\nimport static retrofit2.converter.wire.WireRequestBodyConverter.MEDIA_TYPE;\n\nimport com.squareup.wire.Message;\nimport com.squareup.wire.ProtoAdapter;\nimport java.io.IOException;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okio.BufferedSink;\n\nfinal class WireStreamingRequestBody> extends RequestBody {\n private final ProtoAdapter adapter;\n private final T value;\n\n WireStreamingRequestBody(ProtoAdapter adapter, T value) {\n this.adapter = adapter;\n this.value = value;\n }\n\n @Override\n public MediaType contentType() {\n return MEDIA_TYPE;\n }\n\n @Override\n public void writeTo(BufferedSink sink) throws IOException {\n adapter.encode(sink, value);\n }\n}\n" }, { "path": "retrofit-converters/wire/src/main/java/retrofit2/converter/wire/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.converter.wire;\n" }, { "path": "retrofit-converters/wire/src/main/resources/META-INF/proguard/retrofit2-wire-converter.pro", "content": "# ADAPTER field is looked up reflectively.\n-keepclassmembers class * extends com.squareup.wire.Message {\n public static com.squareup.wire.ProtoAdapter ADAPTER;\n}\n" }, { "path": "retrofit-converters/wire/src/test/java/retrofit2/converter/wire/CrashingPhone.java", "content": "// Code generated by Wire protocol buffer compiler, do not edit.\n// Source file: phone.proto at 6:1\npackage retrofit2.converter.wire;\n\nimport com.squareup.wire.FieldEncoding;\nimport com.squareup.wire.Message;\nimport com.squareup.wire.ProtoAdapter;\nimport com.squareup.wire.ProtoReader;\nimport com.squareup.wire.ProtoWriter;\nimport com.squareup.wire.WireField;\nimport com.squareup.wire.internal.Internal;\nimport java.io.EOFException;\nimport java.io.IOException;\nimport okio.ByteString;\n\npublic final class CrashingPhone extends Message {\n public static final ProtoAdapter ADAPTER = new ProtoAdapter_CrashingPhone();\n\n private static final long serialVersionUID = 0L;\n\n public static final String DEFAULT_NUMBER = \"\";\n\n @WireField(tag = 1, adapter = \"com.squareup.wire.ProtoAdapter#STRING\")\n public final String number;\n\n public CrashingPhone(String number) {\n this(number, ByteString.EMPTY);\n }\n\n public CrashingPhone(String number, ByteString unknownFields) {\n super(ADAPTER, unknownFields);\n this.number = number;\n }\n\n @Override\n public Builder newBuilder() {\n Builder builder = new Builder();\n builder.number = number;\n builder.addUnknownFields(unknownFields());\n return builder;\n }\n\n @Override\n public boolean equals(Object other) {\n if (other == this) return true;\n if (!(other instanceof CrashingPhone)) return false;\n CrashingPhone o = (CrashingPhone) other;\n return Internal.equals(unknownFields(), o.unknownFields()) && Internal.equals(number, o.number);\n }\n\n @Override\n public int hashCode() {\n int result = super.hashCode;\n if (result == 0) {\n result = unknownFields().hashCode();\n result = result * 37 + (number != null ? number.hashCode() : 0);\n super.hashCode = result;\n }\n return result;\n }\n\n @Override\n public String toString() {\n StringBuilder builder = new StringBuilder();\n if (number != null) builder.append(\", number=\").append(number);\n return builder.replace(0, 2, \"Phone{\").append('}').toString();\n }\n\n public static final class Builder extends Message.Builder {\n public String number;\n\n public Builder() {}\n\n public Builder number(String number) {\n this.number = number;\n return this;\n }\n\n @Override\n public CrashingPhone build() {\n return new CrashingPhone(number, buildUnknownFields());\n }\n }\n\n private static final class ProtoAdapter_CrashingPhone extends ProtoAdapter {\n ProtoAdapter_CrashingPhone() {\n super(FieldEncoding.LENGTH_DELIMITED, CrashingPhone.class);\n }\n\n @Override\n public int encodedSize(CrashingPhone value) {\n return (value.number != null ? ProtoAdapter.STRING.encodedSizeWithTag(1, value.number) : 0)\n + value.unknownFields().size();\n }\n\n @Override\n public void encode(ProtoWriter writer, CrashingPhone value) throws IOException {\n throw new EOFException(\"oops!\");\n }\n\n @Override\n public CrashingPhone decode(ProtoReader reader) throws IOException {\n Builder builder = new Builder();\n long token = reader.beginMessage();\n for (int tag; (tag = reader.nextTag()) != -1; ) {\n switch (tag) {\n case 1:\n builder.number(ProtoAdapter.STRING.decode(reader));\n break;\n default:\n {\n FieldEncoding fieldEncoding = reader.peekFieldEncoding();\n Object value = fieldEncoding.rawProtoAdapter().decode(reader);\n builder.addUnknownField(tag, fieldEncoding, value);\n }\n }\n }\n reader.endMessage(token);\n return builder.build();\n }\n\n @Override\n public CrashingPhone redact(CrashingPhone value) {\n Builder builder = value.newBuilder();\n builder.clearUnknownFields();\n return builder.build();\n }\n }\n}\n" }, { "path": "retrofit-converters/wire/src/test/java/retrofit2/converter/wire/Phone.java", "content": "// Code generated by Wire protocol buffer compiler, do not edit.\n// Source file: phone.proto at 6:1\npackage retrofit2.converter.wire;\n\nimport com.squareup.wire.FieldEncoding;\nimport com.squareup.wire.Message;\nimport com.squareup.wire.ProtoAdapter;\nimport com.squareup.wire.ProtoReader;\nimport com.squareup.wire.ProtoWriter;\nimport com.squareup.wire.WireField;\nimport com.squareup.wire.internal.Internal;\nimport java.io.IOException;\nimport okio.ByteString;\n\npublic final class Phone extends Message {\n public static final ProtoAdapter ADAPTER = new ProtoAdapter_Phone();\n\n private static final long serialVersionUID = 0L;\n\n public static final String DEFAULT_NUMBER = \"\";\n\n @WireField(tag = 1, adapter = \"com.squareup.wire.ProtoAdapter#STRING\")\n public final String number;\n\n public Phone(String number) {\n this(number, ByteString.EMPTY);\n }\n\n public Phone(String number, ByteString unknownFields) {\n super(ADAPTER, unknownFields);\n this.number = number;\n }\n\n @Override\n public Builder newBuilder() {\n Builder builder = new Builder();\n builder.number = number;\n builder.addUnknownFields(unknownFields());\n return builder;\n }\n\n @Override\n public boolean equals(Object other) {\n if (other == this) return true;\n if (!(other instanceof Phone)) return false;\n Phone o = (Phone) other;\n return Internal.equals(unknownFields(), o.unknownFields()) && Internal.equals(number, o.number);\n }\n\n @Override\n public int hashCode() {\n int result = super.hashCode;\n if (result == 0) {\n result = unknownFields().hashCode();\n result = result * 37 + (number != null ? number.hashCode() : 0);\n super.hashCode = result;\n }\n return result;\n }\n\n @Override\n public String toString() {\n StringBuilder builder = new StringBuilder();\n if (number != null) builder.append(\", number=\").append(number);\n return builder.replace(0, 2, \"Phone{\").append('}').toString();\n }\n\n public static final class Builder extends Message.Builder {\n public String number;\n\n public Builder() {}\n\n public Builder number(String number) {\n this.number = number;\n return this;\n }\n\n @Override\n public Phone build() {\n return new Phone(number, buildUnknownFields());\n }\n }\n\n private static final class ProtoAdapter_Phone extends ProtoAdapter {\n ProtoAdapter_Phone() {\n super(FieldEncoding.LENGTH_DELIMITED, Phone.class);\n }\n\n @Override\n public int encodedSize(Phone value) {\n return (value.number != null ? ProtoAdapter.STRING.encodedSizeWithTag(1, value.number) : 0)\n + value.unknownFields().size();\n }\n\n @Override\n public void encode(ProtoWriter writer, Phone value) throws IOException {\n if (value.number != null) ProtoAdapter.STRING.encodeWithTag(writer, 1, value.number);\n writer.writeBytes(value.unknownFields());\n }\n\n @Override\n public Phone decode(ProtoReader reader) throws IOException {\n Builder builder = new Builder();\n long token = reader.beginMessage();\n for (int tag; (tag = reader.nextTag()) != -1; ) {\n switch (tag) {\n case 1:\n builder.number(ProtoAdapter.STRING.decode(reader));\n break;\n default:\n {\n FieldEncoding fieldEncoding = reader.peekFieldEncoding();\n Object value = fieldEncoding.rawProtoAdapter().decode(reader);\n builder.addUnknownField(tag, fieldEncoding, value);\n }\n }\n }\n reader.endMessage(token);\n return builder.build();\n }\n\n @Override\n public Phone redact(Phone value) {\n Builder builder = value.newBuilder();\n builder.clearUnknownFields();\n return builder.build();\n }\n }\n}\n" }, { "path": "retrofit-converters/wire/src/test/java/retrofit2/converter/wire/WireConverterFactoryTest.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.converter.wire;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\nimport static org.junit.Assume.assumeTrue;\n\nimport com.google.testing.junit.testparameterinjector.TestParameter;\nimport com.google.testing.junit.testparameterinjector.TestParameterInjector;\nimport java.io.EOFException;\nimport java.io.IOException;\nimport java.util.List;\nimport java.util.concurrent.CountDownLatch;\nimport java.util.concurrent.atomic.AtomicReference;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport okhttp3.mockwebserver.RecordedRequest;\nimport okio.Buffer;\nimport okio.ByteString;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.runner.RunWith;\nimport retrofit2.Call;\nimport retrofit2.Callback;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.Body;\nimport retrofit2.http.GET;\nimport retrofit2.http.POST;\n\n@RunWith(TestParameterInjector.class)\npublic final class WireConverterFactoryTest {\n interface Service {\n @GET(\"/\")\n Call get();\n\n @POST(\"/\")\n Call post(@Body Phone impl);\n\n @POST(\"/\")\n Call postCrashing(@Body CrashingPhone impl);\n\n @GET(\"/\")\n Call wrongClass();\n\n @GET(\"/\")\n Call> wrongType();\n }\n\n @Rule public final MockWebServer server = new MockWebServer();\n\n private final Service service;\n private final boolean streaming;\n\n public WireConverterFactoryTest(@TestParameter boolean streaming) {\n this.streaming = streaming;\n\n WireConverterFactory factory = WireConverterFactory.create();\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(streaming ? factory.withStreaming() : factory)\n .build();\n service = retrofit.create(Service.class);\n }\n\n @Test\n public void serializeAndDeserialize() throws IOException, InterruptedException {\n ByteString encoded = ByteString.decodeBase64(\"Cg4oNTE5KSA4NjctNTMwOQ==\");\n server.enqueue(new MockResponse().setBody(new Buffer().write(encoded)));\n\n Call call = service.post(new Phone(\"(519) 867-5309\"));\n Response response = call.execute();\n Phone body = response.body();\n assertThat(body.number).isEqualTo(\"(519) 867-5309\");\n\n RecordedRequest request = server.takeRequest();\n assertThat(request.getBody().readByteString()).isEqualTo(encoded);\n assertThat(request.getHeader(\"Content-Type\")).isEqualTo(\"application/x-protobuf\");\n }\n\n @Test\n public void serializeIsStreamed() throws IOException, InterruptedException {\n assumeTrue(streaming);\n\n Call call = service.postCrashing(new CrashingPhone(\"(519) 867-5309\"));\n\n final AtomicReference throwableRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n\n // If streaming were broken, the call to enqueue would throw the exception synchronously.\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n latch.countDown();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n throwableRef.set(t);\n latch.countDown();\n }\n });\n latch.await();\n\n Throwable throwable = throwableRef.get();\n assertThat(throwable).isInstanceOf(EOFException.class);\n assertThat(throwable).hasMessageThat().isEqualTo(\"oops!\");\n }\n\n @Test\n public void deserializeEmpty() throws IOException {\n server.enqueue(new MockResponse());\n\n Call call = service.get();\n Response response = call.execute();\n Phone body = response.body();\n assertThat(body.number).isNull();\n }\n\n @Test\n public void deserializeWrongClass() throws IOException {\n ByteString encoded = ByteString.decodeBase64(\"Cg4oNTE5KSA4NjctNTMwOQ==\");\n server.enqueue(new MockResponse().setBody(new Buffer().write(encoded)));\n\n try {\n service.wrongClass();\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Unable to create converter for class java.lang.String\\n\"\n + \" for method Service.wrongClass\");\n assertThat(e.getCause())\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Could not locate ResponseBody converter for class java.lang.String.\\n\"\n + \" Tried:\\n\"\n + \" * retrofit2.BuiltInConverters\\n\"\n + \" * retrofit2.converter.wire.WireConverterFactory\\n\"\n + \" * retrofit2.OptionalConverterFactory\");\n }\n }\n\n @Test\n public void deserializeWrongType() throws IOException {\n ByteString encoded = ByteString.decodeBase64(\"Cg4oNTE5KSA4NjctNTMwOQ==\");\n server.enqueue(new MockResponse().setBody(new Buffer().write(encoded)));\n\n try {\n service.wrongType();\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e)\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Unable to create converter for java.util.List\\n\"\n + \" for method Service.wrongType\");\n assertThat(e.getCause())\n .hasMessageThat()\n .isEqualTo(\n \"\"\n + \"Could not locate ResponseBody converter for java.util.List.\\n\"\n + \" Tried:\\n\"\n + \" * retrofit2.BuiltInConverters\\n\"\n + \" * retrofit2.converter.wire.WireConverterFactory\\n\"\n + \" * retrofit2.OptionalConverterFactory\");\n }\n }\n\n @Test\n public void deserializeWrongValue() throws IOException {\n ByteString encoded = ByteString.decodeBase64(\"////\");\n server.enqueue(new MockResponse().setBody(new Buffer().write(encoded)));\n\n Call call = service.get();\n try {\n call.execute();\n fail();\n } catch (EOFException ignored) {\n }\n }\n}\n" }, { "path": "retrofit-mock/README.md", "content": "Mock Web Server\n==============\n\nA mock web server for mocking HTTP responses from a server, and simulating network behaviour.\n\nDownload\n--------\n\nDownload [the latest JAR][1] or grab via [Maven][2]:\n```xml\n\n com.squareup.retrofit2\n retrofit-mock\n see.latest.version\n\n```\nor [Gradle][1]:\n```groovy\nimplementation 'com.squareup.retrofit2:retrofit-mock:see.latest.version'\n```\n\nSnapshots of the development version are available in [Sonatype's `snapshots` repository][snap].\n\n [1]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=retrofit-mock&v=LATEST\n [2]: http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22retrofit-mock%22\n [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/\n" }, { "path": "retrofit-mock/build.gradle", "content": "apply plugin: 'java-library'\napply plugin: 'org.jetbrains.kotlin.jvm'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n api projects.retrofit\n compileOnly libs.kotlin.stdLib\n compileOnly libs.findBugsAnnotations\n\n testImplementation libs.junit\n testImplementation libs.truth\n testImplementation libs.kotlin.stdLib\n testImplementation libs.kotlinx.coroutines\n}\n\njar {\n manifest {\n attributes 'Automatic-Module-Name': 'retrofit2.mock'\n }\n}\n" }, { "path": "retrofit-mock/gradle.properties", "content": "POM_ARTIFACT_ID=retrofit-mock\nPOM_NAME=Retrofit Mock Adapter\nPOM_DESCRIPTION=An add-on to Retrofit for implementing fake services.\n" }, { "path": "retrofit-mock/src/main/java/retrofit2/mock/BehaviorCall.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.mock;\n\nimport static java.util.concurrent.TimeUnit.MILLISECONDS;\n\nimport java.io.IOException;\nimport java.util.concurrent.CountDownLatch;\nimport java.util.concurrent.ExecutorService;\nimport java.util.concurrent.Future;\nimport java.util.concurrent.atomic.AtomicReference;\nimport javax.annotation.Nullable;\nimport javax.annotation.concurrent.GuardedBy;\nimport okhttp3.Request;\nimport okio.Timeout;\nimport retrofit2.Call;\nimport retrofit2.Callback;\nimport retrofit2.Response;\n\nfinal class BehaviorCall implements Call {\n final NetworkBehavior behavior;\n final ExecutorService backgroundExecutor;\n final Call delegate;\n\n private volatile @Nullable Future task;\n volatile boolean canceled;\n\n @GuardedBy(\"this\")\n private boolean executed;\n\n BehaviorCall(NetworkBehavior behavior, ExecutorService backgroundExecutor, Call delegate) {\n this.behavior = behavior;\n this.backgroundExecutor = backgroundExecutor;\n this.delegate = delegate;\n }\n\n @SuppressWarnings(\"CloneDoesntCallSuperClone\") // We are a final type & this saves clearing state.\n @Override\n public Call clone() {\n return new BehaviorCall<>(behavior, backgroundExecutor, delegate.clone());\n }\n\n @Override\n public Request request() {\n return delegate.request();\n }\n\n @Override\n public Timeout timeout() {\n return delegate.timeout();\n }\n\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n @Override\n public void enqueue(final Callback callback) {\n if (callback == null) throw new NullPointerException(\"callback == null\");\n\n synchronized (this) {\n if (executed) throw new IllegalStateException(\"Already executed\");\n executed = true;\n }\n task =\n backgroundExecutor.submit(\n new Runnable() {\n boolean delaySleep() {\n long sleepMs = behavior.calculateDelay(MILLISECONDS);\n if (sleepMs > 0) {\n try {\n Thread.sleep(sleepMs);\n } catch (InterruptedException e) {\n callback.onFailure(BehaviorCall.this, new IOException(\"canceled\", e));\n return false;\n }\n }\n return true;\n }\n\n @Override\n public void run() {\n if (canceled) {\n callback.onFailure(BehaviorCall.this, new IOException(\"canceled\"));\n } else if (behavior.calculateIsFailure()) {\n if (delaySleep()) {\n callback.onFailure(BehaviorCall.this, behavior.failureException());\n }\n } else if (behavior.calculateIsError()) {\n if (delaySleep()) {\n //noinspection unchecked An error response has no body.\n callback.onResponse(\n BehaviorCall.this, (Response) behavior.createErrorResponse());\n }\n } else {\n delegate.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n if (delaySleep()) {\n callback.onResponse(call, response);\n }\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n if (delaySleep()) {\n callback.onFailure(call, t);\n }\n }\n });\n }\n }\n });\n }\n\n @Override\n public synchronized boolean isExecuted() {\n return executed;\n }\n\n @Override\n public Response execute() throws IOException {\n final AtomicReference> responseRef = new AtomicReference<>();\n final AtomicReference failureRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n responseRef.set(response);\n latch.countDown();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n failureRef.set(t);\n latch.countDown();\n }\n });\n try {\n latch.await();\n } catch (InterruptedException e) {\n throw new IOException(\"canceled\", e);\n }\n Response response = responseRef.get();\n if (response != null) return response;\n Throwable failure = failureRef.get();\n if (failure instanceof RuntimeException) throw (RuntimeException) failure;\n if (failure instanceof IOException) throw (IOException) failure;\n throw new RuntimeException(failure);\n }\n\n @Override\n public void cancel() {\n canceled = true;\n Future task = this.task;\n if (task != null) {\n task.cancel(true);\n }\n }\n\n @Override\n public boolean isCanceled() {\n return canceled;\n }\n}\n" }, { "path": "retrofit-mock/src/main/java/retrofit2/mock/BehaviorDelegate.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.mock;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Method;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Proxy;\nimport java.lang.reflect.Type;\nimport java.lang.reflect.WildcardType;\nimport java.util.concurrent.ExecutorService;\nimport javax.annotation.Nullable;\nimport kotlin.coroutines.Continuation;\nimport retrofit2.Call;\nimport retrofit2.CallAdapter;\nimport retrofit2.KotlinExtensions;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\n\n/**\n * Applies {@linkplain NetworkBehavior behavior} to responses and adapts them into the appropriate\n * return type using the {@linkplain Retrofit#callAdapterFactories() call adapters} of {@link\n * Retrofit}.\n *\n * @see MockRetrofit#create(Class)\n */\npublic final class BehaviorDelegate {\n final Retrofit retrofit;\n private final NetworkBehavior behavior;\n private final ExecutorService executor;\n private final Class service;\n\n BehaviorDelegate(\n Retrofit retrofit, NetworkBehavior behavior, ExecutorService executor, Class service) {\n this.retrofit = retrofit;\n this.behavior = behavior;\n this.executor = executor;\n this.service = service;\n }\n\n public T returningResponse(@Nullable Object response) {\n return returning(Calls.response(response));\n }\n\n @SuppressWarnings(\"unchecked\") // Single-interface proxy creation guarded by parameter safety.\n public T returning(Call call) {\n final Call behaviorCall = new BehaviorCall<>(behavior, executor, call);\n return (T)\n Proxy.newProxyInstance(\n service.getClassLoader(),\n new Class[] {service},\n (proxy, method, args) -> {\n ServiceMethodAdapterInfo adapterInfo = parseServiceMethodAdapterInfo(method);\n\n Annotation[] methodAnnotations = method.getAnnotations();\n CallAdapter callAdapter =\n (CallAdapter)\n retrofit.callAdapter(adapterInfo.responseType, methodAnnotations);\n\n T adapted = callAdapter.adapt(behaviorCall);\n if (!adapterInfo.isSuspend) {\n return adapted;\n }\n\n Call adaptedCall = (Call) adapted;\n Continuation continuation = (Continuation) args[args.length - 1];\n try {\n return adapterInfo.wantsResponse\n ? KotlinExtensions.awaitResponse(adaptedCall, continuation)\n : KotlinExtensions.await(adaptedCall, continuation);\n } catch (Exception e) {\n return KotlinExtensions.suspendAndThrow(e, continuation);\n }\n });\n }\n\n /**\n * Computes the adapter type of the method for lookup via {@link Retrofit#callAdapter} as well as\n * information on whether the method is a {@code suspend fun}.\n *\n *

In the case of a Kotlin {@code suspend fun}, the last parameter type is a {@code\n * Continuation} whose parameter carries the actual response type. In this case, we return {@code\n * Call} where {@code T} is the body type.\n */\n private static ServiceMethodAdapterInfo parseServiceMethodAdapterInfo(Method method) {\n Type[] genericParameterTypes = method.getGenericParameterTypes();\n if (genericParameterTypes.length != 0) {\n Type lastParameterType = genericParameterTypes[genericParameterTypes.length - 1];\n if (lastParameterType instanceof ParameterizedType) {\n ParameterizedType parameterizedLastParameterType = (ParameterizedType) lastParameterType;\n try {\n if (parameterizedLastParameterType.getRawType() == Continuation.class) {\n Type resultType = parameterizedLastParameterType.getActualTypeArguments()[0];\n if (resultType instanceof WildcardType) {\n resultType = ((WildcardType) resultType).getLowerBounds()[0];\n }\n if (resultType instanceof ParameterizedType) {\n ParameterizedType parameterizedResultType = (ParameterizedType) resultType;\n if (parameterizedResultType.getRawType() == Response.class) {\n Type bodyType = parameterizedResultType.getActualTypeArguments()[0];\n Type callType = new CallParameterizedTypeImpl(bodyType);\n return new ServiceMethodAdapterInfo(true, true, callType);\n }\n }\n Type callType = new CallParameterizedTypeImpl(resultType);\n return new ServiceMethodAdapterInfo(true, false, callType);\n }\n } catch (NoClassDefFoundError ignored) {\n // Not using coroutines.\n }\n }\n }\n return new ServiceMethodAdapterInfo(false, false, method.getGenericReturnType());\n }\n\n static final class CallParameterizedTypeImpl implements ParameterizedType {\n private final Type bodyType;\n\n CallParameterizedTypeImpl(Type bodyType) {\n this.bodyType = bodyType;\n }\n\n @Override\n public Type[] getActualTypeArguments() {\n return new Type[] {bodyType};\n }\n\n @Override\n public Type getRawType() {\n return Call.class;\n }\n\n @Override\n public @Nullable Type getOwnerType() {\n return null;\n }\n }\n\n static class ServiceMethodAdapterInfo {\n final boolean isSuspend;\n\n /**\n * Whether the suspend function return type was {@code Response}. Only meaningful if {@link\n * #isSuspend} is true.\n */\n final boolean wantsResponse;\n\n final Type responseType;\n\n ServiceMethodAdapterInfo(boolean isSuspend, boolean wantsResponse, Type responseType) {\n this.isSuspend = isSuspend;\n this.wantsResponse = wantsResponse;\n this.responseType = responseType;\n }\n }\n}\n" }, { "path": "retrofit-mock/src/main/java/retrofit2/mock/Calls.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.mock;\n\nimport java.io.IOException;\nimport java.util.concurrent.Callable;\nimport java.util.concurrent.atomic.AtomicBoolean;\nimport javax.annotation.Nullable;\nimport okhttp3.Request;\nimport okio.Timeout;\nimport retrofit2.Call;\nimport retrofit2.Callback;\nimport retrofit2.Response;\n\n/** Factory methods for creating {@link Call} instances which immediately respond or fail. */\npublic final class Calls {\n /**\n * Invokes {@code callable} once for the returned {@link Call} and once for each instance that is\n * obtained from {@linkplain Call#clone() cloning} the returned {@link Call}.\n */\n public static Call defer(Callable> callable) {\n return new DeferredCall<>(callable);\n }\n\n public static Call response(@Nullable T successValue) {\n return new FakeCall<>(Response.success(successValue), null);\n }\n\n public static Call response(Response response) {\n return new FakeCall<>(response, null);\n }\n\n /** Creates a failed {@link Call} from {@code failure}. */\n public static Call failure(IOException failure) {\n // TODO delete this overload in Retrofit 3.0.\n return new FakeCall<>(null, failure);\n }\n\n /**\n * Creates a failed {@link Call} from {@code failure}.\n *\n *

Note: When invoking {@link Call#execute() execute()} on the returned {@link Call}, if {@code\n * failure} is a {@link RuntimeException}, {@link Error}, or {@link IOException} subtype it is\n * thrown directly. Otherwise it is \"sneaky thrown\" despite not being declared.\n */\n public static Call failure(Throwable failure) {\n return new FakeCall<>(null, failure);\n }\n\n private Calls() {\n throw new AssertionError(\"No instances.\");\n }\n\n static final class FakeCall implements Call {\n private final Response response;\n private final Throwable error;\n private final AtomicBoolean canceled = new AtomicBoolean();\n private final AtomicBoolean executed = new AtomicBoolean();\n\n FakeCall(@Nullable Response response, @Nullable Throwable error) {\n if ((response == null) == (error == null)) {\n throw new AssertionError(\"Only one of response or error can be set.\");\n }\n this.response = response;\n this.error = error;\n }\n\n @Override\n public Response execute() throws IOException {\n if (!executed.compareAndSet(false, true)) {\n throw new IllegalStateException(\"Already executed\");\n }\n if (canceled.get()) {\n throw new IOException(\"canceled\");\n }\n if (response != null) {\n return response;\n }\n throw FakeCall.sneakyThrow(error);\n }\n\n // Intentionally abusing this feature.\n @SuppressWarnings({\"unchecked\", \"TypeParameterUnusedInFormals\"})\n private static T sneakyThrow(Throwable t) throws T {\n throw (T) t;\n }\n\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n @Override\n public void enqueue(Callback callback) {\n if (callback == null) {\n throw new NullPointerException(\"callback == null\");\n }\n if (!executed.compareAndSet(false, true)) {\n throw new IllegalStateException(\"Already executed\");\n }\n if (canceled.get()) {\n callback.onFailure(this, new IOException(\"canceled\"));\n } else if (response != null) {\n callback.onResponse(this, response);\n } else {\n callback.onFailure(this, error);\n }\n }\n\n @Override\n public boolean isExecuted() {\n return executed.get();\n }\n\n @Override\n public void cancel() {\n canceled.set(true);\n }\n\n @Override\n public boolean isCanceled() {\n return canceled.get();\n }\n\n @Override\n public Call clone() {\n return new FakeCall<>(response, error);\n }\n\n @Override\n public Request request() {\n if (response != null) {\n return response.raw().request();\n }\n return new Request.Builder().url(\"http://localhost\").build();\n }\n\n @Override\n public Timeout timeout() {\n return Timeout.NONE;\n }\n }\n\n static final class DeferredCall implements Call {\n private final Callable> callable;\n private @Nullable Call delegate;\n\n DeferredCall(Callable> callable) {\n this.callable = callable;\n }\n\n private synchronized Call getDelegate() {\n Call delegate = this.delegate;\n if (delegate == null) {\n try {\n delegate = callable.call();\n } catch (Exception e) {\n delegate = failure(e);\n }\n this.delegate = delegate;\n }\n return delegate;\n }\n\n @Override\n public Response execute() throws IOException {\n return getDelegate().execute();\n }\n\n @Override\n public void enqueue(Callback callback) {\n getDelegate().enqueue(callback);\n }\n\n @Override\n public boolean isExecuted() {\n return getDelegate().isExecuted();\n }\n\n @Override\n public void cancel() {\n getDelegate().cancel();\n }\n\n @Override\n public boolean isCanceled() {\n return getDelegate().isCanceled();\n }\n\n @Override\n public Call clone() {\n return new DeferredCall<>(callable);\n }\n\n @Override\n public Request request() {\n return getDelegate().request();\n }\n\n @Override\n public Timeout timeout() {\n return getDelegate().timeout();\n }\n }\n}\n" }, { "path": "retrofit-mock/src/main/java/retrofit2/mock/KotlinExtensions.kt", "content": "/*\n * Copyright (C) 2019 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.mock\n\ninline fun MockRetrofit.create(): BehaviorDelegate = create(T::class.java)\n" }, { "path": "retrofit-mock/src/main/java/retrofit2/mock/MockRetrofit.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.mock;\n\nimport java.util.concurrent.Executor;\nimport java.util.concurrent.ExecutorService;\nimport java.util.concurrent.Executors;\nimport javax.annotation.Nullable;\nimport retrofit2.Retrofit;\n\npublic final class MockRetrofit {\n private final Retrofit retrofit;\n private final NetworkBehavior behavior;\n private final ExecutorService executor;\n\n MockRetrofit(Retrofit retrofit, NetworkBehavior behavior, ExecutorService executor) {\n this.retrofit = retrofit;\n this.behavior = behavior;\n this.executor = executor;\n }\n\n public Retrofit retrofit() {\n return retrofit;\n }\n\n public NetworkBehavior networkBehavior() {\n return behavior;\n }\n\n public Executor backgroundExecutor() {\n return executor;\n }\n\n @SuppressWarnings(\"unchecked\") // Single-interface proxy creation guarded by parameter safety.\n public BehaviorDelegate create(Class service) {\n return new BehaviorDelegate<>(retrofit, behavior, executor, service);\n }\n\n public static final class Builder {\n private final Retrofit retrofit;\n private @Nullable NetworkBehavior behavior;\n private @Nullable ExecutorService executor;\n\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public Builder(Retrofit retrofit) {\n if (retrofit == null) throw new NullPointerException(\"retrofit == null\");\n this.retrofit = retrofit;\n }\n\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public Builder networkBehavior(NetworkBehavior behavior) {\n if (behavior == null) throw new NullPointerException(\"behavior == null\");\n this.behavior = behavior;\n return this;\n }\n\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public Builder backgroundExecutor(ExecutorService executor) {\n if (executor == null) throw new NullPointerException(\"executor == null\");\n this.executor = executor;\n return this;\n }\n\n public MockRetrofit build() {\n if (behavior == null) behavior = NetworkBehavior.create();\n if (executor == null) executor = Executors.newCachedThreadPool();\n return new MockRetrofit(retrofit, behavior, executor);\n }\n }\n}\n" }, { "path": "retrofit-mock/src/main/java/retrofit2/mock/MockRetrofitIOException.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.mock;\n\nimport java.io.IOException;\n\nfinal class MockRetrofitIOException extends IOException {\n MockRetrofitIOException() {\n super(\"Failure triggered by MockRetrofit's NetworkBehavior\");\n }\n}\n" }, { "path": "retrofit-mock/src/main/java/retrofit2/mock/NetworkBehavior.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.mock;\n\nimport static java.util.concurrent.TimeUnit.MILLISECONDS;\n\nimport java.io.IOException;\nimport java.util.Random;\nimport java.util.concurrent.Callable;\nimport java.util.concurrent.TimeUnit;\nimport okhttp3.ResponseBody;\nimport retrofit2.Response;\n\n/**\n * A simple emulation of the behavior of network calls.\n *\n *

This class models three properties of a network:\n *\n *

    \n *
  • Delay – the time it takes before a response is received (successful or otherwise).\n *
  • Variance – the amount of fluctuation of the delay to be faster or slower.\n *
  • Failure - the percentage of operations which fail (such as {@link IOException}).\n *
\n *\n * Behavior can be applied to a Retrofit interface with {@link MockRetrofit}. Behavior can also be\n * applied elsewhere using {@link #calculateDelay(TimeUnit)} and {@link #calculateIsFailure()}.\n *\n *

By default, instances of this class will use a 2 second delay with 40% variance. Failures will\n * occur 3% of the time. HTTP errors will occur 0% of the time.\n */\npublic final class NetworkBehavior {\n private static final int DEFAULT_DELAY_MS = 2000; // Network calls will take 2 seconds.\n private static final int DEFAULT_VARIANCE_PERCENT = 40; // Network delay varies by ±40%.\n private static final int DEFAULT_FAILURE_PERCENT = 3; // 3% of network calls will fail.\n private static final int DEFAULT_ERROR_PERCENT = 0; // 0% of network calls will return errors.\n\n /** Create an instance with default behavior. */\n public static NetworkBehavior create() {\n return new NetworkBehavior(new Random());\n }\n\n /**\n * Create an instance with default behavior which uses {@code random} to control variance and\n * failure calculation.\n */\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public static NetworkBehavior create(Random random) {\n if (random == null) throw new NullPointerException(\"random == null\");\n return new NetworkBehavior(random);\n }\n\n private final Random random;\n\n private volatile long delayMs = DEFAULT_DELAY_MS;\n private volatile int variancePercent = DEFAULT_VARIANCE_PERCENT;\n private volatile int failurePercent = DEFAULT_FAILURE_PERCENT;\n private volatile Throwable failureException;\n private volatile int errorPercent = DEFAULT_ERROR_PERCENT;\n private volatile Callable> errorFactory =\n () -> Response.error(500, ResponseBody.create(null, new byte[0]));\n\n private NetworkBehavior(Random random) {\n this.random = random;\n\n failureException = new MockRetrofitIOException();\n failureException.setStackTrace(new StackTraceElement[0]);\n }\n\n /** Set the network round trip delay. */\n public void setDelay(long amount, TimeUnit unit) {\n if (amount < 0) {\n throw new IllegalArgumentException(\"Amount must be positive value.\");\n }\n this.delayMs = unit.toMillis(amount);\n }\n\n /** The network round trip delay. */\n public long delay(TimeUnit unit) {\n return MILLISECONDS.convert(delayMs, unit);\n }\n\n /** Set the plus-or-minus variance percentage of the network round trip delay. */\n public void setVariancePercent(int variancePercent) {\n checkPercentageValidity(variancePercent, \"Variance percentage must be between 0 and 100.\");\n this.variancePercent = variancePercent;\n }\n\n /** The plus-or-minus variance percentage of the network round trip delay. */\n public int variancePercent() {\n return variancePercent;\n }\n\n /** Set the percentage of calls to {@link #calculateIsFailure()} that return {@code true}. */\n public void setFailurePercent(int failurePercent) {\n checkPercentageValidity(failurePercent, \"Failure percentage must be between 0 and 100.\");\n this.failurePercent = failurePercent;\n }\n\n /** The percentage of calls to {@link #calculateIsFailure()} that return {@code true}. */\n public int failurePercent() {\n return failurePercent;\n }\n\n /**\n * Set the exception to be used when a failure is triggered.\n *\n *

It is a best practice to remove the stack trace from {@code exception} since it can\n * misleadingly point to code unrelated to this class.\n */\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public void setFailureException(Throwable exception) {\n if (exception == null) {\n throw new NullPointerException(\"exception == null\");\n }\n this.failureException = exception;\n }\n\n /** The exception to be used when a failure is triggered. */\n public Throwable failureException() {\n return failureException;\n }\n\n /** The percentage of calls to {@link #calculateIsError()} that return {@code true}. */\n public int errorPercent() {\n return errorPercent;\n }\n\n /** Set the percentage of calls to {@link #calculateIsError()} that return {@code true}. */\n public void setErrorPercent(int errorPercent) {\n checkPercentageValidity(errorPercent, \"Error percentage must be between 0 and 100.\");\n this.errorPercent = errorPercent;\n }\n\n /**\n * Set the error response factory to be used when an error is triggered. This factory may only\n * return responses for which {@link Response#isSuccessful()} returns false.\n */\n @SuppressWarnings(\"ConstantConditions\") // Guarding public API nullability.\n public void setErrorFactory(Callable> errorFactory) {\n if (errorFactory == null) {\n throw new NullPointerException(\"errorFactory == null\");\n }\n this.errorFactory = errorFactory;\n }\n\n /** The HTTP error to be used when an error is triggered. */\n public Response createErrorResponse() {\n Response call;\n try {\n call = errorFactory.call();\n } catch (Exception e) {\n throw new IllegalStateException(\"Error factory threw an exception.\", e);\n }\n if (call == null) {\n throw new IllegalStateException(\"Error factory returned null.\");\n }\n if (call.isSuccessful()) {\n throw new IllegalStateException(\"Error factory returned successful response.\");\n }\n return call;\n }\n\n /**\n * Randomly determine whether this call should result in a network failure in accordance with\n * configured behavior. When true, {@link #failureException()} should be thrown.\n */\n public boolean calculateIsFailure() {\n return random.nextInt(100) < failurePercent;\n }\n\n /**\n * Randomly determine whether this call should result in an HTTP error in accordance with\n * configured behavior. When true, {@link #createErrorResponse()} should be returned.\n */\n public boolean calculateIsError() {\n return random.nextInt(100) < errorPercent;\n }\n\n /**\n * Get the delay that should be used for delaying a response in accordance with configured\n * behavior.\n */\n public long calculateDelay(TimeUnit unit) {\n float delta = variancePercent / 100f; // e.g., 20 / 100f == 0.2f\n float lowerBound = 1f - delta; // 0.2f --> 0.8f\n float upperBound = 1f + delta; // 0.2f --> 1.2f\n float bound = upperBound - lowerBound; // 1.2f - 0.8f == 0.4f\n float delayPercent = lowerBound + (random.nextFloat() * bound); // 0.8 + (rnd * 0.4)\n long callDelayMs = (long) (delayMs * delayPercent);\n return MILLISECONDS.convert(callDelayMs, unit);\n }\n\n private static void checkPercentageValidity(int percentage, String message) {\n if (percentage < 0 || percentage > 100) {\n throw new IllegalArgumentException(message);\n }\n }\n}\n" }, { "path": "retrofit-mock/src/main/java/retrofit2/mock/package-info.java", "content": "@retrofit2.internal.EverythingIsNonNull\npackage retrofit2.mock;\n" }, { "path": "retrofit-mock/src/test/java/retrofit2/mock/BehaviorDelegateKotlinTest.kt", "content": "/*\n * Copyright (C) 2019 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.mock\n\nimport com.google.common.truth.Truth.assertThat\nimport java.io.IOException\nimport java.util.Random\nimport java.util.concurrent.TimeUnit.MILLISECONDS\nimport java.util.concurrent.TimeUnit.NANOSECONDS\nimport kotlinx.coroutines.runBlocking\nimport org.junit.Before\nimport org.junit.Test\nimport retrofit2.Response\nimport retrofit2.Retrofit\n\nclass BehaviorDelegateKotlinTest {\n internal interface DoWorkService {\n suspend fun body(): String\n\n suspend fun failure(): String\n\n suspend fun response(): Response\n\n suspend fun responseWildcard(): Response\n }\n\n private val mockFailure = IOException(\"Timeout!\")\n private val behavior = NetworkBehavior.create(Random(2847))\n private lateinit var service: DoWorkService\n\n @Before\n fun before() {\n val retrofit = Retrofit.Builder().baseUrl(\"http://example.com\").build()\n val mockRetrofit = MockRetrofit.Builder(retrofit).networkBehavior(behavior).build()\n val delegate = mockRetrofit.create()\n\n service =\n object : DoWorkService {\n override suspend fun body(): String {\n return delegate.returning(Calls.response(\"Response!\")).body()\n }\n\n override suspend fun failure(): String {\n val failure = Calls.failure(mockFailure)\n return delegate.returning(failure).failure()\n }\n\n override suspend fun response(): Response {\n val response = Calls.response(\"Response!\")\n return delegate.returning(response).response()\n }\n\n override suspend fun responseWildcard() = response()\n }\n }\n\n @Test\n fun body() {\n behavior.setDelay(100, MILLISECONDS)\n behavior.setVariancePercent(0)\n behavior.setFailurePercent(0)\n\n val startNanos = System.nanoTime()\n val result = runBlocking { service.body() }\n val tookMs = NANOSECONDS.toMillis(System.nanoTime() - startNanos)\n\n assertThat(tookMs).isAtLeast(100L)\n assertThat(result).isEqualTo(\"Response!\")\n }\n\n @Test\n fun bodyFailure() {\n behavior.setDelay(100, MILLISECONDS)\n behavior.setVariancePercent(0)\n behavior.setFailurePercent(100)\n\n val startNanos = System.nanoTime()\n val exception = runBlocking {\n try {\n throw AssertionError(service.body())\n } catch (e: Exception) {\n e\n }\n }\n val tookMs = NANOSECONDS.toMillis(System.nanoTime() - startNanos)\n\n assertThat(tookMs).isAtLeast(100L)\n assertThat(exception).isSameInstanceAs(behavior.failureException())\n }\n\n @Test\n fun failure() {\n behavior.setDelay(100, MILLISECONDS)\n behavior.setVariancePercent(0)\n behavior.setFailurePercent(0)\n\n val startNanos = System.nanoTime()\n val exception = runBlocking {\n try {\n throw AssertionError(service.failure())\n } catch (e: Exception) {\n e\n }\n }\n val tookMs = NANOSECONDS.toMillis(System.nanoTime() - startNanos)\n\n assertThat(tookMs).isAtLeast(100L)\n // Coroutines break referential transparency on exceptions so compare type and message.\n assertThat(exception.javaClass).isEqualTo(mockFailure.javaClass)\n assertThat(exception).hasMessageThat().isEqualTo(mockFailure.message)\n }\n\n @Test\n fun response() {\n behavior.setDelay(100, MILLISECONDS)\n behavior.setVariancePercent(0)\n behavior.setFailurePercent(0)\n\n val startNanos = System.nanoTime()\n val result = runBlocking { service.response() }\n val tookMs = NANOSECONDS.toMillis(System.nanoTime() - startNanos)\n\n assertThat(tookMs).isAtLeast(100L)\n assertThat(result.body()).isEqualTo(\"Response!\")\n }\n\n @Test\n fun responseFailure() {\n behavior.setDelay(100, MILLISECONDS)\n behavior.setVariancePercent(0)\n behavior.setFailurePercent(100)\n\n val startNanos = System.nanoTime()\n val exception = runBlocking {\n try {\n throw AssertionError(service.response())\n } catch (e: Exception) {\n e\n }\n }\n val tookMs = NANOSECONDS.toMillis(System.nanoTime() - startNanos)\n\n assertThat(tookMs).isAtLeast(100L)\n assertThat(exception).isSameInstanceAs(behavior.failureException())\n }\n\n @Test\n fun responseWildcard() {\n behavior.setDelay(100, MILLISECONDS)\n behavior.setVariancePercent(0)\n behavior.setFailurePercent(0)\n\n val startNanos = System.nanoTime()\n val result = runBlocking { service.responseWildcard() }\n val tookMs = NANOSECONDS.toMillis(System.nanoTime() - startNanos)\n\n assertThat(tookMs).isAtLeast(100L)\n assertThat(result.body()).isEqualTo(\"Response!\")\n }\n}\n" }, { "path": "retrofit-mock/src/test/java/retrofit2/mock/BehaviorDelegateTest.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\npackage retrofit2.mock;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static java.util.concurrent.TimeUnit.MILLISECONDS;\nimport static java.util.concurrent.TimeUnit.SECONDS;\nimport static org.junit.Assert.assertTrue;\nimport static org.junit.Assert.fail;\n\nimport java.io.IOException;\nimport java.util.Random;\nimport java.util.concurrent.CountDownLatch;\nimport java.util.concurrent.TimeUnit;\nimport java.util.concurrent.atomic.AtomicLong;\nimport java.util.concurrent.atomic.AtomicReference;\nimport org.junit.Before;\nimport org.junit.Test;\nimport retrofit2.Call;\nimport retrofit2.Callback;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\n\npublic final class BehaviorDelegateTest {\n interface DoWorkService {\n Call response();\n\n Call failure();\n }\n\n private final IOException mockFailure = new IOException(\"Timeout!\");\n private final NetworkBehavior behavior = NetworkBehavior.create(new Random(2847));\n private DoWorkService service;\n\n @Before\n public void setUp() {\n Retrofit retrofit = new Retrofit.Builder().baseUrl(\"http://example.com\").build();\n MockRetrofit mockRetrofit =\n new MockRetrofit.Builder(retrofit).networkBehavior(behavior).build();\n final BehaviorDelegate delegate = mockRetrofit.create(DoWorkService.class);\n\n service =\n new DoWorkService() {\n @Override\n public Call response() {\n Call response = Calls.response(\"Response!\");\n return delegate.returning(response).response();\n }\n\n @Override\n public Call failure() {\n Call failure = Calls.failure(mockFailure);\n return delegate.returning(failure).failure();\n }\n };\n }\n\n @Test\n public void syncFailureThrowsAfterDelay() {\n behavior.setDelay(100, MILLISECONDS);\n behavior.setVariancePercent(0);\n behavior.setFailurePercent(100);\n\n Call call = service.response();\n\n long startNanos = System.nanoTime();\n try {\n call.execute();\n fail();\n } catch (IOException e) {\n long tookMs = TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - startNanos);\n assertThat(e).isSameInstanceAs(behavior.failureException());\n assertThat(tookMs).isAtLeast(100);\n }\n }\n\n @Test\n public void asyncFailureTriggersFailureAfterDelay() throws InterruptedException {\n behavior.setDelay(100, MILLISECONDS);\n behavior.setVariancePercent(0);\n behavior.setFailurePercent(100);\n\n Call call = service.response();\n\n final long startNanos = System.nanoTime();\n final AtomicLong tookMs = new AtomicLong();\n final AtomicReference failureRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n throw new AssertionError();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n tookMs.set(TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - startNanos));\n failureRef.set(t);\n latch.countDown();\n }\n });\n assertTrue(latch.await(1, SECONDS));\n\n assertThat(failureRef.get()).isSameInstanceAs(behavior.failureException());\n assertThat(tookMs.get()).isAtLeast(100);\n }\n\n @Test\n public void syncSuccessReturnsAfterDelay() throws IOException {\n behavior.setDelay(100, MILLISECONDS);\n behavior.setVariancePercent(0);\n behavior.setFailurePercent(0);\n\n Call call = service.response();\n\n long startNanos = System.nanoTime();\n Response response = call.execute();\n long tookMs = TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - startNanos);\n\n assertThat(response.body()).isEqualTo(\"Response!\");\n assertThat(tookMs).isAtLeast(100);\n }\n\n @Test\n public void asyncSuccessCalledAfterDelay() throws InterruptedException, IOException {\n behavior.setDelay(100, MILLISECONDS);\n behavior.setVariancePercent(0);\n behavior.setFailurePercent(0);\n\n Call call = service.response();\n\n final long startNanos = System.nanoTime();\n final AtomicLong tookMs = new AtomicLong();\n final AtomicReference actual = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n tookMs.set(TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - startNanos));\n actual.set(response.body());\n latch.countDown();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n throw new AssertionError();\n }\n });\n assertTrue(latch.await(1, SECONDS));\n\n assertThat(actual.get()).isEqualTo(\"Response!\");\n assertThat(tookMs.get()).isAtLeast(100);\n }\n\n @Test\n public void syncFailureThrownAfterDelay() {\n behavior.setDelay(100, MILLISECONDS);\n behavior.setVariancePercent(0);\n behavior.setFailurePercent(0);\n\n Call call = service.failure();\n\n long startNanos = System.nanoTime();\n try {\n call.execute();\n fail();\n } catch (IOException e) {\n long tookMs = TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - startNanos);\n assertThat(tookMs).isAtLeast(100);\n assertThat(e).isSameInstanceAs(mockFailure);\n }\n }\n\n @Test\n public void asyncFailureCalledAfterDelay() throws InterruptedException {\n behavior.setDelay(100, MILLISECONDS);\n behavior.setVariancePercent(0);\n behavior.setFailurePercent(0);\n\n Call call = service.failure();\n\n final AtomicLong tookMs = new AtomicLong();\n final AtomicReference failureRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n final long startNanos = System.nanoTime();\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n throw new AssertionError();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n tookMs.set(TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - startNanos));\n failureRef.set(t);\n latch.countDown();\n }\n });\n assertTrue(latch.await(1, SECONDS));\n\n assertThat(tookMs.get()).isAtLeast(100);\n assertThat(failureRef.get()).isSameInstanceAs(mockFailure);\n }\n\n @Test\n public void syncCanBeCanceled() throws IOException {\n behavior.setDelay(10, SECONDS);\n behavior.setVariancePercent(0);\n behavior.setFailurePercent(0);\n\n final Call call = service.response();\n\n new Thread(\n () -> {\n try {\n Thread.sleep(100);\n call.cancel();\n } catch (InterruptedException ignored) {\n }\n })\n .start();\n\n try {\n call.execute();\n fail();\n } catch (IOException e) {\n // Exact instance check as opposed to isInstanceOf's subtype checking.\n assertThat(e.getClass()).isEqualTo(IOException.class);\n assertThat(e).hasMessageThat().isEqualTo(\"canceled\");\n }\n }\n\n @Test\n public void asyncCanBeCanceled() throws InterruptedException {\n behavior.setDelay(10, SECONDS);\n behavior.setVariancePercent(0);\n behavior.setFailurePercent(0);\n\n final Call call = service.response();\n\n final AtomicReference failureRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n latch.countDown();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n failureRef.set(t);\n latch.countDown();\n }\n });\n\n // TODO we shouldn't need to sleep\n Thread.sleep(100); // Ensure the task has started.\n call.cancel();\n\n assertTrue(latch.await(1, SECONDS));\n\n Throwable failure = failureRef.get();\n // Exact instance check as opposed to isInstanceOf's subtype checking.\n assertThat(failure.getClass()).isEqualTo(IOException.class);\n assertThat(failure).hasMessageThat().isEqualTo(\"canceled\");\n }\n\n @Test\n public void syncCanceledBeforeStart() throws IOException {\n behavior.setDelay(100, MILLISECONDS);\n behavior.setVariancePercent(0);\n behavior.setFailurePercent(0);\n\n final Call call = service.response();\n\n call.cancel();\n try {\n call.execute();\n fail();\n } catch (IOException e) {\n // Exact instance check as opposed to isInstanceOf's subtype checking.\n assertThat(e.getClass()).isEqualTo(IOException.class);\n assertThat(e).hasMessageThat().isEqualTo(\"canceled\");\n }\n }\n\n @Test\n public void asyncCanBeCanceledBeforeStart() throws InterruptedException {\n behavior.setDelay(10, SECONDS);\n behavior.setVariancePercent(0);\n behavior.setFailurePercent(0);\n\n final Call call = service.response();\n call.cancel();\n\n final AtomicReference failureRef = new AtomicReference<>();\n final CountDownLatch latch = new CountDownLatch(1);\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n latch.countDown();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n failureRef.set(t);\n latch.countDown();\n }\n });\n\n assertTrue(latch.await(1, SECONDS));\n\n Throwable failure = failureRef.get();\n // Exact instance check as opposed to isInstanceOf's subtype checking.\n assertThat(failure.getClass()).isEqualTo(IOException.class);\n assertThat(failure).hasMessageThat().isEqualTo(\"canceled\");\n }\n}\n" }, { "path": "retrofit-mock/src/test/java/retrofit2/mock/CallsTest.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.mock;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.assertEquals;\nimport static org.junit.Assert.assertFalse;\nimport static org.junit.Assert.assertSame;\nimport static org.junit.Assert.assertTrue;\nimport static org.junit.Assert.fail;\n\nimport java.io.IOException;\nimport java.security.cert.CertificateException;\nimport java.util.concurrent.Callable;\nimport java.util.concurrent.atomic.AtomicReference;\nimport org.junit.Test;\nimport retrofit2.Call;\nimport retrofit2.Callback;\nimport retrofit2.Response;\n\npublic final class CallsTest {\n @Test\n public void bodyExecute() throws IOException {\n Call taco = Calls.response(\"Taco\");\n assertEquals(\"Taco\", taco.execute().body());\n }\n\n @Test\n public void bodyEnqueue() throws IOException {\n Call taco = Calls.response(\"Taco\");\n final AtomicReference> responseRef = new AtomicReference<>();\n taco.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n responseRef.set(response);\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n fail();\n }\n });\n assertThat(responseRef.get().body()).isEqualTo(\"Taco\");\n }\n\n @Test\n public void responseExecute() throws IOException {\n Response response = Response.success(\"Taco\");\n Call taco = Calls.response(response);\n assertFalse(taco.isExecuted());\n assertSame(response, taco.execute());\n assertTrue(taco.isExecuted());\n try {\n taco.execute();\n fail();\n } catch (IllegalStateException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Already executed\");\n }\n }\n\n @Test\n public void responseEnqueue() {\n Response response = Response.success(\"Taco\");\n Call taco = Calls.response(response);\n assertFalse(taco.isExecuted());\n\n final AtomicReference> responseRef = new AtomicReference<>();\n taco.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n responseRef.set(response);\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n fail();\n }\n });\n assertSame(response, responseRef.get());\n assertTrue(taco.isExecuted());\n\n try {\n taco.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n fail();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n fail();\n }\n });\n fail();\n } catch (IllegalStateException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Already executed\");\n }\n }\n\n @Test\n public void enqueueNullThrows() {\n Call taco = Calls.response(\"Taco\");\n try {\n taco.enqueue(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"callback == null\");\n }\n }\n\n @Test\n public void responseCancelExecute() {\n Call taco = Calls.response(Response.success(\"Taco\"));\n assertFalse(taco.isCanceled());\n taco.cancel();\n assertTrue(taco.isCanceled());\n\n try {\n taco.execute();\n fail();\n } catch (IOException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"canceled\");\n }\n }\n\n @Test\n public void responseCancelEnqueue() throws IOException {\n Call taco = Calls.response(Response.success(\"Taco\"));\n assertFalse(taco.isCanceled());\n taco.cancel();\n assertTrue(taco.isCanceled());\n\n final AtomicReference failureRef = new AtomicReference<>();\n taco.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n fail();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n failureRef.set(t);\n }\n });\n Throwable failure = failureRef.get();\n assertThat(failure).isInstanceOf(IOException.class);\n assertThat(failure).hasMessageThat().isEqualTo(\"canceled\");\n }\n\n @Test\n public void failureExecute() {\n IOException failure = new IOException(\"Hey\");\n Call taco = Calls.failure(failure);\n assertFalse(taco.isExecuted());\n try {\n taco.execute();\n fail();\n } catch (IOException e) {\n assertSame(failure, e);\n }\n assertTrue(taco.isExecuted());\n }\n\n @Test\n public void failureExecuteCheckedException() {\n CertificateException failure = new CertificateException(\"Hey\");\n Call taco = Calls.failure(failure);\n assertFalse(taco.isExecuted());\n try {\n taco.execute();\n fail();\n } catch (Exception e) {\n assertSame(failure, e);\n }\n assertTrue(taco.isExecuted());\n }\n\n @Test\n public void failureEnqueue() {\n IOException failure = new IOException(\"Hey\");\n Call taco = Calls.failure(failure);\n assertFalse(taco.isExecuted());\n\n final AtomicReference failureRef = new AtomicReference<>();\n taco.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n fail();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n failureRef.set(t);\n }\n });\n assertSame(failure, failureRef.get());\n assertTrue(taco.isExecuted());\n }\n\n @Test\n public void cloneHasOwnState() throws IOException {\n Call taco = Calls.response(\"Taco\");\n assertEquals(\"Taco\", taco.execute().body());\n Call anotherTaco = taco.clone();\n assertFalse(anotherTaco.isExecuted());\n assertEquals(\"Taco\", anotherTaco.execute().body());\n assertTrue(anotherTaco.isExecuted());\n }\n\n @Test\n public void deferredReturnExecute() throws IOException {\n Call counts =\n Calls.defer(\n new Callable>() {\n private int count = 0;\n\n @Override\n public Call call() throws Exception {\n return Calls.response(++count);\n }\n });\n Call a = counts.clone();\n Call b = counts.clone();\n\n assertEquals(1, b.execute().body().intValue());\n assertEquals(2, a.execute().body().intValue());\n }\n\n @Test\n public void deferredReturnEnqueue() {\n Call counts =\n Calls.defer(\n new Callable>() {\n private int count = 0;\n\n @Override\n public Call call() throws Exception {\n return Calls.response(++count);\n }\n });\n Call a = counts.clone();\n Call b = counts.clone();\n\n final AtomicReference> responseRef = new AtomicReference<>();\n Callback callback =\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n responseRef.set(response);\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n fail();\n }\n };\n b.enqueue(callback);\n assertEquals(1, responseRef.get().body().intValue());\n\n a.enqueue(callback);\n assertEquals(2, responseRef.get().body().intValue());\n }\n\n @Test\n public void deferredThrowExecute() throws IOException {\n final IOException failure = new IOException(\"Hey\");\n Call failing =\n Calls.defer(\n () -> {\n throw failure;\n });\n try {\n failing.execute();\n fail();\n } catch (IOException e) {\n assertSame(failure, e);\n }\n }\n\n @Test\n public void deferredThrowEnqueue() {\n final IOException failure = new IOException(\"Hey\");\n Call failing =\n Calls.defer(\n () -> {\n throw failure;\n });\n final AtomicReference failureRef = new AtomicReference<>();\n failing.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n fail();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n failureRef.set(t);\n }\n });\n assertSame(failure, failureRef.get());\n }\n\n @Test\n public void deferredThrowUncheckedExceptionEnqueue() {\n final RuntimeException failure = new RuntimeException(\"Hey\");\n final AtomicReference failureRef = new AtomicReference<>();\n Calls.failure(failure)\n .enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n fail();\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n failureRef.set(t);\n }\n });\n assertSame(failure, failureRef.get());\n }\n}\n" }, { "path": "retrofit-mock/src/test/java/retrofit2/mock/MockRetrofitTest.java", "content": "package retrofit2.mock;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static org.junit.Assert.fail;\n\nimport java.util.concurrent.ExecutorService;\nimport java.util.concurrent.Executors;\nimport org.junit.Test;\nimport retrofit2.Retrofit;\n\npublic final class MockRetrofitTest {\n private final Retrofit retrofit = new Retrofit.Builder().baseUrl(\"http://example.com\").build();\n private final NetworkBehavior behavior = NetworkBehavior.create();\n private final ExecutorService executor = Executors.newSingleThreadExecutor();\n\n @Test\n public void retrofitNullThrows() {\n try {\n new MockRetrofit.Builder(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"retrofit == null\");\n }\n }\n\n @Test\n public void retrofitPropagated() {\n MockRetrofit mockRetrofit = new MockRetrofit.Builder(retrofit).build();\n assertThat(mockRetrofit.retrofit()).isSameInstanceAs(retrofit);\n }\n\n @Test\n public void networkBehaviorNullThrows() {\n MockRetrofit.Builder builder = new MockRetrofit.Builder(retrofit);\n try {\n builder.networkBehavior(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"behavior == null\");\n }\n }\n\n @Test\n public void networkBehaviorDefault() {\n MockRetrofit mockRetrofit = new MockRetrofit.Builder(retrofit).build();\n assertThat(mockRetrofit.networkBehavior()).isNotNull();\n }\n\n @Test\n public void networkBehaviorPropagated() {\n MockRetrofit mockRetrofit =\n new MockRetrofit.Builder(retrofit).networkBehavior(behavior).build();\n assertThat(mockRetrofit.networkBehavior()).isSameInstanceAs(behavior);\n }\n\n @Test\n public void backgroundExecutorNullThrows() {\n MockRetrofit.Builder builder = new MockRetrofit.Builder(retrofit);\n try {\n builder.backgroundExecutor(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"executor == null\");\n }\n }\n\n @Test\n public void backgroundExecutorDefault() {\n MockRetrofit mockRetrofit = new MockRetrofit.Builder(retrofit).build();\n assertThat(mockRetrofit.backgroundExecutor()).isNotNull();\n }\n\n @Test\n public void backgroundExecutorPropagated() {\n MockRetrofit mockRetrofit =\n new MockRetrofit.Builder(retrofit).backgroundExecutor(executor).build();\n assertThat(mockRetrofit.backgroundExecutor()).isSameInstanceAs(executor);\n }\n}\n" }, { "path": "retrofit-mock/src/test/java/retrofit2/mock/NetworkBehaviorTest.java", "content": "/*\n * Copyright (C) 2013 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.mock;\n\nimport static com.google.common.truth.Truth.assertThat;\nimport static java.util.concurrent.TimeUnit.MILLISECONDS;\nimport static java.util.concurrent.TimeUnit.SECONDS;\nimport static org.junit.Assert.assertEquals;\nimport static org.junit.Assert.fail;\n\nimport java.io.IOException;\nimport java.util.Random;\nimport java.util.concurrent.Callable;\nimport okhttp3.ResponseBody;\nimport org.junit.Test;\nimport retrofit2.Response;\n\npublic final class NetworkBehaviorTest {\n private final NetworkBehavior behavior = NetworkBehavior.create(new Random(2847));\n\n @Test\n public void defaultThrowable() {\n Throwable t = behavior.failureException();\n assertThat(t).isInstanceOf(IOException.class);\n // Exact instance check as opposed to isInstanceOf's subtype checking.\n assertThat(t.getClass()).isEqualTo(MockRetrofitIOException.class);\n assertThat(t.getStackTrace()).isEmpty();\n }\n\n @Test\n public void delayMustBePositive() {\n try {\n behavior.setDelay(-1, SECONDS);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Amount must be positive value.\");\n }\n }\n\n @Test\n public void varianceRestrictsRange() {\n try {\n behavior.setVariancePercent(-13);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Variance percentage must be between 0 and 100.\");\n }\n try {\n behavior.setVariancePercent(174);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Variance percentage must be between 0 and 100.\");\n }\n }\n\n @Test\n public void failureRestrictsRange() {\n try {\n behavior.setFailurePercent(-13);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Failure percentage must be between 0 and 100.\");\n }\n try {\n behavior.setFailurePercent(174);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Failure percentage must be between 0 and 100.\");\n }\n }\n\n @Test\n public void failureExceptionIsNotNull() {\n try {\n behavior.setFailureException(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"exception == null\");\n }\n }\n\n @Test\n public void errorRestrictsRange() {\n try {\n behavior.setErrorPercent(-13);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Error percentage must be between 0 and 100.\");\n }\n try {\n behavior.setErrorPercent(174);\n fail();\n } catch (IllegalArgumentException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Error percentage must be between 0 and 100.\");\n }\n }\n\n @Test\n public void errorFactoryIsNotNull() {\n try {\n behavior.setErrorFactory(null);\n fail();\n } catch (NullPointerException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"errorFactory == null\");\n }\n }\n\n @Test\n public void errorFactoryCannotReturnNull() {\n behavior.setErrorFactory(() -> null);\n try {\n behavior.createErrorResponse();\n fail();\n } catch (IllegalStateException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Error factory returned null.\");\n }\n }\n\n @Test\n public void errorFactoryCannotThrow() {\n final RuntimeException broken = new RuntimeException(\"Broken\");\n behavior.setErrorFactory(\n () -> {\n throw broken;\n });\n try {\n behavior.createErrorResponse();\n fail();\n } catch (IllegalStateException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Error factory threw an exception.\");\n assertThat(e).hasCauseThat().isSameInstanceAs(broken);\n }\n }\n\n @Test\n public void errorFactoryCannotReturnSuccess() {\n behavior.setErrorFactory(() -> Response.success(\"Taco\"));\n try {\n behavior.createErrorResponse();\n fail();\n } catch (IllegalStateException e) {\n assertThat(e).hasMessageThat().isEqualTo(\"Error factory returned successful response.\");\n }\n }\n\n @Test\n public void errorFactoryCalledEachTime() {\n behavior.setErrorFactory(\n new Callable>() {\n private int code = 500;\n\n @Override\n public Response call() throws Exception {\n return Response.error(code++, ResponseBody.create(null, new byte[0]));\n }\n });\n\n assertEquals(500, behavior.createErrorResponse().code());\n assertEquals(501, behavior.createErrorResponse().code());\n assertEquals(502, behavior.createErrorResponse().code());\n }\n\n @Test\n public void failurePercentageIsAccurate() {\n behavior.setFailurePercent(0);\n for (int i = 0; i < 10000; i++) {\n assertThat(behavior.calculateIsFailure()).isFalse();\n }\n\n behavior.setFailurePercent(3);\n int failures = 0;\n for (int i = 0; i < 100000; i++) {\n if (behavior.calculateIsFailure()) {\n failures += 1;\n }\n }\n assertThat(failures).isEqualTo(2964); // ~3% of 100k\n }\n\n @Test\n public void errorPercentageIsAccurate() {\n behavior.setErrorPercent(0);\n for (int i = 0; i < 10000; i++) {\n assertThat(behavior.calculateIsError()).isFalse();\n }\n\n behavior.setErrorPercent(3);\n int errors = 0;\n for (int i = 0; i < 100000; i++) {\n if (behavior.calculateIsError()) {\n errors += 1;\n }\n }\n assertThat(errors).isEqualTo(2964); // ~3% of 100k\n }\n\n @Test\n public void delayVarianceIsAccurate() {\n behavior.setDelay(2, SECONDS);\n\n behavior.setVariancePercent(0);\n for (int i = 0; i < 100000; i++) {\n assertThat(behavior.calculateDelay(MILLISECONDS)).isEqualTo(2000);\n }\n\n behavior.setVariancePercent(40);\n long lowerBound = Integer.MAX_VALUE;\n long upperBound = Integer.MIN_VALUE;\n for (int i = 0; i < 100000; i++) {\n long delay = behavior.calculateDelay(MILLISECONDS);\n if (delay > upperBound) {\n upperBound = delay;\n }\n if (delay < lowerBound) {\n lowerBound = delay;\n }\n }\n assertThat(upperBound).isEqualTo(2799); // ~40% above 2000\n assertThat(lowerBound).isEqualTo(1200); // ~40% below 2000\n }\n}\n" }, { "path": "retrofit-response-type-keeper/README.md", "content": "# Response Type Keeper\n\nGenerates keep rules for types mentioned in generic parameter positions of Retrofit service methods.\n\n## Problem\n\nGiven a service method like\n```java\n@GET(\"users/{id}\")\nCall getUser(\n @Path(\"id\") String id);\n```\n\nIf you execute this request and do not actually use the returned `User` instance, R8 will remove it\nand replace the return type as `Call`. This fails Retrofit's runtime validation since a wildcard\nis not a valid type to pass to a converter. Note: this removal only occurs if the Retrofit's service\nmethod definition is the only reference to `User`.\n\n## Solution\n\nThis module contains an annotation processor which looks at each Retrofit method and generates\nexplicit `-keep` rules for the types mentioned.\n\nAdd it to Gradle Java projects with\n```groovy\nannotationProcessor 'com.squareup.retrofit2:response-type-keeper:'\n```\nOr Gradle Kotlin projects with\n```groovy\nkapt 'com.squareup.retrofit2:response-type-keeper:'\n```\n\nFor other build systems, the `com.squareup.retrofit2:response-type-keeper` needs added to the Java\ncompiler `-processor` classpath.\n\nFor the example above, the annotation processor's generated file would contain\n```\n-keep com.example.User\n```\n\nThis works for nested generics, such as `Call>`, which would produce:\n```\n-keep com.example.ApiResponse\n-keep com.example.User\n```\n\nIt also works on Kotlin `suspend` functions which turn into a type like\n`Continuation` in the Java bytecode.\n" }, { "path": "retrofit-response-type-keeper/build.gradle", "content": "apply plugin: 'org.jetbrains.kotlin.jvm'\napply plugin: 'com.vanniktech.maven.publish'\n\ndependencies {\n testImplementation libs.junit\n testImplementation libs.compileTesting\n testImplementation libs.truth\n testImplementation projects.retrofit\n}\n" }, { "path": "retrofit-response-type-keeper/gradle.properties", "content": "POM_ARTIFACT_ID=response-type-keeper\nPOM_NAME=Response Type Keeper\nPOM_DESCRIPTION=Annotation processor to generate R8 keep rules for types mentioned in generics.\n" }, { "path": "retrofit-response-type-keeper/src/main/kotlin/retrofit2/keeper/RetrofitResponseTypeKeepProcessor.kt", "content": "/*\n * Copyright (C) 2024 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.keeper\n\nimport javax.annotation.processing.AbstractProcessor\nimport javax.annotation.processing.RoundEnvironment\nimport javax.lang.model.SourceVersion\nimport javax.lang.model.element.ExecutableElement\nimport javax.lang.model.element.TypeElement\nimport javax.lang.model.type.DeclaredType\nimport javax.lang.model.type.TypeMirror\nimport javax.lang.model.type.WildcardType\nimport javax.tools.StandardLocation.CLASS_OUTPUT\n\nclass RetrofitResponseTypeKeepProcessor : AbstractProcessor() {\n override fun getSupportedSourceVersion() = SourceVersion.latestSupported()\n override fun getSupportedAnnotationTypes() = setOf(\n \"retrofit2.http.DELETE\",\n \"retrofit2.http.GET\",\n \"retrofit2.http.HEAD\",\n \"retrofit2.http.HTTP\",\n \"retrofit2.http.OPTIONS\",\n \"retrofit2.http.PATCH\",\n \"retrofit2.http.POST\",\n \"retrofit2.http.PUT\",\n )\n\n override fun process(\n annotations: Set,\n roundEnv: RoundEnvironment,\n ): Boolean {\n val elements = processingEnv.elementUtils\n val types = processingEnv.typeUtils\n\n val methods = supportedAnnotationTypes\n .mapNotNull(elements::getTypeElement)\n .flatMap(roundEnv::getElementsAnnotatedWith)\n\n val elementToReferencedTypes = mutableMapOf>()\n for (method in methods) {\n val executableElement = method as ExecutableElement\n\n val serviceType = method.enclosingElement as TypeElement\n val referenced = elementToReferencedTypes.getOrPut(serviceType, ::LinkedHashSet)\n\n val returnType = executableElement.returnType as DeclaredType\n returnType.recursiveParameterizedTypesTo(referenced)\n\n // Retrofit has special support for 'suspend fun' in Kotlin which manifests as a\n // final Continuation parameter whose generic type is the declared return type.\n executableElement.parameters\n .lastOrNull()\n ?.asType()\n ?.takeIf { types.erasure(it).toString() == \"kotlin.coroutines.Continuation\" }\n ?.let { (it as DeclaredType).typeArguments.single() }\n ?.recursiveParameterizedTypesTo(referenced)\n }\n\n for ((element, referencedTypes) in elementToReferencedTypes) {\n val typeName = element.qualifiedName.toString()\n val outputFile = \"META-INF/proguard/retrofit-response-type-keeper-$typeName.pro\"\n val rules = processingEnv.filer.createResource(CLASS_OUTPUT, \"\", outputFile, element)\n rules.openWriter().buffered().use { w ->\n w.write(\"# $typeName\\n\")\n for (referencedType in referencedTypes.sorted()) {\n w.write(\"-keep,allowoptimization,allowshrinking,allowobfuscation class $referencedType\\n\")\n }\n }\n }\n return false\n }\n\n private fun TypeMirror.recursiveParameterizedTypesTo(types: MutableSet) {\n when (this) {\n is WildcardType -> {\n extendsBound?.recursiveParameterizedTypesTo(types)\n superBound?.recursiveParameterizedTypesTo(types)\n }\n is DeclaredType -> {\n for (typeArgument in typeArguments) {\n typeArgument.recursiveParameterizedTypesTo(types)\n }\n types += (asElement() as TypeElement).qualifiedName.toString()\n }\n }\n }\n}\n" }, { "path": "retrofit-response-type-keeper/src/main/resources/META-INF/gradle/incremental.annotation.processors", "content": "retrofit2.keeper.RetrofitResponseTypeKeepProcessor,ISOLATING\n" }, { "path": "retrofit-response-type-keeper/src/main/resources/META-INF/services/javax.annotation.processing.Processor", "content": "retrofit2.keeper.RetrofitResponseTypeKeepProcessor\n" }, { "path": "retrofit-response-type-keeper/src/test/kotlin/retrofit2/keeper/RetrofitResponseTypeKeepProcessorTest.kt", "content": "/*\n * Copyright (C) 2024 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage retrofit2.keeper\n\nimport com.google.common.truth.Truth.assertAbout\nimport com.google.testing.compile.JavaFileObjects\nimport com.google.testing.compile.JavaSourceSubjectFactory.javaSource\nimport java.nio.charset.StandardCharsets.UTF_8\nimport javax.tools.StandardLocation.CLASS_OUTPUT\nimport org.junit.Test\n\nclass RetrofitResponseTypeKeepProcessorTest {\n @Test\n fun allHttpMethods() {\n val service = JavaFileObjects.forSourceString(\n \"test.Service\",\n \"\"\"\n package test;\n import retrofit2.*;\n import retrofit2.http.*;\n\n class DeleteUser {}\n class GetUser {}\n class HeadUser {}\n class HttpUser {}\n class OptionsUser {}\n class PatchUser {}\n class PostUser {}\n class PutUser {}\n\n interface Service {\n @DELETE(\"/\") Call delete();\n @GET(\"/\") Call get();\n @HEAD(\"/\") Call head();\n @HTTP(method = \"CUSTOM\", path = \"/\") Call http();\n @OPTIONS(\"/\") Call options();\n @PATCH(\"/\") Call patch();\n @POST(\"/\") Call post();\n @PUT(\"/\") Call put();\n }\n \"\"\".trimIndent(),\n )\n\n assertAbout(javaSource())\n .that(service)\n .processedWith(RetrofitResponseTypeKeepProcessor())\n .compilesWithoutError()\n .and()\n .generatesFileNamed(\n CLASS_OUTPUT,\n \"\",\n \"META-INF/proguard/retrofit-response-type-keeper-test.Service.pro\",\n ).withStringContents(\n UTF_8,\n \"\"\"\n |# test.Service\n |-keep,allowoptimization,allowshrinking,allowobfuscation class retrofit2.Call\n |-keep,allowoptimization,allowshrinking,allowobfuscation class test.DeleteUser\n |-keep,allowoptimization,allowshrinking,allowobfuscation class test.GetUser\n |-keep,allowoptimization,allowshrinking,allowobfuscation class test.HeadUser\n |-keep,allowoptimization,allowshrinking,allowobfuscation class test.HttpUser\n |-keep,allowoptimization,allowshrinking,allowobfuscation class test.OptionsUser\n |-keep,allowoptimization,allowshrinking,allowobfuscation class test.PatchUser\n |-keep,allowoptimization,allowshrinking,allowobfuscation class test.PostUser\n |-keep,allowoptimization,allowshrinking,allowobfuscation class test.PutUser\n |\n \"\"\".trimMargin(),\n )\n }\n\n @Test\n fun nesting() {\n val service = JavaFileObjects.forSourceString(\n \"test.Service\",\n \"\"\"\n package test;\n import retrofit2.*;\n import retrofit2.http.*;\n\n class One {}\n class Two {}\n class Three {}\n\n interface Service {\n @GET(\"/\") Call>> get();\n }\n \"\"\".trimIndent(),\n )\n\n assertAbout(javaSource())\n .that(service)\n .processedWith(RetrofitResponseTypeKeepProcessor())\n .compilesWithoutError()\n .and()\n .generatesFileNamed(\n CLASS_OUTPUT,\n \"\",\n \"META-INF/proguard/retrofit-response-type-keeper-test.Service.pro\",\n ).withStringContents(\n UTF_8,\n \"\"\"\n |# test.Service\n |-keep,allowoptimization,allowshrinking,allowobfuscation class retrofit2.Call\n |-keep,allowoptimization,allowshrinking,allowobfuscation class test.One\n |-keep,allowoptimization,allowshrinking,allowobfuscation class test.Three\n |-keep,allowoptimization,allowshrinking,allowobfuscation class test.Two\n |\n \"\"\".trimMargin(),\n )\n }\n\n @Test\n fun kotlinSuspend() {\n val service = JavaFileObjects.forSourceString(\n \"test.Service\",\n \"\"\"\n package test;\n import kotlin.coroutines.Continuation;\n import retrofit2.*;\n import retrofit2.http.*;\n\n class Body {}\n\n interface Service {\n @GET(\"/\") Object get(Continuation c);\n }\n \"\"\".trimIndent(),\n )\n\n assertAbout(javaSource())\n .that(service)\n .processedWith(RetrofitResponseTypeKeepProcessor())\n .compilesWithoutError()\n .and()\n .generatesFileNamed(\n CLASS_OUTPUT,\n \"\",\n \"META-INF/proguard/retrofit-response-type-keeper-test.Service.pro\",\n ).withStringContents(\n UTF_8,\n \"\"\"\n |# test.Service\n |-keep,allowoptimization,allowshrinking,allowobfuscation class java.lang.Object\n |-keep,allowoptimization,allowshrinking,allowobfuscation class test.Body\n |\n \"\"\".trimMargin(),\n )\n }\n}\n" }, { "path": "samples/build.gradle", "content": "apply plugin: 'org.jetbrains.kotlin.jvm'\n\ndependencies {\n implementation projects.retrofit\n implementation projects.retrofitMock\n implementation projects.retrofitConverters.moshi\n implementation projects.retrofitConverters.gson\n implementation projects.retrofitConverters.simplexml\n implementation projects.retrofitAdapters.rxjava\n implementation libs.okhttp.loggingInterceptor\n implementation libs.okhttp.mockwebserver\n implementation libs.kotlin.stdLib\n implementation libs.kotlinx.coroutines\n implementation libs.guava\n implementation libs.jsoup\n compileOnly libs.findBugsAnnotations\n}\n" }, { "path": "samples/src/main/java/com/example/retrofit/AnnotatedConverters.java", "content": "/*\n * Copyright (C) 2017 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage com.example.retrofit;\n\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport com.google.gson.GsonBuilder;\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.annotation.Retention;\nimport java.lang.reflect.Type;\nimport java.util.LinkedHashMap;\nimport java.util.Map;\nimport javax.annotation.Nullable;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.simpleframework.xml.Attribute;\nimport org.simpleframework.xml.Default;\nimport org.simpleframework.xml.DefaultType;\nimport retrofit2.Call;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\nimport retrofit2.converter.gson.GsonConverterFactory;\nimport retrofit2.converter.moshi.MoshiConverterFactory;\nimport retrofit2.converter.simplexml.SimpleXmlConverterFactory;\nimport retrofit2.http.GET;\n\nfinal class AnnotatedConverters {\n public static final class AnnotatedConverterFactory extends Converter.Factory {\n private final Map, Converter.Factory> factories;\n\n public static final class Builder {\n private final Map, Converter.Factory> factories =\n new LinkedHashMap<>();\n\n public Builder add(Class cls, Converter.Factory factory) {\n if (cls == null) {\n throw new NullPointerException(\"cls == null\");\n }\n if (factory == null) {\n throw new NullPointerException(\"factory == null\");\n }\n factories.put(cls, factory);\n return this;\n }\n\n public AnnotatedConverterFactory build() {\n return new AnnotatedConverterFactory(factories);\n }\n }\n\n AnnotatedConverterFactory(Map, Converter.Factory> factories) {\n this.factories = new LinkedHashMap<>(factories);\n }\n\n @Override\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n for (Annotation annotation : annotations) {\n Converter.Factory factory = factories.get(annotation.annotationType());\n if (factory != null) {\n return factory.responseBodyConverter(type, annotations, retrofit);\n }\n }\n return null;\n }\n\n @Override\n public @Nullable Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n for (Annotation annotation : parameterAnnotations) {\n Converter.Factory factory = factories.get(annotation.annotationType());\n if (factory != null) {\n return factory.requestBodyConverter(\n type, parameterAnnotations, methodAnnotations, retrofit);\n }\n }\n return null;\n }\n }\n\n @Retention(RUNTIME)\n public @interface Moshi {}\n\n @Retention(RUNTIME)\n public @interface Gson {}\n\n @Retention(RUNTIME)\n public @interface SimpleXml {}\n\n @Default(value = DefaultType.FIELD)\n static final class Library {\n @Attribute String name;\n }\n\n interface Service {\n @GET(\"/\")\n @Moshi\n Call exampleMoshi();\n\n @GET(\"/\")\n @Gson\n Call exampleGson();\n\n @GET(\"/\")\n @SimpleXml\n Call exampleSimpleXml();\n\n @GET(\"/\")\n Call exampleDefault();\n }\n\n public static void main(String... args) throws IOException {\n MockWebServer server = new MockWebServer();\n server.start();\n server.enqueue(new MockResponse().setBody(\"{\\\"name\\\": \\\"Moshi\\\"}\"));\n server.enqueue(new MockResponse().setBody(\"{\\\"name\\\": \\\"Gson\\\"}\"));\n server.enqueue(new MockResponse().setBody(\"\"));\n server.enqueue(new MockResponse().setBody(\"{\\\"name\\\": \\\"Gson\\\"}\"));\n\n com.squareup.moshi.Moshi moshi = new com.squareup.moshi.Moshi.Builder().build();\n com.google.gson.Gson gson = new GsonBuilder().create();\n MoshiConverterFactory moshiConverterFactory = MoshiConverterFactory.create(moshi);\n GsonConverterFactory gsonConverterFactory = GsonConverterFactory.create(gson);\n SimpleXmlConverterFactory simpleXmlConverterFactory = SimpleXmlConverterFactory.create();\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(\n new AnnotatedConverterFactory.Builder()\n .add(Moshi.class, moshiConverterFactory)\n .add(Gson.class, gsonConverterFactory)\n .add(SimpleXml.class, simpleXmlConverterFactory)\n .build())\n .addConverterFactory(gsonConverterFactory)\n .build();\n Service service = retrofit.create(Service.class);\n\n Library library1 = service.exampleMoshi().execute().body();\n System.out.println(\"Library 1: \" + library1.name);\n\n Library library2 = service.exampleGson().execute().body();\n System.out.println(\"Library 2: \" + library2.name);\n\n Library library3 = service.exampleSimpleXml().execute().body();\n System.out.println(\"Library 3: \" + library3.name);\n\n Library library4 = service.exampleDefault().execute().body();\n System.out.println(\"Library 4: \" + library4.name);\n\n server.shutdown();\n }\n}\n" }, { "path": "samples/src/main/java/com/example/retrofit/ChunkingConverter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage com.example.retrofit;\n\nimport static java.lang.annotation.ElementType.PARAMETER;\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.Target;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport okhttp3.MediaType;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport okhttp3.mockwebserver.RecordedRequest;\nimport okio.BufferedSink;\nimport retrofit2.Call;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\nimport retrofit2.converter.gson.GsonConverterFactory;\nimport retrofit2.http.Body;\nimport retrofit2.http.POST;\n\npublic final class ChunkingConverter {\n @Target(PARAMETER)\n @Retention(RUNTIME)\n @interface Chunked {}\n\n /**\n * A converter which removes known content lengths to force chunking when {@code @Chunked} is\n * present on {@code @Body} params.\n */\n static class ChunkingConverterFactory extends Converter.Factory {\n @Override\n public @Nullable Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n boolean isBody = false;\n boolean isChunked = false;\n for (Annotation annotation : parameterAnnotations) {\n isBody |= annotation instanceof Body;\n isChunked |= annotation instanceof Chunked;\n }\n if (!isBody || !isChunked) {\n return null;\n }\n\n // Look up the real converter to delegate to.\n final Converter delegate =\n retrofit.nextRequestBodyConverter(this, type, parameterAnnotations, methodAnnotations);\n // Wrap it in a Converter which removes the content length from the delegate's body.\n return value -> {\n final RequestBody realBody = delegate.convert(value);\n return new RequestBody() {\n @Override\n public MediaType contentType() {\n return realBody.contentType();\n }\n\n @Override\n public void writeTo(BufferedSink sink) throws IOException {\n realBody.writeTo(sink);\n }\n };\n };\n }\n }\n\n static class Repo {\n final String owner;\n final String name;\n\n Repo(String owner, String name) {\n this.owner = owner;\n this.name = name;\n }\n }\n\n interface Service {\n @POST(\"/\")\n Call sendNormal(@Body Repo repo);\n\n @POST(\"/\")\n Call sendChunked(@Chunked @Body Repo repo);\n }\n\n public static void main(String... args) throws IOException, InterruptedException {\n MockWebServer server = new MockWebServer();\n server.enqueue(new MockResponse());\n server.enqueue(new MockResponse());\n server.start();\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new ChunkingConverterFactory())\n .addConverterFactory(GsonConverterFactory.create())\n .build();\n Service service = retrofit.create(Service.class);\n\n Repo retrofitRepo = new Repo(\"square\", \"retrofit\");\n\n service.sendNormal(retrofitRepo).execute();\n RecordedRequest normalRequest = server.takeRequest();\n System.out.println(\n \"Normal @Body Transfer-Encoding: \" + normalRequest.getHeader(\"Transfer-Encoding\"));\n\n service.sendChunked(retrofitRepo).execute();\n RecordedRequest chunkedRequest = server.takeRequest();\n System.out.println(\n \"@Chunked @Body Transfer-Encoding: \" + chunkedRequest.getHeader(\"Transfer-Encoding\"));\n\n server.shutdown();\n }\n}\n" }, { "path": "samples/src/main/java/com/example/retrofit/ConditionalLoggingInterceptor.kt", "content": "/*\n * Copyright (C) 2024 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage com.example.retrofit\n\nimport okhttp3.Interceptor\nimport okhttp3.OkHttpClient\nimport okhttp3.Response\nimport okhttp3.ResponseBody\nimport okhttp3.logging.HttpLoggingInterceptor\nimport okhttp3.mockwebserver.MockResponse\nimport okhttp3.mockwebserver.MockWebServer\nimport retrofit2.Invocation\nimport retrofit2.Retrofit\nimport retrofit2.create\nimport retrofit2.http.GET\n\nsuspend fun main() {\n val server = MockWebServer()\n val client = OkHttpClient.Builder()\n .addInterceptor(\n ConditionalLoggingInterceptor(\n HttpLoggingInterceptor(::println).setLevel(\n HttpLoggingInterceptor.Level.BODY,\n ),\n ),\n )\n .build()\n val retrofit = Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .client(client)\n .build()\n val exampleApi = retrofit.create()\n\n server.enqueue(MockResponse())\n exampleApi.one()\n\n server.enqueue(MockResponse())\n exampleApi.two()\n}\n\nprivate interface ExampleApi {\n @GET(\"one\")\n suspend fun one(): ResponseBody\n\n @Log\n @GET(\"two\")\n suspend fun two(): ResponseBody\n}\n\n/**\n * Retrofit service functions which are annotated with this class will have their HTTP calls\n * logged. You must add [ConditionalLoggingInterceptor] to your [OkHttpClient] for this to work.\n */\nannotation class Log\n\nclass ConditionalLoggingInterceptor(\n private val loggingInterceptor: HttpLoggingInterceptor,\n) : Interceptor {\n override fun intercept(chain: Interceptor.Chain): Response {\n val request = chain.request()\n request.tag(Invocation::class.java)?.let { invocation ->\n if (invocation.method().isAnnotationPresent(Log::class.java)) {\n return loggingInterceptor.intercept(chain)\n }\n }\n return chain.proceed(request)\n }\n}\n" }, { "path": "samples/src/main/java/com/example/retrofit/Crawler.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage com.example.retrofit;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport java.util.ArrayList;\nimport java.util.Collections;\nimport java.util.LinkedHashSet;\nimport java.util.List;\nimport java.util.Set;\nimport java.util.concurrent.ConcurrentHashMap;\nimport java.util.concurrent.Executors;\nimport java.util.concurrent.TimeUnit;\nimport java.util.concurrent.atomic.AtomicInteger;\nimport javax.annotation.Nullable;\nimport okhttp3.ConnectionPool;\nimport okhttp3.Dispatcher;\nimport okhttp3.HttpUrl;\nimport okhttp3.OkHttpClient;\nimport okhttp3.ResponseBody;\nimport org.jsoup.Jsoup;\nimport org.jsoup.nodes.Document;\nimport org.jsoup.nodes.Element;\nimport retrofit2.Call;\nimport retrofit2.Callback;\nimport retrofit2.Converter;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport retrofit2.http.Url;\n\n/** A simple web crawler that uses a Retrofit service to turn URLs into webpages. */\npublic final class Crawler {\n private final Set fetchedUrls =\n Collections.synchronizedSet(new LinkedHashSet());\n private final ConcurrentHashMap hostnames = new ConcurrentHashMap<>();\n private final PageService pageService;\n\n public Crawler(PageService pageService) {\n this.pageService = pageService;\n }\n\n public void crawlPage(HttpUrl url) {\n // Skip hosts that we've visited many times.\n AtomicInteger hostnameCount = new AtomicInteger();\n AtomicInteger previous = hostnames.putIfAbsent(url.host(), hostnameCount);\n if (previous != null) hostnameCount = previous;\n if (hostnameCount.incrementAndGet() > 100) return;\n\n // Asynchronously visit URL.\n pageService\n .get(url)\n .enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n if (!response.isSuccessful()) {\n System.out.println(call.request().url() + \": failed: \" + response.code());\n return;\n }\n\n // Print this page's URL and title.\n Page page = response.body();\n HttpUrl base = response.raw().request().url();\n System.out.println(base + \": \" + page.title);\n\n // Enqueue its links for visiting.\n for (String link : page.links) {\n HttpUrl linkUrl = base.resolve(link);\n if (linkUrl != null && fetchedUrls.add(linkUrl)) {\n crawlPage(linkUrl);\n }\n }\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n System.out.println(call.request().url() + \": failed: \" + t);\n }\n });\n }\n\n public static void main(String... args) throws Exception {\n Dispatcher dispatcher = new Dispatcher(Executors.newFixedThreadPool(20));\n dispatcher.setMaxRequests(20);\n dispatcher.setMaxRequestsPerHost(1);\n\n OkHttpClient okHttpClient =\n new OkHttpClient.Builder()\n .dispatcher(dispatcher)\n .connectionPool(new ConnectionPool(100, 30, TimeUnit.SECONDS))\n .build();\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(HttpUrl.get(\"https://example.com/\"))\n .addConverterFactory(PageAdapter.FACTORY)\n .client(okHttpClient)\n .build();\n\n PageService pageService = retrofit.create(PageService.class);\n\n Crawler crawler = new Crawler(pageService);\n crawler.crawlPage(HttpUrl.get(args[0]));\n }\n\n interface PageService {\n @GET\n Call get(@Url HttpUrl url);\n }\n\n static class Page {\n final String title;\n final List links;\n\n Page(String title, List links) {\n this.title = title;\n this.links = links;\n }\n }\n\n static final class PageAdapter implements Converter {\n static final Converter.Factory FACTORY =\n new Converter.Factory() {\n @Override\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n if (type == Page.class) return new PageAdapter();\n return null;\n }\n };\n\n @Override\n public Page convert(ResponseBody responseBody) throws IOException {\n Document document = Jsoup.parse(responseBody.string());\n List links = new ArrayList<>();\n for (Element element : document.select(\"a[href]\")) {\n links.add(element.attr(\"href\"));\n }\n return new Page(document.title(), Collections.unmodifiableList(links));\n }\n }\n}\n" }, { "path": "samples/src/main/java/com/example/retrofit/DeserializeErrorBody.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage com.example.retrofit;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport okhttp3.ResponseBody;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport retrofit2.Call;\nimport retrofit2.Converter;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.converter.gson.GsonConverterFactory;\nimport retrofit2.http.GET;\n\npublic final class DeserializeErrorBody {\n interface Service {\n @GET(\"/user\")\n Call getUser();\n }\n\n static class User {\n // normal fields...\n }\n\n static class ErrorBody {\n String message;\n }\n\n public static void main(String... args) throws IOException {\n // Create a local web server which response with a 404 and JSON body.\n MockWebServer server = new MockWebServer();\n server.start();\n server.enqueue(\n new MockResponse()\n .setResponseCode(404)\n .setBody(\"{\\\"message\\\":\\\"Unable to locate resource\\\"}\"));\n\n // Create our Service instance with a Retrofit pointing at the local web server and Gson.\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(GsonConverterFactory.create())\n .build();\n Service service = retrofit.create(Service.class);\n\n Response response = service.getUser().execute();\n\n // Normally you would check response.isSuccess() here before doing the following, but we know\n // this call will always fail. You could also use response.code() to determine whether to\n // convert the error body and/or which type to use for conversion.\n\n // Look up a converter for the Error type on the Retrofit instance.\n Converter errorConverter =\n retrofit.responseBodyConverter(ErrorBody.class, new Annotation[0]);\n // Convert the error body into our Error type.\n ErrorBody errorBody = errorConverter.convert(response.errorBody());\n System.out.println(\"ERROR: \" + errorBody.message);\n\n server.shutdown();\n }\n}\n" }, { "path": "samples/src/main/java/com/example/retrofit/DynamicBaseUrl.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage com.example.retrofit;\n\nimport java.io.IOException;\nimport okhttp3.HttpUrl;\nimport okhttp3.Interceptor;\nimport okhttp3.OkHttpClient;\nimport okhttp3.Request;\nimport okhttp3.ResponseBody;\nimport retrofit2.Call;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\n\n/**\n * This example uses an OkHttp interceptor to change the target hostname dynamically at runtime.\n * Typically this would be used to implement client-side load balancing or to use the webserver\n * that's nearest geographically.\n */\npublic final class DynamicBaseUrl {\n public interface Pop {\n @GET(\"robots.txt\")\n Call robots();\n }\n\n static final class HostSelectionInterceptor implements Interceptor {\n private volatile String host;\n\n public void setHost(String host) {\n this.host = host;\n }\n\n @Override\n public okhttp3.Response intercept(Chain chain) throws IOException {\n Request request = chain.request();\n String host = this.host;\n if (host != null) {\n HttpUrl newUrl = request.url().newBuilder().host(host).build();\n request = request.newBuilder().url(newUrl).build();\n }\n return chain.proceed(request);\n }\n }\n\n public static void main(String... args) throws IOException {\n HostSelectionInterceptor hostSelectionInterceptor = new HostSelectionInterceptor();\n\n OkHttpClient okHttpClient =\n new OkHttpClient.Builder().addInterceptor(hostSelectionInterceptor).build();\n\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(\"http://www.github.com/\").callFactory(okHttpClient).build();\n\n Pop pop = retrofit.create(Pop.class);\n\n Response response1 = pop.robots().execute();\n System.out.println(\"Response from: \" + response1.raw().request().url());\n System.out.println(response1.body().string());\n\n hostSelectionInterceptor.setHost(\"www.pepsi.com\");\n\n Response response2 = pop.robots().execute();\n System.out.println(\"Response from: \" + response2.raw().request().url());\n System.out.println(response2.body().string());\n }\n}\n" }, { "path": "samples/src/main/java/com/example/retrofit/ErrorHandlingAdapter.java", "content": "/*\n * Copyright (C) 2015 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage com.example.retrofit;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport java.util.concurrent.Executor;\nimport javax.annotation.Nullable;\nimport retrofit2.Call;\nimport retrofit2.CallAdapter;\nimport retrofit2.Callback;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.converter.gson.GsonConverterFactory;\nimport retrofit2.http.GET;\n\n/**\n * A sample showing a custom {@link CallAdapter} which adapts the built-in {@link Call} to a custom\n * version whose callback has more granular methods.\n */\npublic final class ErrorHandlingAdapter {\n /** A callback which offers granular callbacks for various conditions. */\n interface MyCallback {\n /** Called for [200, 300) responses. */\n void success(Response response);\n\n /** Called for 401 responses. */\n void unauthenticated(Response response);\n\n /** Called for [400, 500) responses, except 401. */\n void clientError(Response response);\n\n /** Called for [500, 600) response. */\n void serverError(Response response);\n\n /** Called for network errors while making the call. */\n void networkError(IOException e);\n\n /** Called for unexpected errors while making the call. */\n void unexpectedError(Throwable t);\n }\n\n interface MyCall {\n void cancel();\n\n void enqueue(MyCallback callback);\n\n MyCall clone();\n\n // Left as an exercise for the reader...\n // TODO MyResponse execute() throws MyHttpException;\n }\n\n public static class ErrorHandlingCallAdapterFactory extends CallAdapter.Factory {\n @Override\n public @Nullable CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n if (getRawType(returnType) != MyCall.class) {\n return null;\n }\n if (!(returnType instanceof ParameterizedType)) {\n throw new IllegalStateException(\n \"MyCall must have generic type (e.g., MyCall)\");\n }\n Type responseType = getParameterUpperBound(0, (ParameterizedType) returnType);\n Executor callbackExecutor = retrofit.callbackExecutor();\n return new ErrorHandlingCallAdapter<>(responseType, callbackExecutor);\n }\n\n private static final class ErrorHandlingCallAdapter implements CallAdapter> {\n private final Type responseType;\n private final Executor callbackExecutor;\n\n ErrorHandlingCallAdapter(Type responseType, Executor callbackExecutor) {\n this.responseType = responseType;\n this.callbackExecutor = callbackExecutor;\n }\n\n @Override\n public Type responseType() {\n return responseType;\n }\n\n @Override\n public MyCall adapt(Call call) {\n return new MyCallAdapter<>(call, callbackExecutor);\n }\n }\n }\n\n /** Adapts a {@link Call} to {@link MyCall}. */\n static class MyCallAdapter implements MyCall {\n private final Call call;\n private final Executor callbackExecutor;\n\n MyCallAdapter(Call call, Executor callbackExecutor) {\n this.call = call;\n this.callbackExecutor = callbackExecutor;\n }\n\n @Override\n public void cancel() {\n call.cancel();\n }\n\n @Override\n public void enqueue(final MyCallback callback) {\n call.enqueue(\n new Callback() {\n @Override\n public void onResponse(Call call, Response response) {\n // TODO if 'callbackExecutor' is not null, the 'callback' methods should be executed\n // on that executor by submitting a Runnable. This is left as an exercise for the\n // reader.\n\n int code = response.code();\n if (code >= 200 && code < 300) {\n callback.success(response);\n } else if (code == 401) {\n callback.unauthenticated(response);\n } else if (code >= 400 && code < 500) {\n callback.clientError(response);\n } else if (code >= 500 && code < 600) {\n callback.serverError(response);\n } else {\n callback.unexpectedError(new RuntimeException(\"Unexpected response \" + response));\n }\n }\n\n @Override\n public void onFailure(Call call, Throwable t) {\n // TODO if 'callbackExecutor' is not null, the 'callback' methods should be executed\n // on that executor by submitting a Runnable. This is left as an exercise for the\n // reader.\n\n if (t instanceof IOException) {\n callback.networkError((IOException) t);\n } else {\n callback.unexpectedError(t);\n }\n }\n });\n }\n\n @Override\n public MyCall clone() {\n return new MyCallAdapter<>(call.clone(), callbackExecutor);\n }\n }\n\n interface HttpBinService {\n @GET(\"/ip\")\n MyCall getIp();\n }\n\n static class Ip {\n String origin;\n }\n\n public static void main(String... args) {\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://httpbin.org\")\n .addCallAdapterFactory(new ErrorHandlingCallAdapterFactory())\n .addConverterFactory(GsonConverterFactory.create())\n .build();\n\n HttpBinService service = retrofit.create(HttpBinService.class);\n MyCall ip = service.getIp();\n ip.enqueue(\n new MyCallback() {\n @Override\n public void success(Response response) {\n System.out.println(\"SUCCESS! \" + response.body().origin);\n }\n\n @Override\n public void unauthenticated(Response response) {\n System.out.println(\"UNAUTHENTICATED\");\n }\n\n @Override\n public void clientError(Response response) {\n System.out.println(\"CLIENT ERROR \" + response.code() + \" \" + response.message());\n }\n\n @Override\n public void serverError(Response response) {\n System.out.println(\"SERVER ERROR \" + response.code() + \" \" + response.message());\n }\n\n @Override\n public void networkError(IOException e) {\n System.err.println(\"NETWORK ERROR \" + e.getMessage());\n }\n\n @Override\n public void unexpectedError(Throwable t) {\n System.err.println(\"FATAL ERROR \" + t.getMessage());\n }\n });\n }\n}\n" }, { "path": "samples/src/main/java/com/example/retrofit/InvocationMetrics.java", "content": "/*\n * Copyright (C) 2018 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage com.example.retrofit;\n\nimport java.io.IOException;\nimport okhttp3.Interceptor;\nimport okhttp3.OkHttpClient;\nimport okhttp3.Request;\nimport okhttp3.Response;\nimport okhttp3.ResponseBody;\nimport retrofit2.Call;\nimport retrofit2.Invocation;\nimport retrofit2.Retrofit;\nimport retrofit2.http.GET;\nimport retrofit2.http.Url;\n\n/** This example prints HTTP call metrics with the initiating method names and arguments. */\npublic final class InvocationMetrics {\n public interface Browse {\n @GET(\"/robots.txt\")\n Call robots();\n\n @GET(\"/favicon.ico\")\n Call favicon();\n\n @GET(\"/\")\n Call home();\n\n @GET\n Call page(@Url String path);\n }\n\n static final class InvocationLogger implements Interceptor {\n @Override\n public Response intercept(Chain chain) throws IOException {\n Request request = chain.request();\n long startNanos = System.nanoTime();\n Response response = chain.proceed(request);\n long elapsedNanos = System.nanoTime() - startNanos;\n\n Invocation invocation = request.tag(Invocation.class);\n if (invocation != null) {\n System.out.printf(\n \"%s.%s %s HTTP %s (%.0f ms)%n\",\n invocation.service().getSimpleName(),\n invocation.method().getName(),\n invocation.arguments(),\n response.code(),\n elapsedNanos / 1_000_000.0);\n }\n\n return response;\n }\n }\n\n public static void main(String... args) throws IOException {\n InvocationLogger invocationLogger = new InvocationLogger();\n\n OkHttpClient okHttpClient = new OkHttpClient.Builder().addInterceptor(invocationLogger).build();\n\n Retrofit retrofit =\n new Retrofit.Builder().baseUrl(\"https://square.com/\").callFactory(okHttpClient).build();\n\n Browse browse = retrofit.create(Browse.class);\n\n browse.robots().execute();\n browse.favicon().execute();\n browse.home().execute();\n browse.page(\"sitemap.xml\").execute();\n browse.page(\"notfound\").execute();\n }\n}\n" }, { "path": "samples/src/main/java/com/example/retrofit/JsonAndXmlConverters.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage com.example.retrofit;\n\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.annotation.Retention;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport org.simpleframework.xml.Attribute;\nimport org.simpleframework.xml.Default;\nimport org.simpleframework.xml.DefaultType;\nimport retrofit2.Call;\nimport retrofit2.Converter;\nimport retrofit2.Retrofit;\nimport retrofit2.converter.gson.GsonConverterFactory;\nimport retrofit2.converter.simplexml.SimpleXmlConverterFactory;\nimport retrofit2.http.GET;\n\n/**\n * Both the Gson converter and the Simple Framework converter accept all types. Because of this, you\n * cannot use both in a single service by default. In order to work around this, we can create\n * an @Json and @Xml annotation to declare which serialization format each endpoint should use and\n * then write our own Converter.Factory which delegates to either the Gson or Simple Framework\n * converter.\n */\npublic final class JsonAndXmlConverters {\n @Retention(RUNTIME)\n @interface Json {}\n\n @Retention(RUNTIME)\n @interface Xml {}\n\n static class QualifiedTypeConverterFactory extends Converter.Factory {\n private final Converter.Factory jsonFactory;\n private final Converter.Factory xmlFactory;\n\n QualifiedTypeConverterFactory(Converter.Factory jsonFactory, Converter.Factory xmlFactory) {\n this.jsonFactory = jsonFactory;\n this.xmlFactory = xmlFactory;\n }\n\n @Override\n public @Nullable Converter responseBodyConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n for (Annotation annotation : annotations) {\n if (annotation instanceof Json) {\n return jsonFactory.responseBodyConverter(type, annotations, retrofit);\n }\n if (annotation instanceof Xml) {\n return xmlFactory.responseBodyConverter(type, annotations, retrofit);\n }\n }\n return null;\n }\n\n @Override\n public @Nullable Converter requestBodyConverter(\n Type type,\n Annotation[] parameterAnnotations,\n Annotation[] methodAnnotations,\n Retrofit retrofit) {\n for (Annotation annotation : parameterAnnotations) {\n if (annotation instanceof Json) {\n return jsonFactory.requestBodyConverter(\n type, parameterAnnotations, methodAnnotations, retrofit);\n }\n if (annotation instanceof Xml) {\n return xmlFactory.requestBodyConverter(\n type, parameterAnnotations, methodAnnotations, retrofit);\n }\n }\n return null;\n }\n }\n\n @Default(value = DefaultType.FIELD)\n static class User {\n @Attribute public String name;\n }\n\n interface Service {\n @GET(\"/\")\n @Json\n Call exampleJson();\n\n @GET(\"/\")\n @Xml\n Call exampleXml();\n }\n\n public static void main(String... args) throws IOException {\n MockWebServer server = new MockWebServer();\n server.start();\n server.enqueue(new MockResponse().setBody(\"{\\\"name\\\": \\\"Jason\\\"}\"));\n server.enqueue(new MockResponse().setBody(\"\"));\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(\n new QualifiedTypeConverterFactory(\n GsonConverterFactory.create(), SimpleXmlConverterFactory.create()))\n .build();\n Service service = retrofit.create(Service.class);\n\n User user1 = service.exampleJson().execute().body();\n System.out.println(\"User 1: \" + user1.name);\n\n User user2 = service.exampleXml().execute().body();\n System.out.println(\"User 2: \" + user2.name);\n\n server.shutdown();\n }\n}\n" }, { "path": "samples/src/main/java/com/example/retrofit/JsonQueryParameters.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage com.example.retrofit;\n\nimport static java.lang.annotation.RetentionPolicy.RUNTIME;\n\nimport java.io.IOException;\nimport java.lang.annotation.Annotation;\nimport java.lang.annotation.Retention;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport okhttp3.RequestBody;\nimport okhttp3.ResponseBody;\nimport okhttp3.mockwebserver.MockResponse;\nimport okhttp3.mockwebserver.MockWebServer;\nimport okhttp3.mockwebserver.RecordedRequest;\nimport okio.Buffer;\nimport retrofit2.Call;\nimport retrofit2.Converter;\nimport retrofit2.Response;\nimport retrofit2.Retrofit;\nimport retrofit2.converter.gson.GsonConverterFactory;\nimport retrofit2.http.GET;\nimport retrofit2.http.Query;\n\npublic final class JsonQueryParameters {\n @Retention(RUNTIME)\n @interface Json {}\n\n static class JsonStringConverterFactory extends Converter.Factory {\n private final Converter.Factory delegateFactory;\n\n JsonStringConverterFactory(Converter.Factory delegateFactory) {\n this.delegateFactory = delegateFactory;\n }\n\n @Override\n public @Nullable Converter stringConverter(\n Type type, Annotation[] annotations, Retrofit retrofit) {\n for (Annotation annotation : annotations) {\n if (annotation instanceof Json) {\n // NOTE: If you also have a JSON converter factory installed in addition to this factory,\n // you can call retrofit.requestBodyConverter(type, annotations) instead of having a\n // reference to it explicitly as a field.\n Converter delegate =\n delegateFactory.requestBodyConverter(type, annotations, new Annotation[0], retrofit);\n return new DelegateToStringConverter<>(delegate);\n }\n }\n return null;\n }\n\n static class DelegateToStringConverter implements Converter {\n private final Converter delegate;\n\n DelegateToStringConverter(Converter delegate) {\n this.delegate = delegate;\n }\n\n @Override\n public String convert(T value) throws IOException {\n Buffer buffer = new Buffer();\n delegate.convert(value).writeTo(buffer);\n return buffer.readUtf8();\n }\n }\n }\n\n static class Filter {\n final String userId;\n\n Filter(String userId) {\n this.userId = userId;\n }\n }\n\n interface Service {\n @GET(\"/filter\")\n Call example(@Json @Query(\"value\") Filter value);\n }\n\n @SuppressWarnings(\"UnusedVariable\")\n public static void main(String... args) throws IOException, InterruptedException {\n MockWebServer server = new MockWebServer();\n server.start();\n server.enqueue(new MockResponse());\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(server.url(\"/\"))\n .addConverterFactory(new JsonStringConverterFactory(GsonConverterFactory.create()))\n .build();\n Service service = retrofit.create(Service.class);\n\n Call call = service.example(new Filter(\"123\"));\n Response response = call.execute();\n // TODO handle user response...\n\n // Print the request path that the server saw to show the JSON query param:\n RecordedRequest recordedRequest = server.takeRequest();\n System.out.println(recordedRequest.getPath());\n\n server.shutdown();\n }\n}\n" }, { "path": "samples/src/main/java/com/example/retrofit/RxJavaObserveOnMainThread.java", "content": "/*\n * Copyright (C) 2016 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage com.example.retrofit;\n\nimport static rx.schedulers.Schedulers.io;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Type;\nimport javax.annotation.Nullable;\nimport retrofit2.Call;\nimport retrofit2.CallAdapter;\nimport retrofit2.Retrofit;\nimport retrofit2.adapter.rxjava.RxJavaCallAdapterFactory;\nimport rx.Observable;\nimport rx.Scheduler;\nimport rx.schedulers.Schedulers;\n\npublic final class RxJavaObserveOnMainThread {\n @SuppressWarnings(\"UnusedVariable\")\n public static void main(String... args) {\n Scheduler observeOn = Schedulers.computation(); // Or use mainThread() for Android.\n\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(\"http://example.com\")\n .addCallAdapterFactory(new ObserveOnMainCallAdapterFactory(observeOn))\n .addCallAdapterFactory(RxJavaCallAdapterFactory.createWithScheduler(io()))\n .build();\n\n // Services created with this instance that use Observable will execute on the 'io' scheduler\n // and notify their observer on the 'computation' scheduler.\n }\n\n static final class ObserveOnMainCallAdapterFactory extends CallAdapter.Factory {\n final Scheduler scheduler;\n\n ObserveOnMainCallAdapterFactory(Scheduler scheduler) {\n this.scheduler = scheduler;\n }\n\n @Override\n public @Nullable CallAdapter get(\n Type returnType, Annotation[] annotations, Retrofit retrofit) {\n if (getRawType(returnType) != Observable.class) {\n return null; // Ignore non-Observable types.\n }\n\n // Look up the next call adapter which would otherwise be used if this one was not present.\n //noinspection unchecked returnType checked above to be Observable.\n final CallAdapter> delegate =\n (CallAdapter>)\n retrofit.nextCallAdapter(this, returnType, annotations);\n\n return new CallAdapter() {\n @Override\n public Object adapt(Call call) {\n // Delegate to get the normal Observable...\n Observable o = delegate.adapt(call);\n // ...and change it to send notifications to the observer on the specified scheduler.\n return o.observeOn(scheduler);\n }\n\n @Override\n public Type responseType() {\n return delegate.responseType();\n }\n };\n }\n }\n}\n" }, { "path": "samples/src/main/java/com/example/retrofit/SimpleMockService.java", "content": "// Copyright 2013 Square, Inc.\npackage com.example.retrofit;\n\nimport com.example.retrofit.SimpleService.Contributor;\nimport com.example.retrofit.SimpleService.GitHub;\nimport java.io.IOException;\nimport java.util.ArrayList;\nimport java.util.Collections;\nimport java.util.LinkedHashMap;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.concurrent.TimeUnit;\nimport retrofit2.Call;\nimport retrofit2.Retrofit;\nimport retrofit2.mock.BehaviorDelegate;\nimport retrofit2.mock.MockRetrofit;\nimport retrofit2.mock.NetworkBehavior;\n\n/**\n * An example of using {@link MockRetrofit} to create a mock service implementation with fake data.\n * This re-uses the GitHub service from {@link SimpleService} for its mocking.\n */\npublic final class SimpleMockService {\n /** A mock implementation of the {@link GitHub} API interface. */\n static final class MockGitHub implements GitHub {\n private final BehaviorDelegate delegate;\n private final Map>> ownerRepoContributors;\n\n MockGitHub(BehaviorDelegate delegate) {\n this.delegate = delegate;\n ownerRepoContributors = new LinkedHashMap<>();\n\n // Seed some mock data.\n addContributor(\"square\", \"retrofit\", \"John Doe\", 12);\n addContributor(\"square\", \"retrofit\", \"Bob Smith\", 2);\n addContributor(\"square\", \"retrofit\", \"Big Bird\", 40);\n addContributor(\"square\", \"picasso\", \"Proposition Joe\", 39);\n addContributor(\"square\", \"picasso\", \"Keiser Soze\", 152);\n }\n\n @Override\n public Call> contributors(String owner, String repo) {\n List response = Collections.emptyList();\n Map> repoContributors = ownerRepoContributors.get(owner);\n if (repoContributors != null) {\n List contributors = repoContributors.get(repo);\n if (contributors != null) {\n response = contributors;\n }\n }\n return delegate.returningResponse(response).contributors(owner, repo);\n }\n\n void addContributor(String owner, String repo, String name, int contributions) {\n Map> repoContributors = ownerRepoContributors.get(owner);\n if (repoContributors == null) {\n repoContributors = new LinkedHashMap<>();\n ownerRepoContributors.put(owner, repoContributors);\n }\n List contributors = repoContributors.get(repo);\n if (contributors == null) {\n contributors = new ArrayList<>();\n repoContributors.put(repo, contributors);\n }\n contributors.add(new Contributor(name, contributions));\n }\n }\n\n public static void main(String... args) throws IOException {\n // Create a very simple Retrofit adapter which points the GitHub API.\n Retrofit retrofit = new Retrofit.Builder().baseUrl(SimpleService.API_URL).build();\n\n // Create a MockRetrofit object with a NetworkBehavior which manages the fake behavior of calls.\n NetworkBehavior behavior = NetworkBehavior.create();\n MockRetrofit mockRetrofit =\n new MockRetrofit.Builder(retrofit).networkBehavior(behavior).build();\n\n BehaviorDelegate delegate = mockRetrofit.create(GitHub.class);\n MockGitHub gitHub = new MockGitHub(delegate);\n\n // Query for some contributors for a few repositories.\n printContributors(gitHub, \"square\", \"retrofit\");\n printContributors(gitHub, \"square\", \"picasso\");\n\n // Using the mock-only methods, add some additional data.\n System.out.println(\"Adding more mock data...\\n\");\n gitHub.addContributor(\"square\", \"retrofit\", \"Foo Bar\", 61);\n gitHub.addContributor(\"square\", \"picasso\", \"Kit Kat\", 53);\n\n // Reduce the delay to make the next calls complete faster.\n behavior.setDelay(500, TimeUnit.MILLISECONDS);\n\n // Query for the contributors again so we can see the mock data that was added.\n printContributors(gitHub, \"square\", \"retrofit\");\n printContributors(gitHub, \"square\", \"picasso\");\n }\n\n private static void printContributors(GitHub gitHub, String owner, String repo)\n throws IOException {\n System.out.println(String.format(\"== Contributors for %s/%s ==\", owner, repo));\n Call> contributors = gitHub.contributors(owner, repo);\n for (Contributor contributor : contributors.execute().body()) {\n System.out.println(contributor.login + \" (\" + contributor.contributions + \")\");\n }\n System.out.println();\n }\n}\n" }, { "path": "samples/src/main/java/com/example/retrofit/SimpleService.java", "content": "/*\n * Copyright (C) 2012 Square, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\npackage com.example.retrofit;\n\nimport java.io.IOException;\nimport java.util.List;\nimport retrofit2.Call;\nimport retrofit2.Retrofit;\nimport retrofit2.converter.gson.GsonConverterFactory;\nimport retrofit2.http.GET;\nimport retrofit2.http.Path;\n\npublic final class SimpleService {\n public static final String API_URL = \"https://api.github.com\";\n\n public static class Contributor {\n public final String login;\n public final int contributions;\n\n public Contributor(String login, int contributions) {\n this.login = login;\n this.contributions = contributions;\n }\n }\n\n public interface GitHub {\n @GET(\"/repos/{owner}/{repo}/contributors\")\n Call> contributors(@Path(\"owner\") String owner, @Path(\"repo\") String repo);\n }\n\n public static void main(String... args) throws IOException {\n // Create a very simple REST adapter which points the GitHub API.\n Retrofit retrofit =\n new Retrofit.Builder()\n .baseUrl(API_URL)\n .addConverterFactory(GsonConverterFactory.create())\n .build();\n\n // Create an instance of our GitHub API interface.\n GitHub github = retrofit.create(GitHub.class);\n\n // Create a call instance for looking up Retrofit contributors.\n Call> call = github.contributors(\"square\", \"retrofit\");\n\n // Fetch and print a list of the contributors to the library.\n List contributors = call.execute().body();\n for (Contributor contributor : contributors) {\n System.out.println(contributor.login + \" (\" + contributor.contributions + \")\");\n }\n }\n}\n" }, { "path": "samples/src/main/java/com/example/retrofit/package-info.java", "content": "@javax.annotation.ParametersAreNonnullByDefault\npackage com.example.retrofit;\n" }, { "path": "settings.gradle", "content": "plugins {\n id 'org.gradle.toolchains.foojay-resolver-convention' version '1.0.0'\n}\n\ndependencyResolutionManagement {\n repositories {\n mavenCentral()\n google()\n }\n}\n\nrootProject.name = 'retrofit-root'\n\ninclude ':retrofit'\ninclude ':retrofit-bom'\n\ninclude ':retrofit:android-test'\ninclude ':retrofit:java-test'\ninclude ':retrofit:kotlin-test'\ninclude ':retrofit:robovm-test'\ninclude ':retrofit:test-helpers'\n\ninclude ':retrofit-mock'\n\ninclude ':retrofit-response-type-keeper'\n\ninclude ':retrofit-adapters:guava'\ninclude ':retrofit-adapters:java8'\ninclude ':retrofit-adapters:rxjava'\ninclude ':retrofit-adapters:rxjava2'\ninclude ':retrofit-adapters:rxjava3'\ninclude ':retrofit-adapters:scala'\n\ninclude ':retrofit-converters:gson'\ninclude ':retrofit-converters:guava'\ninclude ':retrofit-converters:jackson'\ninclude ':retrofit-converters:java8'\ninclude ':retrofit-converters:jaxb'\ninclude ':retrofit-converters:jaxb3'\ninclude ':retrofit-converters:kotlinx-serialization'\ninclude ':retrofit-converters:moshi'\ninclude ':retrofit-converters:protobuf'\ninclude ':retrofit-converters:scalars'\ninclude ':retrofit-converters:simplexml'\ninclude ':retrofit-converters:wire'\n\ninclude ':samples'\n\nenableFeaturePreview('TYPESAFE_PROJECT_ACCESSORS')\n" }, { "path": "website/.gitignore", "content": "dist/\n.astro/\nnode_modules/\n\n# Populated by ./gradlew copyWebsiteDocs\npublic/3.x/\n" }, { "path": "website/README.md", "content": "# Website\n\nThe documentation is [built with Starlight](https://starlight.astro.build).\n\nCommon commands:\n\n* `npm install` – install deps (must do first or if `package.json` changes)\n* `npm run dev` – local, hot-reload server\n* `npm run build` – produce distribution in `dist/`\n * `npm run preview` – local server of the distribution folder\n * `npm run build -- --mode release` – remove \"snapshot\" banner\n" }, { "path": "website/astro.config.mjs", "content": "// @ts-check\nimport { readFileSync } from 'fs';\nimport { defineConfig, envField } from 'astro/config';\nimport starlight from '@astrojs/starlight';\nimport starlightLinksValidator from 'starlight-links-validator';\n\nlet retrofitProperties = readFileSync('../gradle.properties');\nlet retrofitVersion = /VERSION_NAME=(.*?)\\n/.exec(retrofitProperties)[1];\n\nexport default defineConfig({\n\tsite: 'https://square.github.io',\n\tbase: '/retrofit/latest',\n\tenv: {\n\t\tschema: {\n\t\t\tVERSION: envField.string({ context: 'server', access: 'public', optional: true, default: retrofitVersion }),\n\t\t},\n\t},\n\tintegrations: [\n\t\tstarlight({\n\t\t\ttitle: 'Retrofit',\n\t\t\tcustomCss: [\n\t\t\t\t'./src/styles/theme.css',\n\t\t\t],\n\t\t\teditLink: {\n\t\t\t\tbaseUrl: 'https://github.com/square/retrofit/edit/trunk/website',\n\t\t\t},\n\t\t\tsocial: [\n\t\t\t\t{ icon: 'stackOverflow', label: 'StackOverflow', href: 'https://stackoverflow.com/questions/tagged/retrofit?sort=active' },\n\t\t\t\t{ icon: 'github', label: 'GitHub', href: 'https://github.com/square/retrofit' },\n\t\t\t],\n\t\t\tsidebar: [\n\t\t\t\t{\n\t\t\t\t\tlabel: 'Documentation',\n\t\t\t\t\titems: [\n\t\t\t\t\t\t{ slug: 'index' },\n\t\t\t\t\t\t{ slug: 'declarations' },\n\t\t\t\t\t\t{ slug: 'configuration' },\n\t\t\t\t\t\t{ slug: 'download' },\n\t\t\t\t\t\t{ slug: 'contributing' },\n\t\t\t\t\t]\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tlabel: 'Resources',\n\t\t\t\t\titems: [\n\t\t\t\t\t\t{ label: 'GitHub', link: 'https://github.com/square/retrofit' },\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tlabel: 'Javadoc',\n\t\t\t\t\t\t\tcollapsed: true,\n\t\t\t\t\t\t\titems: [\n\t\t\t\t\t\t\t\t{ label: 'retrofit', link: '/3.x/retrofit/' },\n\t\t\t\t\t\t\t\t{ label: 'retrofit-mock', link: '/3.x/retrofit-mock/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-gson', link: '/3.x/converter-gson/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-guava', link: '/3.x/converter-guava/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-jackson', link: '/3.x/converter-jackson/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-java8', link: '/3.x/converter-java8/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-jaxb', link: '/3.x/converter-jaxb/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-jaxb3', link: '/3.x/converter-jaxb3/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-kotlinx-serialization', link: '/3.x/converter-kotlinx-serialization/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-moshi', link: '/3.x/converter-moshi/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-protobuf', link: '/3.x/converter-protobuf/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-scalars', link: '/3.x/converter-scalars/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-simplexml', link: '/3.x/converter-simplexml/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-wire', link: '/3.x/converter-wire/' },\n\t\t\t\t\t\t\t\t{ label: 'adapter-guava', link: '/3.x/adapter-guava/' },\n\t\t\t\t\t\t\t\t{ label: 'adapter-java8', link: '/3.x/adapter-java8/' },\n\t\t\t\t\t\t\t\t{ label: 'adapter-rxjava', link: '/3.x/adapter-rxjava/' },\n\t\t\t\t\t\t\t\t{ label: 'adapter-rxjava2', link: '/3.x/adapter-rxjava2/' },\n\t\t\t\t\t\t\t\t{ label: 'adapter-rxjava3', link: '/3.x/adapter-rxjava3/' },\n\t\t\t\t\t\t\t\t{ label: 'adapter-scala', link: '/3.x/adapter-scala/' },\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tlabel: 'Javadoc (2.x)',\n\t\t\t\t\t\t\tcollapsed: true,\n\t\t\t\t\t\t\titems: [\n\t\t\t\t\t\t\t\t{ label: 'retrofit', link: '/2.x/retrofit/' },\n\t\t\t\t\t\t\t\t{ label: 'retrofit-mock', link: '/2.x/retrofit-mock/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-gson', link: '/2.x/converter-gson/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-guava', link: '/2.x/converter-guava/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-jackson', link: '/2.x/converter-jackson/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-java8', link: '/2.x/converter-java8/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-jaxb', link: '/2.x/converter-jaxb/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-jaxb3', link: '/2.x/converter-jaxb3/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-kotlinx-serialization', link: '/2.x/converter-kotlinx-serialization/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-moshi', link: '/2.x/converter-moshi/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-protobuf', link: '/2.x/converter-protobuf/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-scalars', link: '/2.x/converter-scalars/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-simplexml', link: '/2.x/converter-simplexml/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-wire', link: '/2.x/converter-wire/' },\n\t\t\t\t\t\t\t\t{ label: 'adapter-guava', link: '/2.x/adapter-guava/' },\n\t\t\t\t\t\t\t\t{ label: 'adapter-java8', link: '/2.x/adapter-java8/' },\n\t\t\t\t\t\t\t\t{ label: 'adapter-rxjava', link: '/2.x/adapter-rxjava/' },\n\t\t\t\t\t\t\t\t{ label: 'adapter-rxjava2', link: '/2.x/adapter-rxjava2/' },\n\t\t\t\t\t\t\t\t{ label: 'adapter-rxjava3', link: '/2.x/adapter-rxjava3/' },\n\t\t\t\t\t\t\t\t{ label: 'adapter-scala', link: '/2.x/adapter-scala/' },\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tlabel: 'Javadoc (1.x)',\n\t\t\t\t\t\t\tcollapsed: true,\n\t\t\t\t\t\t\titems: [\n\t\t\t\t\t\t\t\t{ label: 'retrofit', link: '/1.x/retrofit/' },\n\t\t\t\t\t\t\t\t{ label: 'retrofit-mock', link: '/1.x/retrofit-mock/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-jackson', link: '/1.x/converter-jackson/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-protobuf', link: '/1.x/converter-protobuf/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-simplexml', link: '/1.x/converter-simplexml/' },\n\t\t\t\t\t\t\t\t{ label: 'converter-wire', link: '/1.x/converter-wire/' },\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{ label: 'StackOverflow', link: 'https://stackoverflow.com/questions/tagged/retrofit?sort=active' },\n\t\t\t\t\t],\n\t\t\t\t}\n\t\t\t],\n\t\t\tplugins: [\n\t\t\t\tstarlightLinksValidator(),\n\t\t\t],\n\t\t}),\n\t],\n});\n" }, { "path": "website/package.json", "content": "{\n \"name\": \"Retrofit Documentation\",\n \"type\": \"module\",\n \"version\": \"0.0.1\",\n \"scripts\": {\n \"dev\": \"astro dev\",\n \"build\": \"astro build\",\n \"preview\": \"astro preview\",\n \"astro\": \"astro\"\n },\n \"dependencies\": {\n \"@astrojs/starlight\": \"^0.37.0\",\n \"astro\": \"^5.6.1\",\n \"sharp\": \"^0.34.0\",\n \"starlight-links-validator\": \"^0.19.0\",\n \"starlight-versions\": \"^0.7.0\"\n }\n}\n" }, { "path": "website/public/1.x/converter-jackson/allclasses-frame.html", "content": "\n\n\n\n\n\nAll Classes (Converter: Jackson 1.9.0 API)\n\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/1.x/converter-jackson/allclasses-noframe.html", "content": "\n\n\n\n\n\nAll Classes (Converter: Jackson 1.9.0 API)\n\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/1.x/converter-jackson/constant-values.html", "content": "\n\n\n\n\n\nConstant Field Values (Converter: Jackson 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-jackson/deprecated-list.html", "content": "\n\n\n\n\n\nDeprecated List (Converter: Jackson 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-jackson/help-doc.html", "content": "\n\n\n\n\n\nAPI Help (Converter: Jackson 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Use

    \n

    Each documented package, class and interface has its own Use page. This page describes what packages, classes, methods, constructors and fields use any part of the given class or package. Given a class or interface A, its Use page includes subclasses of A, fields declared as A, methods that return A, and methods and constructors with parameters of type A. You can access this page by first going to the package, class or interface, then clicking on the \"Use\" link in the navigation bar.

    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-jackson/index-all.html", "content": "\n\n\n\n\n\nIndex (Converter: Jackson 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
F J R T \n\n\n

F

\n
\n
fromBody(TypedInput, Type) - Method in class retrofit.converter.JacksonConverter
\n
 
\n
\n\n\n\n

J

\n
\n
JacksonConverter - Class in retrofit.converter
\n
\n
A Converter which uses Jackson for reading and writing entities.
\n
\n
JacksonConverter() - Constructor for class retrofit.converter.JacksonConverter
\n
 
\n
JacksonConverter(ObjectMapper) - Constructor for class retrofit.converter.JacksonConverter
\n
 
\n
\n\n\n\n

R

\n
\n
retrofit.converter - package retrofit.converter
\n
 
\n
\n\n\n\n

T

\n
\n
toBody(Object) - Method in class retrofit.converter.JacksonConverter
\n
 
\n
\nF J R T 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-jackson/index.html", "content": "\n\n\n\n\n\nConverter: Jackson 1.9.0 API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit/converter/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/1.x/converter-jackson/overview-tree.html", "content": "\n\n\n\n\n\nClass Hierarchy (Converter: Jackson 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-jackson/package-list", "content": "retrofit.converter\n" }, { "path": "website/public/1.x/converter-jackson/retrofit/converter/JacksonConverter.html", "content": "\n\n\n\n\n\nJacksonConverter (Converter: Jackson 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.converter
\n

Class JacksonConverter

\n
\n
\n\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    Converter
    \n
    \n
    \n
    \n
    public class JacksonConverter\nextends Object\nimplements Converter
    \n
    A Converter which uses Jackson for reading and writing entities.
    \n
    \n
    Author:
    \n
    Kai Waldron (kaiwaldron@gmail.com)
    \n
    \n
    • \n
\n
\n
\n\n
\n
\n\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-jackson/retrofit/converter/class-use/JacksonConverter.html", "content": "\n\n\n\n\n\nUses of Class retrofit.converter.JacksonConverter (Converter: Jackson 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.converter.JacksonConverter

\n
\n
No usage of retrofit.converter.JacksonConverter
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-jackson/retrofit/converter/package-frame.html", "content": "\n\n\n\n\n\nretrofit.converter (Converter: Jackson 1.9.0 API)\n\n\n\n\n\n

retrofit.converter

\n
\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/1.x/converter-jackson/retrofit/converter/package-summary.html", "content": "\n\n\n\n\n\nretrofit.converter (Converter: Jackson 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Package retrofit.converter

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    JacksonConverter\n
    A Converter which uses Jackson for reading and writing entities.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-jackson/retrofit/converter/package-tree.html", "content": "\n\n\n\n\n\nretrofit.converter Class Hierarchy (Converter: Jackson 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit.converter

\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-jackson/retrofit/converter/package-use.html", "content": "\n\n\n\n\n\nUses of Package retrofit.converter (Converter: Jackson 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Package
retrofit.converter

\n
\n
No usage of retrofit.converter
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-jackson/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/1.x/converter-jackson/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n width:100%;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/1.x/converter-jackson/version.txt", "content": "1.9.0" }, { "path": "website/public/1.x/converter-protobuf/allclasses-frame.html", "content": "\n\n\n\n\n\nAll Classes (Converter: Protocol Buffers 1.9.0 API)\n\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/1.x/converter-protobuf/allclasses-noframe.html", "content": "\n\n\n\n\n\nAll Classes (Converter: Protocol Buffers 1.9.0 API)\n\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/1.x/converter-protobuf/constant-values.html", "content": "\n\n\n\n\n\nConstant Field Values (Converter: Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-protobuf/deprecated-list.html", "content": "\n\n\n\n\n\nDeprecated List (Converter: Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-protobuf/help-doc.html", "content": "\n\n\n\n\n\nAPI Help (Converter: Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Use

    \n

    Each documented package, class and interface has its own Use page. This page describes what packages, classes, methods, constructors and fields use any part of the given class or package. Given a class or interface A, its Use page includes subclasses of A, fields declared as A, methods that return A, and methods and constructors with parameters of type A. You can access this page by first going to the package, class or interface, then clicking on the \"Use\" link in the navigation bar.

    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-protobuf/index-all.html", "content": "\n\n\n\n\n\nIndex (Converter: Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
F P R T \n\n\n

F

\n
\n
fromBody(TypedInput, Type) - Method in class retrofit.converter.ProtoConverter
\n
 
\n
\n\n\n\n

P

\n
\n
ProtoConverter - Class in retrofit.converter
\n
\n
A Converter that reads and writes protocol buffers.
\n
\n
ProtoConverter() - Constructor for class retrofit.converter.ProtoConverter
\n
 
\n
\n\n\n\n

R

\n
\n
retrofit.converter - package retrofit.converter
\n
 
\n
\n\n\n\n

T

\n
\n
toBody(Object) - Method in class retrofit.converter.ProtoConverter
\n
 
\n
\nF P R T 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-protobuf/index.html", "content": "\n\n\n\n\n\nConverter: Protocol Buffers 1.9.0 API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit/converter/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/1.x/converter-protobuf/overview-tree.html", "content": "\n\n\n\n\n\nClass Hierarchy (Converter: Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-protobuf/package-list", "content": "retrofit.converter\n" }, { "path": "website/public/1.x/converter-protobuf/retrofit/converter/ProtoConverter.html", "content": "\n\n\n\n\n\nProtoConverter (Converter: Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.converter
\n

Class ProtoConverter

\n
\n
\n\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    Converter
    \n
    \n
    \n
    \n
    public class ProtoConverter\nextends Object\nimplements Converter
    \n
    A Converter that reads and writes protocol buffers.
    \n
    • \n
\n
\n
\n\n
\n
\n\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-protobuf/retrofit/converter/class-use/ProtoConverter.html", "content": "\n\n\n\n\n\nUses of Class retrofit.converter.ProtoConverter (Converter: Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.converter.ProtoConverter

\n
\n
No usage of retrofit.converter.ProtoConverter
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-protobuf/retrofit/converter/package-frame.html", "content": "\n\n\n\n\n\nretrofit.converter (Converter: Protocol Buffers 1.9.0 API)\n\n\n\n\n\n

retrofit.converter

\n
\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/1.x/converter-protobuf/retrofit/converter/package-summary.html", "content": "\n\n\n\n\n\nretrofit.converter (Converter: Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Package retrofit.converter

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    ProtoConverter\n
    A Converter that reads and writes protocol buffers.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-protobuf/retrofit/converter/package-tree.html", "content": "\n\n\n\n\n\nretrofit.converter Class Hierarchy (Converter: Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit.converter

\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-protobuf/retrofit/converter/package-use.html", "content": "\n\n\n\n\n\nUses of Package retrofit.converter (Converter: Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Package
retrofit.converter

\n
\n
No usage of retrofit.converter
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-protobuf/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/1.x/converter-protobuf/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n width:100%;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/1.x/converter-protobuf/version.txt", "content": "1.9.0" }, { "path": "website/public/1.x/converter-simplexml/allclasses-frame.html", "content": "\n\n\n\n\n\nAll Classes (Converter: SimpleXML 1.9.0 API)\n\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/1.x/converter-simplexml/allclasses-noframe.html", "content": "\n\n\n\n\n\nAll Classes (Converter: SimpleXML 1.9.0 API)\n\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/1.x/converter-simplexml/constant-values.html", "content": "\n\n\n\n\n\nConstant Field Values (Converter: SimpleXML 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-simplexml/deprecated-list.html", "content": "\n\n\n\n\n\nDeprecated List (Converter: SimpleXML 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-simplexml/help-doc.html", "content": "\n\n\n\n\n\nAPI Help (Converter: SimpleXML 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Use

    \n

    Each documented package, class and interface has its own Use page. This page describes what packages, classes, methods, constructors and fields use any part of the given class or package. Given a class or interface A, its Use page includes subclasses of A, fields declared as A, methods that return A, and methods and constructors with parameters of type A. You can access this page by first going to the package, class or interface, then clicking on the \"Use\" link in the navigation bar.

    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-simplexml/index-all.html", "content": "\n\n\n\n\n\nIndex (Converter: SimpleXML 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
F I R S T \n\n\n

F

\n
\n
fromBody(TypedInput, Type) - Method in class retrofit.converter.SimpleXMLConverter
\n
 
\n
\n\n\n\n

I

\n
\n
isStrict() - Method in class retrofit.converter.SimpleXMLConverter
\n
 
\n
\n\n\n\n

R

\n
\n
retrofit.converter - package retrofit.converter
\n
 
\n
\n\n\n\n

S

\n
\n
SimpleXMLConverter - Class in retrofit.converter
\n
\n
A Converter which uses SimpleXML for reading and writing entities.
\n
\n
SimpleXMLConverter() - Constructor for class retrofit.converter.SimpleXMLConverter
\n
 
\n
SimpleXMLConverter(boolean) - Constructor for class retrofit.converter.SimpleXMLConverter
\n
 
\n
SimpleXMLConverter(Serializer) - Constructor for class retrofit.converter.SimpleXMLConverter
\n
 
\n
SimpleXMLConverter(Serializer, boolean) - Constructor for class retrofit.converter.SimpleXMLConverter
\n
 
\n
\n\n\n\n

T

\n
\n
toBody(Object) - Method in class retrofit.converter.SimpleXMLConverter
\n
 
\n
\nF I R S T 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-simplexml/index.html", "content": "\n\n\n\n\n\nConverter: SimpleXML 1.9.0 API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit/converter/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/1.x/converter-simplexml/overview-tree.html", "content": "\n\n\n\n\n\nClass Hierarchy (Converter: SimpleXML 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-simplexml/package-list", "content": "retrofit.converter\n" }, { "path": "website/public/1.x/converter-simplexml/retrofit/converter/SimpleXMLConverter.html", "content": "\n\n\n\n\n\nSimpleXMLConverter (Converter: SimpleXML 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.converter
\n

Class SimpleXMLConverter

\n
\n
\n\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    Converter
    \n
    \n
    \n
    \n
    public class SimpleXMLConverter\nextends Object\nimplements Converter
    \n
    A Converter which uses SimpleXML for reading and writing entities.
    \n
    \n
    Author:
    \n
    Fabien Ric (fabien.ric@gmail.com)
    \n
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        SimpleXMLConverter

        \n
        public SimpleXMLConverter()
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        SimpleXMLConverter

        \n
        public SimpleXMLConverter(boolean strict)
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        SimpleXMLConverter

        \n
        public SimpleXMLConverter(org.simpleframework.xml.Serializer serializer)
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        SimpleXMLConverter

        \n
        public SimpleXMLConverter(org.simpleframework.xml.Serializer serializer,\n                          boolean strict)
        \n
        • \n
      \n
      • \n
    \n\n\n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-simplexml/retrofit/converter/class-use/SimpleXMLConverter.html", "content": "\n\n\n\n\n\nUses of Class retrofit.converter.SimpleXMLConverter (Converter: SimpleXML 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.converter.SimpleXMLConverter

\n
\n
No usage of retrofit.converter.SimpleXMLConverter
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-simplexml/retrofit/converter/package-frame.html", "content": "\n\n\n\n\n\nretrofit.converter (Converter: SimpleXML 1.9.0 API)\n\n\n\n\n\n

retrofit.converter

\n
\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/1.x/converter-simplexml/retrofit/converter/package-summary.html", "content": "\n\n\n\n\n\nretrofit.converter (Converter: SimpleXML 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Package retrofit.converter

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    SimpleXMLConverter\n
    A Converter which uses SimpleXML for reading and writing entities.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-simplexml/retrofit/converter/package-tree.html", "content": "\n\n\n\n\n\nretrofit.converter Class Hierarchy (Converter: SimpleXML 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit.converter

\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-simplexml/retrofit/converter/package-use.html", "content": "\n\n\n\n\n\nUses of Package retrofit.converter (Converter: SimpleXML 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Package
retrofit.converter

\n
\n
No usage of retrofit.converter
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-simplexml/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/1.x/converter-simplexml/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n width:100%;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/1.x/converter-simplexml/version.txt", "content": "1.9.0" }, { "path": "website/public/1.x/converter-wire/allclasses-frame.html", "content": "\n\n\n\n\n\nAll Classes (Converter: Wire Protocol Buffers 1.9.0 API)\n\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/1.x/converter-wire/allclasses-noframe.html", "content": "\n\n\n\n\n\nAll Classes (Converter: Wire Protocol Buffers 1.9.0 API)\n\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/1.x/converter-wire/constant-values.html", "content": "\n\n\n\n\n\nConstant Field Values (Converter: Wire Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-wire/deprecated-list.html", "content": "\n\n\n\n\n\nDeprecated List (Converter: Wire Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-wire/help-doc.html", "content": "\n\n\n\n\n\nAPI Help (Converter: Wire Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Use

    \n

    Each documented package, class and interface has its own Use page. This page describes what packages, classes, methods, constructors and fields use any part of the given class or package. Given a class or interface A, its Use page includes subclasses of A, fields declared as A, methods that return A, and methods and constructors with parameters of type A. You can access this page by first going to the package, class or interface, then clicking on the \"Use\" link in the navigation bar.

    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-wire/index-all.html", "content": "\n\n\n\n\n\nIndex (Converter: Wire Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
F R T W \n\n\n

F

\n
\n
fromBody(TypedInput, Type) - Method in class retrofit.converter.WireConverter
\n
 
\n
\n\n\n\n

R

\n
\n
retrofit.converter - package retrofit.converter
\n
 
\n
\n\n\n\n

T

\n
\n
toBody(Object) - Method in class retrofit.converter.WireConverter
\n
 
\n
\n\n\n\n

W

\n
\n
WireConverter - Class in retrofit.converter
\n
\n
A Converter that reads and writes protocol buffers using Wire.
\n
\n
WireConverter() - Constructor for class retrofit.converter.WireConverter
\n
\n
Create a converter with a default Wire instance.
\n
\n
WireConverter(Wire) - Constructor for class retrofit.converter.WireConverter
\n
\n
Create a converter using the supplied Wire instance.
\n
\n
\nF R T W 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-wire/index.html", "content": "\n\n\n\n\n\nConverter: Wire Protocol Buffers 1.9.0 API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit/converter/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/1.x/converter-wire/overview-tree.html", "content": "\n\n\n\n\n\nClass Hierarchy (Converter: Wire Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-wire/package-list", "content": "retrofit.converter\n" }, { "path": "website/public/1.x/converter-wire/retrofit/converter/WireConverter.html", "content": "\n\n\n\n\n\nWireConverter (Converter: Wire Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.converter
\n

Class WireConverter

\n
\n
\n\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    Converter
    \n
    \n
    \n
    \n
    public class WireConverter\nextends Object\nimplements Converter
    \n
    A Converter that reads and writes protocol buffers using Wire.
    \n
    • \n
\n
\n
\n\n
\n
\n\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-wire/retrofit/converter/class-use/WireConverter.html", "content": "\n\n\n\n\n\nUses of Class retrofit.converter.WireConverter (Converter: Wire Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.converter.WireConverter

\n
\n
No usage of retrofit.converter.WireConverter
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-wire/retrofit/converter/package-frame.html", "content": "\n\n\n\n\n\nretrofit.converter (Converter: Wire Protocol Buffers 1.9.0 API)\n\n\n\n\n\n

retrofit.converter

\n
\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/1.x/converter-wire/retrofit/converter/package-summary.html", "content": "\n\n\n\n\n\nretrofit.converter (Converter: Wire Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Package retrofit.converter

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    WireConverter\n
    A Converter that reads and writes protocol buffers using Wire.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-wire/retrofit/converter/package-tree.html", "content": "\n\n\n\n\n\nretrofit.converter Class Hierarchy (Converter: Wire Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit.converter

\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-wire/retrofit/converter/package-use.html", "content": "\n\n\n\n\n\nUses of Package retrofit.converter (Converter: Wire Protocol Buffers 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Package
retrofit.converter

\n
\n
No usage of retrofit.converter
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/converter-wire/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/1.x/converter-wire/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n width:100%;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/1.x/converter-wire/version.txt", "content": "1.9.0" }, { "path": "website/public/1.x/retrofit/allclasses-frame.html", "content": "\n\n\n\n\n\nAll Classes (Retrofit 1.9.0 API)\n\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/1.x/retrofit/allclasses-noframe.html", "content": "\n\n\n\n\n\nAll Classes (Retrofit 1.9.0 API)\n\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/1.x/retrofit/constant-values.html", "content": "\n\n\n\n\n\nConstant Field Values (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n\n
\n
\n\n\n

retrofit.mime.*

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/deprecated-list.html", "content": "\n\n\n\n\n\nDeprecated List (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n\n
\n
\n\n\n\n\n\n\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/help-doc.html", "content": "\n\n\n\n\n\nAPI Help (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Overview

    \n

    The Overview page is the front page of this API document and provides a list of all packages with a summary for each. This page can also contain an overall description of the set of packages.

    \n
    • \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Use

    \n

    Each documented package, class and interface has its own Use page. This page describes what packages, classes, methods, constructors and fields use any part of the given class or package. Given a class or interface A, its Use page includes subclasses of A, fields declared as A, methods that return A, and methods and constructors with parameters of type A. You can access this page by first going to the package, class or interface, then clicking on the \"Use\" link in the navigation bar.

    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/index-all.html", "content": "\n\n\n\n\n\nIndex (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
A B C D E F G H I L M N O P Q R S T U V W \n\n\n

A

\n
\n
addEncodedPathParam(String, String) - Method in interface retrofit.RequestInterceptor.RequestFacade
\n
\n
Add a path parameter replacement without first URI encoding.
\n
\n
addEncodedQueryParam(String, String) - Method in interface retrofit.RequestInterceptor.RequestFacade
\n
\n
Add an additional query parameter without first URI encoding.
\n
\n
addField(String, String) - Method in class retrofit.mime.FormUrlEncodedTypedOutput
\n
 
\n
addField(String, boolean, String, boolean) - Method in class retrofit.mime.FormUrlEncodedTypedOutput
\n
 
\n
addHeader(String, String) - Method in interface retrofit.RequestInterceptor.RequestFacade
\n
\n
Add a header to the request.
\n
\n
addPart(String, TypedOutput) - Method in class retrofit.mime.MultipartTypedOutput
\n
 
\n
addPart(String, String, TypedOutput) - Method in class retrofit.mime.MultipartTypedOutput
\n
 
\n
addPathParam(String, String) - Method in interface retrofit.RequestInterceptor.RequestFacade
\n
\n
Add a path parameter replacement.
\n
\n
addQueryParam(String, String) - Method in interface retrofit.RequestInterceptor.RequestFacade
\n
\n
Add an additional query parameter.
\n
\n
afterCall(Profiler.RequestInformation, long, int, T) - Method in interface retrofit.Profiler
\n
\n
Invoked after an HTTP method completes.
\n
\n
AndroidApacheClient - Class in retrofit.android
\n
\n
Provides a Client which uses the Android-specific version of\n HttpClient, AndroidHttpClient.
\n
\n
AndroidApacheClient() - Constructor for class retrofit.android.AndroidApacheClient
\n
 
\n
AndroidLog - Class in retrofit.android
\n
\n
A logger for Android.
\n
\n
AndroidLog(String) - Constructor for class retrofit.android.AndroidLog
\n
 
\n
ApacheClient - Class in retrofit.client
\n
\n
A Client which uses an implementation of Apache's HttpClient.
\n
\n
ApacheClient() - Constructor for class retrofit.client.ApacheClient
\n
\n
Creates an instance backed by DefaultHttpClient.
\n
\n
ApacheClient(HttpClient) - Constructor for class retrofit.client.ApacheClient
\n
 
\n
\n\n\n\n

B

\n
\n
beforeCall() - Method in interface retrofit.Profiler
\n
\n
Invoked before an HTTP method call.
\n
\n
Body - Annotation Type in retrofit.http
\n
\n
Use this annotation on a service method param when you want to directly control the request body\n of a POST/PUT request (instead of sending in as request parameters or form-style request\n body).
\n
\n
build() - Method in class retrofit.RestAdapter.Builder
\n
\n
Create the RestAdapter instances.
\n
\n
Builder() - Constructor for class retrofit.RestAdapter.Builder
\n
 
\n
\n\n\n\n

C

\n
\n
Callback<T> - Interface in retrofit
\n
\n
Communicates responses from a server or offline requests.
\n
\n
Client - Interface in retrofit.client
\n
\n
Abstraction of an HTTP client which can execute Requests.
\n
\n
Client.Provider - Interface in retrofit.client
\n
\n
Deferred means of obtaining a Client.
\n
\n
conversionError(String, Response, Converter, Type, ConversionException) - Static method in exception retrofit.RetrofitError
\n
 
\n
ConversionException - Exception in retrofit.converter
\n
\n
Indicate that conversion was unable to complete successfully.
\n
\n
ConversionException(String) - Constructor for exception retrofit.converter.ConversionException
\n
 
\n
ConversionException(String, Throwable) - Constructor for exception retrofit.converter.ConversionException
\n
 
\n
ConversionException(Throwable) - Constructor for exception retrofit.converter.ConversionException
\n
 
\n
Converter - Interface in retrofit.converter
\n
\n
Arbiter for converting objects to and from their representation in HTTP.
\n
\n
create(Class<T>) - Method in class retrofit.RestAdapter
\n
\n
Create an implementation of the API defined by the specified service interface.
\n
\n
\n\n\n\n

D

\n
\n
DEFAULT - Static variable in interface retrofit.ErrorHandler
\n
\n
An ErrorHandler which returns the original error.
\n
\n
DEFAULT_TRANSFER_ENCODING - Static variable in class retrofit.mime.MultipartTypedOutput
\n
 
\n
DELETE - Annotation Type in retrofit.http
\n
\n
Make a DELETE request to a REST path relative to base URL.
\n
\n
\n\n\n\n

E

\n
\n
EncodedPath - Annotation Type in retrofit.http
\n
\n
Deprecated.\n
Use Path with encode = false.
\n
\n
\n
EncodedQuery - Annotation Type in retrofit.http
\n
\n
Deprecated.\n
Use Query with encodeValue = false.
\n
\n
\n
EncodedQueryMap - Annotation Type in retrofit.http
\n
\n
Deprecated.\n
Use QueryMap with encodeValues = false.
\n
\n
\n
Endpoint - Interface in retrofit
\n
\n
Represents an API endpoint URL and associated name.
\n
\n
Endpoints - Class in retrofit
\n
\n
Static factory methods for creating Endpoint instances.
\n
\n
equals(Object) - Method in class retrofit.client.Header
\n
 
\n
equals(Object) - Method in class retrofit.mime.TypedByteArray
\n
 
\n
equals(Object) - Method in class retrofit.mime.TypedFile
\n
 
\n
ErrorHandler - Interface in retrofit
\n
\n
A hook allowing clients to customize response exceptions.
\n
\n
execute(Runnable) - Method in class retrofit.android.MainThreadExecutor
\n
 
\n
execute(Request) - Method in class retrofit.appengine.UrlFetchClient
\n
 
\n
execute(URLFetchService, HTTPRequest) - Method in class retrofit.appengine.UrlFetchClient
\n
\n
Execute the specified request using the provided urlFetchService.
\n
\n
execute(Request) - Method in class retrofit.client.ApacheClient
\n
 
\n
execute(HttpClient, HttpUriRequest) - Method in class retrofit.client.ApacheClient
\n
\n
Execute the specified request using the provided client.
\n
\n
execute(Request) - Method in interface retrofit.client.Client
\n
\n
Synchronously execute an HTTP represented by request and encapsulate all response data\n into a Response instance.
\n
\n
execute(Request) - Method in class retrofit.client.OkClient
\n
 
\n
execute(Request) - Method in class retrofit.client.UrlConnectionClient
\n
 
\n
\n\n\n\n

F

\n
\n
failure(RetrofitError) - Method in interface retrofit.Callback
\n
\n
Unsuccessful HTTP response due to network failure, non-2XX status code, or unexpected\n exception.
\n
\n
Field - Annotation Type in retrofit.http
\n
\n
Named pair for a form-encoded request.
\n
\n
FieldMap - Annotation Type in retrofit.http
\n
\n
Named key/value pairs for a form-encoded request.
\n
\n
file() - Method in class retrofit.mime.TypedFile
\n
\n
Returns the file.
\n
\n
fileName() - Method in class retrofit.mime.FormUrlEncodedTypedOutput
\n
 
\n
fileName() - Method in class retrofit.mime.MultipartTypedOutput
\n
 
\n
fileName() - Method in class retrofit.mime.TypedByteArray
\n
 
\n
fileName() - Method in class retrofit.mime.TypedFile
\n
 
\n
fileName() - Method in interface retrofit.mime.TypedOutput
\n
\n
Original filename.
\n
\n
FormUrlEncoded - Annotation Type in retrofit.http
\n
\n
Denotes that the request body will use form URL encoding.
\n
\n
FormUrlEncodedTypedOutput - Class in retrofit.mime
\n
 
\n
FormUrlEncodedTypedOutput() - Constructor for class retrofit.mime.FormUrlEncodedTypedOutput
\n
 
\n
fromBody(TypedInput, Type) - Method in interface retrofit.converter.Converter
\n
\n
Convert an HTTP response body to a concrete object of the specified type.
\n
\n
fromBody(TypedInput, Type) - Method in class retrofit.converter.GsonConverter
\n
 
\n
\n\n\n\n

G

\n
\n
get() - Method in interface retrofit.client.Client.Provider
\n
\n
Obtain an HTTP client.
\n
\n
GET - Annotation Type in retrofit.http
\n
\n
Make a GET request to a REST path relative to base URL.
\n
\n
getBaseUrl() - Method in class retrofit.Profiler.RequestInformation
\n
\n
Returns the URL to which the originating request was sent.
\n
\n
getBody() - Method in class retrofit.client.Request
\n
\n
Returns the request body or null.
\n
\n
getBody() - Method in class retrofit.client.Response
\n
\n
Response body.
\n
\n
getBody() - Method in exception retrofit.RetrofitError
\n
\n
HTTP response body converted to the type declared by either the interface method return type\n or the generic type of the supplied Callback parameter.
\n
\n
getBodyAs(Type) - Method in exception retrofit.RetrofitError
\n
\n
HTTP response body converted to specified type.
\n
\n
getBytes() - Method in class retrofit.mime.TypedByteArray
\n
 
\n
getContentLength() - Method in class retrofit.Profiler.RequestInformation
\n
\n
Returns the number of bytes in the originating request.
\n
\n
getContentType() - Method in class retrofit.Profiler.RequestInformation
\n
\n
Returns the content type header value of the originating request.
\n
\n
getHeaders() - Method in class retrofit.client.Request
\n
\n
Returns an unmodifiable list of headers, never null.
\n
\n
getHeaders() - Method in class retrofit.client.Response
\n
\n
An unmodifiable collection of headers.
\n
\n
getKind() - Method in exception retrofit.RetrofitError
\n
\n
The event kind which triggered this error.
\n
\n
getLogLevel() - Method in class retrofit.RestAdapter
\n
\n
The current logging level.
\n
\n
getMethod() - Method in class retrofit.client.Request
\n
\n
HTTP method verb.
\n
\n
getMethod() - Method in class retrofit.Profiler.RequestInformation
\n
\n
Returns the HTTP method of the originating request.
\n
\n
getName() - Method in class retrofit.client.Header
\n
 
\n
getName() - Method in interface retrofit.Endpoint
\n
\n
A name for differentiating between multiple API URLs.
\n
\n
getPartCount() - Method in class retrofit.mime.MultipartTypedOutput
\n
 
\n
getReason() - Method in class retrofit.client.Response
\n
\n
Status line reason phrase.
\n
\n
getRelativePath() - Method in class retrofit.Profiler.RequestInformation
\n
\n
Returns the path relative to the base URL to which the originating request was sent.
\n
\n
getResponse() - Method in exception retrofit.RetrofitError
\n
\n
Response object containing status code, headers, body, etc.
\n
\n
getStatus() - Method in class retrofit.client.Response
\n
\n
Status line code.
\n
\n
getSuccessType() - Method in exception retrofit.RetrofitError
\n
\n
The type declared by either the interface method return type or the generic type of the\n supplied Callback parameter.
\n
\n
getTag() - Method in class retrofit.android.AndroidLog
\n
 
\n
getUrl() - Method in class retrofit.client.Request
\n
\n
Target URL.
\n
\n
getUrl() - Method in class retrofit.client.Response
\n
\n
Request URL.
\n
\n
getUrl() - Method in interface retrofit.Endpoint
\n
\n
The base API URL.
\n
\n
getUrl() - Method in exception retrofit.RetrofitError
\n
\n
The request URL which produced the error.
\n
\n
getValue() - Method in class retrofit.client.Header
\n
 
\n
GsonConverter - Class in retrofit.converter
\n
\n
A Converter which uses GSON for serialization and deserialization of entities.
\n
\n
GsonConverter(Gson) - Constructor for class retrofit.converter.GsonConverter
\n
\n
Create an instance using the supplied Gson object for conversion.
\n
\n
GsonConverter(Gson, String) - Constructor for class retrofit.converter.GsonConverter
\n
\n
Create an instance using the supplied Gson object for conversion.
\n
\n
\n\n\n\n

H

\n
\n
handleError(RetrofitError) - Method in interface retrofit.ErrorHandler
\n
\n
Return a custom exception to be thrown for a RetrofitError.
\n
\n
hashCode() - Method in class retrofit.client.Header
\n
 
\n
hashCode() - Method in class retrofit.mime.TypedByteArray
\n
 
\n
hashCode() - Method in class retrofit.mime.TypedFile
\n
 
\n
HEAD - Annotation Type in retrofit.http
\n
\n
Make a HEAD request to a REST path relative to base URL.
\n
\n
Header - Class in retrofit.client
\n
\n
Represents an HTTP header name/value pair.
\n
\n
Header(String, String) - Constructor for class retrofit.client.Header
\n
 
\n
Header - Annotation Type in retrofit.http
\n
\n
Replaces the header with the value of its target.
\n
\n
Headers - Annotation Type in retrofit.http
\n
\n
Adds headers literally supplied in the value.
\n
\n
httpError(String, Response, Converter, Type) - Static method in exception retrofit.RetrofitError
\n
 
\n
\n\n\n\n

I

\n
\n
in() - Method in class retrofit.mime.TypedByteArray
\n
 
\n
in() - Method in class retrofit.mime.TypedFile
\n
 
\n
in() - Method in interface retrofit.mime.TypedInput
\n
\n
Read bytes as stream.
\n
\n
intercept(RequestInterceptor.RequestFacade) - Method in interface retrofit.RequestInterceptor
\n
\n
Called for every request.
\n
\n
isNetworkError() - Method in exception retrofit.RetrofitError
\n
\n
Deprecated.\n
Use getKind() == Kind.NETWORK.
\n
\n
\n
\n\n\n\n

L

\n
\n
length() - Method in class retrofit.mime.FormUrlEncodedTypedOutput
\n
 
\n
length() - Method in class retrofit.mime.MultipartTypedOutput
\n
 
\n
length() - Method in class retrofit.mime.TypedByteArray
\n
 
\n
length() - Method in class retrofit.mime.TypedFile
\n
 
\n
length() - Method in interface retrofit.mime.TypedInput
\n
\n
Length in bytes.
\n
\n
length() - Method in interface retrofit.mime.TypedOutput
\n
\n
Length in bytes or -1 if unknown.
\n
\n
log(String) - Method in class retrofit.android.AndroidLog
\n
 
\n
log(String) - Method in interface retrofit.RestAdapter.Log
\n
\n
Log a debug message to the appropriate console.
\n
\n
log() - Method in enum retrofit.RestAdapter.LogLevel
\n
 
\n
logChunk(String) - Method in class retrofit.android.AndroidLog
\n
\n
Called one or more times for each call to AndroidLog.log(String).
\n
\n
\n\n\n\n

M

\n
\n
MainThreadExecutor - Class in retrofit.android
\n
\n
Executor that runs tasks on Android's main thread.
\n
\n
MainThreadExecutor() - Constructor for class retrofit.android.MainThreadExecutor
\n
 
\n
mimeType() - Method in class retrofit.mime.FormUrlEncodedTypedOutput
\n
 
\n
mimeType() - Method in class retrofit.mime.MultipartTypedOutput
\n
 
\n
mimeType() - Method in class retrofit.mime.TypedByteArray
\n
 
\n
mimeType() - Method in class retrofit.mime.TypedFile
\n
 
\n
mimeType() - Method in interface retrofit.mime.TypedInput
\n
\n
Returns the mime type.
\n
\n
mimeType() - Method in interface retrofit.mime.TypedOutput
\n
\n
Returns the mime type.
\n
\n
MimeUtil - Class in retrofit.mime
\n
 
\n
moveTo(TypedFile) - Method in class retrofit.mime.TypedFile
\n
\n
Atomically moves the contents of this file to a new location.
\n
\n
Multipart - Annotation Type in retrofit.http
\n
\n
Denotes that the request body is multi-part.
\n
\n
MultipartTypedOutput - Class in retrofit.mime
\n
 
\n
MultipartTypedOutput() - Constructor for class retrofit.mime.MultipartTypedOutput
\n
 
\n
\n\n\n\n

N

\n
\n
networkError(String, IOException) - Static method in exception retrofit.RetrofitError
\n
 
\n
newFixedEndpoint(String) - Static method in class retrofit.Endpoints
\n
\n
Create a server with the provided URL.
\n
\n
newFixedEndpoint(String, String) - Static method in class retrofit.Endpoints
\n
\n
Create an endpoint with the provided URL and name.
\n
\n
NONE - Static variable in interface retrofit.RequestInterceptor
\n
\n
A RequestInterceptor which does no modification of requests.
\n
\n
NONE - Static variable in interface retrofit.RestAdapter.Log
\n
\n
A RestAdapter.Log implementation which does not log anything.
\n
\n
\n\n\n\n

O

\n
\n
OkClient - Class in retrofit.client
\n
\n
Retrofit client that uses OkHttp for communication.
\n
\n
OkClient() - Constructor for class retrofit.client.OkClient
\n
 
\n
OkClient(OkHttpClient) - Constructor for class retrofit.client.OkClient
\n
 
\n
openConnection(Request) - Method in class retrofit.client.UrlConnectionClient
\n
 
\n
\n\n\n\n

P

\n
\n
parseCharset(String) - Static method in class retrofit.mime.MimeUtil
\n
\n
Deprecated.\n
Use MimeUtil.parseCharset(String, String).
\n
\n
\n
parseCharset(String, String) - Static method in class retrofit.mime.MimeUtil
\n
\n
Parse the MIME type from a Content-Type header value.
\n
\n
Part - Annotation Type in retrofit.http
\n
\n
Denotes a single part of a multi-part request.
\n
\n
PartMap - Annotation Type in retrofit.http
\n
\n
Denotes name and value parts of a multi-part request
\n
\n
PATCH - Annotation Type in retrofit.http
\n
\n
Make a PATCH request to a REST path relative to base URL.
\n
\n
Path - Annotation Type in retrofit.http
\n
\n
Named replacement in the URL path.
\n
\n
POST - Annotation Type in retrofit.http
\n
\n
Make a POST request to a REST path relative to base URL.
\n
\n
Profiler<T> - Interface in retrofit
\n
\n
A hook allowing clients to log HTTP method times and response status codes.
\n
\n
Profiler.RequestInformation - Class in retrofit
\n
\n
Information about the HTTP request.
\n
\n
PUT - Annotation Type in retrofit.http
\n
\n
Make a PUT request to a REST path relative to base URL.
\n
\n
\n\n\n\n

Q

\n
\n
Query - Annotation Type in retrofit.http
\n
\n
Query parameter appended to the URL.
\n
\n
QueryMap - Annotation Type in retrofit.http
\n
\n
Query parameter keys and values appended to the URL.
\n
\n
\n\n\n\n

R

\n
\n
Request - Class in retrofit.client
\n
\n
Encapsulates all of the information necessary to make an HTTP request.
\n
\n
Request(String, String, List<Header>, TypedOutput) - Constructor for class retrofit.client.Request
\n
 
\n
RequestInformation(String, String, String, long, String) - Constructor for class retrofit.Profiler.RequestInformation
\n
 
\n
RequestInterceptor - Interface in retrofit
\n
\n
Intercept every request before it is executed in order to add additional data.
\n
\n
RequestInterceptor.RequestFacade - Interface in retrofit
\n
 
\n
Response - Class in retrofit.client
\n
\n
An HTTP response.
\n
\n
Response(String, int, String, List<Header>, TypedInput) - Constructor for class retrofit.client.Response
\n
 
\n
ResponseCallback - Class in retrofit
\n
\n
An extension of Callback which returns only Response object\n in Callback.success(Object, retrofit.client.Response) method.
\n
\n
ResponseCallback() - Constructor for class retrofit.ResponseCallback
\n
 
\n
RestAdapter - Class in retrofit
\n
\n
Adapts a Java interface to a REST API.
\n
\n
RestAdapter.Builder - Class in retrofit
\n
\n
Build a new RestAdapter.
\n
\n
RestAdapter.Log - Interface in retrofit
\n
\n
Simple logging abstraction for debug messages.
\n
\n
RestAdapter.LogLevel - Enum in retrofit
\n
\n
Controls the level of logging.
\n
\n
RestMethod - Annotation Type in retrofit.http
\n
 
\n
retrofit - package retrofit
\n
\n
Retrofit turns your REST API into a Java interface.
\n
\n
retrofit.android - package retrofit.android
\n
 
\n
retrofit.appengine - package retrofit.appengine
\n
 
\n
retrofit.client - package retrofit.client
\n
 
\n
retrofit.converter - package retrofit.converter
\n
 
\n
retrofit.http - package retrofit.http
\n
\n
Annotations for interface methods to control the HTTP request behavior.
\n
\n
retrofit.mime - package retrofit.mime
\n
 
\n
RetrofitError - Exception in retrofit
\n
 
\n
RetrofitError.Kind - Enum in retrofit
\n
\n
Identifies the event kind which triggered a RetrofitError.
\n
\n
\n\n\n\n

S

\n
\n
setClient(Client) - Method in class retrofit.RestAdapter.Builder
\n
\n
The HTTP client used for requests.
\n
\n
setClient(Client.Provider) - Method in class retrofit.RestAdapter.Builder
\n
\n
The HTTP client used for requests.
\n
\n
setConverter(Converter) - Method in class retrofit.RestAdapter.Builder
\n
\n
The converter used for serialization and deserialization of objects.
\n
\n
setEndpoint(String) - Method in class retrofit.RestAdapter.Builder
\n
\n
API endpoint URL.
\n
\n
setEndpoint(Endpoint) - Method in class retrofit.RestAdapter.Builder
\n
\n
API endpoint.
\n
\n
setErrorHandler(ErrorHandler) - Method in class retrofit.RestAdapter.Builder
\n
\n
The error handler allows you to customize the type of exception thrown for errors on\n synchronous requests.
\n
\n
setExecutors(Executor, Executor) - Method in class retrofit.RestAdapter.Builder
\n
\n
Executors used for asynchronous HTTP client downloads and callbacks.
\n
\n
setLog(RestAdapter.Log) - Method in class retrofit.RestAdapter.Builder
\n
\n
Configure debug logging mechanism.
\n
\n
setLogLevel(RestAdapter.LogLevel) - Method in class retrofit.RestAdapter.Builder
\n
\n
Change the level of logging.
\n
\n
setLogLevel(RestAdapter.LogLevel) - Method in class retrofit.RestAdapter
\n
\n
Change the level of logging.
\n
\n
setProfiler(Profiler) - Method in class retrofit.RestAdapter.Builder
\n
\n
Set the profiler used to measure requests.
\n
\n
setRequestInterceptor(RequestInterceptor) - Method in class retrofit.RestAdapter.Builder
\n
\n
A request interceptor for adding data to every request.
\n
\n
Streaming - Annotation Type in retrofit.http
\n
\n
Treat the response body on methods returning Response as is,\n i.e.
\n
\n
success(T, Response) - Method in interface retrofit.Callback
\n
\n
Successful HTTP response.
\n
\n
success(Response, Response) - Method in class retrofit.ResponseCallback
\n
 
\n
success(Response) - Method in class retrofit.ResponseCallback
\n
\n
Successful HTTP response.
\n
\n
\n\n\n\n

T

\n
\n
toBody(Object) - Method in interface retrofit.converter.Converter
\n
\n
Convert an object to an appropriate representation for HTTP transport.
\n
\n
toBody(Object) - Method in class retrofit.converter.GsonConverter
\n
 
\n
toString() - Method in class retrofit.client.Header
\n
 
\n
toString() - Method in class retrofit.mime.TypedByteArray
\n
 
\n
toString() - Method in class retrofit.mime.TypedFile
\n
 
\n
toString() - Method in class retrofit.mime.TypedString
\n
 
\n
TypedByteArray - Class in retrofit.mime
\n
\n
Byte array and its mime type.
\n
\n
TypedByteArray(String, byte[]) - Constructor for class retrofit.mime.TypedByteArray
\n
\n
Constructs a new typed byte array.
\n
\n
TypedFile - Class in retrofit.mime
\n
\n
File and its mime type.
\n
\n
TypedFile(String, File) - Constructor for class retrofit.mime.TypedFile
\n
\n
Constructs a new typed file.
\n
\n
TypedInput - Interface in retrofit.mime
\n
\n
Binary data with an associated mime type.
\n
\n
TypedOutput - Interface in retrofit.mime
\n
\n
Binary data with an associated mime type.
\n
\n
TypedString - Class in retrofit.mime
\n
 
\n
TypedString(String) - Constructor for class retrofit.mime.TypedString
\n
 
\n
\n\n\n\n

U

\n
\n
unexpectedError(String, Throwable) - Static method in exception retrofit.RetrofitError
\n
 
\n
UrlConnectionClient - Class in retrofit.client
\n
\n
Retrofit client that uses HttpURLConnection for communication.
\n
\n
UrlConnectionClient() - Constructor for class retrofit.client.UrlConnectionClient
\n
 
\n
UrlFetchClient - Class in retrofit.appengine
\n
\n
A Client for Google AppEngine's which uses its URLFetchService.
\n
\n
UrlFetchClient() - Constructor for class retrofit.appengine.UrlFetchClient
\n
 
\n
UrlFetchClient(URLFetchService) - Constructor for class retrofit.appengine.UrlFetchClient
\n
 
\n
\n\n\n\n

V

\n
\n
valueOf(String) - Static method in enum retrofit.RestAdapter.LogLevel
\n
\n
Returns the enum constant of this type with the specified name.
\n
\n
valueOf(String) - Static method in enum retrofit.RetrofitError.Kind
\n
\n
Returns the enum constant of this type with the specified name.
\n
\n
values() - Static method in enum retrofit.RestAdapter.LogLevel
\n
\n
Returns an array containing the constants of this enum type, in\nthe order they are declared.
\n
\n
values() - Static method in enum retrofit.RetrofitError.Kind
\n
\n
Returns an array containing the constants of this enum type, in\nthe order they are declared.
\n
\n
\n\n\n\n

W

\n
\n
writeTo(OutputStream) - Method in class retrofit.mime.FormUrlEncodedTypedOutput
\n
 
\n
writeTo(OutputStream) - Method in class retrofit.mime.MultipartTypedOutput
\n
 
\n
writeTo(OutputStream) - Method in class retrofit.mime.TypedByteArray
\n
 
\n
writeTo(OutputStream) - Method in class retrofit.mime.TypedFile
\n
 
\n
writeTo(OutputStream) - Method in interface retrofit.mime.TypedOutput
\n
\n
Writes these bytes to the given output stream.
\n
\n
\nA B C D E F G H I L M N O P Q R S T U V W 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/index.html", "content": "\n\n\n\n\n\nRetrofit 1.9.0 API\n\n\n\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"overview-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/1.x/retrofit/overview-frame.html", "content": "\n\n\n\n\n\nOverview List (Retrofit 1.9.0 API)\n\n\n\n\n\n
All Classes
\n
\n

Packages

\n\n
\n

 

\n\n\n" }, { "path": "website/public/1.x/retrofit/overview-summary.html", "content": "\n\n\n\n\n\nOverview (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Retrofit 1.9.0 API

\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Packages 
PackageDescription
retrofit\n
Retrofit turns your REST API into a Java interface.
\n
retrofit.android 
retrofit.appengine 
retrofit.client 
retrofit.converter 
retrofit.http\n
Annotations for interface methods to control the HTTP request behavior.
\n
retrofit.mime 
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/overview-tree.html", "content": "\n\n\n\n\n\nClass Hierarchy (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n

Interface Hierarchy

\n\n

Annotation Type Hierarchy

\n\n

Enum Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/package-list", "content": "retrofit\nretrofit.android\nretrofit.appengine\nretrofit.client\nretrofit.converter\nretrofit.http\nretrofit.mime\n" }, { "path": "website/public/1.x/retrofit/retrofit/Callback.html", "content": "\n\n\n\n\n\nCallback (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit
\n

Interface Callback<T>

\n
\n
\n
\n
    \n
  • \n
    \n
    Type Parameters:
    \n
    T - expected response type
    \n
    \n
    \n
    All Known Implementing Classes:
    \n
    ResponseCallback
    \n
    \n
    \n
    \n
    public interface Callback<T>
    \n
    Communicates responses from a server or offline requests. One and only one method will be\n invoked in response to a given request.\n

    \n Callback methods are executed using the RestAdapter callback executor. When none is\n specified, the following defaults are used:\n

      \n
    • Android: Callbacks are executed on the application's main (UI) thread.
      • \n
    • JVM: Callbacks are executed on the background thread which performed the request.
      • \n
    \n
    \n
    See Also:
    \n
    RestAdapter.Builder.setExecutors(java.util.concurrent.Executor, java.util.concurrent.Executor)
    \n
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n\n\n
        \n
      • \n

        success

        \n
        void success(T t,\n             Response response)
        \n
        Successful HTTP response.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        failure

        \n
        void failure(RetrofitError error)
        \n
        Unsuccessful HTTP response due to network failure, non-2XX status code, or unexpected\n exception.
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/Endpoint.html", "content": "\n\n\n\n\n\nEndpoint (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit
\n

Interface Endpoint

\n
\n
\n
\n
    \n
  • \n
    \n
    \n
    public interface Endpoint
    \n
    Represents an API endpoint URL and associated name. Callers should always consult the instance\n for the latest values rather than caching the returned values.
    \n
    \n
    Author:
    \n
    Matt Hickman (mhickman@palantir.com)
    \n
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        getUrl

        \n
        String getUrl()
        \n
        The base API URL.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getName

        \n
        String getName()
        \n
        A name for differentiating between multiple API URLs.
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/Endpoints.html", "content": "\n\n\n\n\n\nEndpoints (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit
\n

Class Endpoints

\n
\n
\n\n
\n
    \n
  • \n
    \n
    \n
    public final class Endpoints\nextends Object
    \n
    Static factory methods for creating Endpoint instances.
    \n
    \n
    Author:
    \n
    Matt Hickman (mhickman@palantir.com)
    \n
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        newFixedEndpoint

        \n
        public static Endpoint newFixedEndpoint(String url)
        \n
        Create a server with the provided URL.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        newFixedEndpoint

        \n
        public static Endpoint newFixedEndpoint(String url,\n                                        String name)
        \n
        Create an endpoint with the provided URL and name.
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/ErrorHandler.html", "content": "\n\n\n\n\n\nErrorHandler (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit
\n

Interface ErrorHandler

\n
\n
\n
\n
    \n
  • \n
    \n
    \n
    public interface ErrorHandler
    \n
    A hook allowing clients to customize response exceptions.
    \n
    \n
    Author:
    \n
    Sam Beran sberan@gmail.com
    \n
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n\n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        handleError

        \n
        Throwable handleError(RetrofitError cause)
        \n
        Return a custom exception to be thrown for a RetrofitError. It is recommended that you\n pass the supplied error as the cause to any new exceptions.\n

        \n If the return exception is checked it must be declared to be thrown on the interface method.\n

        \n Example usage:\n 

        \n class MyErrorHandler implements ErrorHandler {\n   @Override public Throwable handleError(RetrofitError cause) {\n     Response r = cause.getResponse();\n     if (r != null && r.getStatus() == 401) {\n       return new UnauthorizedException(cause);\n     }\n     return cause;\n   }\n }\n
        \n
        \n
        Parameters:
        \n
        cause - the original RetrofitError exception
        \n
        Returns:
        \n
        Throwable an exception which will be thrown from a synchronous interface method or\n passed to an asynchronous error callback. Must not be null.
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/Profiler.RequestInformation.html", "content": "\n\n\n\n\n\nProfiler.RequestInformation (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit
\n

Class Profiler.RequestInformation

\n
\n
\n\n
\n
    \n
  • \n
    \n
    Enclosing interface:
    \n
    Profiler<T>
    \n
    \n
    \n
    \n
    public static final class Profiler.RequestInformation\nextends Object
    \n
    Information about the HTTP request.
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        RequestInformation

        \n
        public RequestInformation(String method,\n                          String baseUrl,\n                          String relativePath,\n                          long contentLength,\n                          String contentType)
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        getMethod

        \n
        public String getMethod()
        \n
        Returns the HTTP method of the originating request.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getBaseUrl

        \n
        public String getBaseUrl()
        \n
        Returns the URL to which the originating request was sent.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getRelativePath

        \n
        public String getRelativePath()
        \n
        Returns the path relative to the base URL to which the originating request was sent.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getContentLength

        \n
        public long getContentLength()
        \n
        Returns the number of bytes in the originating request.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getContentType

        \n
        public String getContentType()
        \n
        Returns the content type header value of the originating request.
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/Profiler.html", "content": "\n\n\n\n\n\nProfiler (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit
\n

Interface Profiler<T>

\n
\n
\n
\n
    \n
  • \n
    \n
    \n
    public interface Profiler<T>
    \n
    A hook allowing clients to log HTTP method times and response status codes.
    \n
    \n
    Author:
    \n
    Eric Burke (eric@squareup.com)
    \n
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        beforeCall

        \n
        T beforeCall()
        \n
        Invoked before an HTTP method call. The object returned by this method will be\n passed to afterCall(retrofit.Profiler.RequestInformation, long, int, T) when the call returns.\n

        \n This method gives implementers the opportunity to include information that may\n change during the server call in afterCall logic.

        \n
        • \n
      \n\n\n\n\n\n
        \n
      • \n

        afterCall

        \n
        void afterCall(Profiler.RequestInformation requestInfo,\n               long elapsedTime,\n               int statusCode,\n               T beforeCallData)
        \n
        Invoked after an HTTP method completes. This is called from the\n RestAdapter's background thread.
        \n
        \n
        Parameters:
        \n
        requestInfo - information about the originating HTTP request.
        \n
        elapsedTime - time in milliseconds it took the HTTP request to complete.
        \n
        statusCode - response status code.
        \n
        beforeCallData - the data returned by the corresponding beforeCall().
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/RequestInterceptor.RequestFacade.html", "content": "\n\n\n\n\n\nRequestInterceptor.RequestFacade (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit
\n

Interface RequestInterceptor.RequestFacade

\n
\n
\n
\n
    \n
  • \n
    \n
    Enclosing interface:
    \n
    RequestInterceptor
    \n
    \n
    \n
    \n
    public static interface RequestInterceptor.RequestFacade
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        addHeader

        \n
        void addHeader(String name,\n               String value)
        \n
        Add a header to the request. This will not replace any existing headers.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        addPathParam

        \n
        void addPathParam(String name,\n                  String value)
        \n
        Add a path parameter replacement. This works exactly like a @Path-annotated method argument.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        addEncodedPathParam

        \n
        void addEncodedPathParam(String name,\n                         String value)
        \n
        Add a path parameter replacement without first URI encoding. This works exactly like a\n @Path-annotated method argument with encode=false.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        addQueryParam

        \n
        void addQueryParam(String name,\n                   String value)
        \n
        Add an additional query parameter. This will not replace any existing query parameters.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        addEncodedQueryParam

        \n
        void addEncodedQueryParam(String name,\n                          String value)
        \n
        Add an additional query parameter without first URI encoding. This will not replace any\n existing query parameters.
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/RequestInterceptor.html", "content": "\n\n\n\n\n\nRequestInterceptor (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n\n
\n
retrofit
\n

Interface RequestInterceptor

\n
\n
\n
\n
    \n
  • \n
    \n
    \n
    public interface RequestInterceptor
    \n
    Intercept every request before it is executed in order to add additional data.
    \n
    • \n
\n
\n
\n\n
\n
\n\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/ResponseCallback.html", "content": "\n\n\n\n\n\nResponseCallback (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit
\n

Class ResponseCallback

\n
\n
\n\n
\n\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        ResponseCallback

        \n
        public ResponseCallback()
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n\n\n\n\n
        \n
      • \n

        success

        \n
        public abstract void success(Response response)
        \n
        Successful HTTP response.
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/RestAdapter.Builder.html", "content": "\n\n\n\n\n\nRestAdapter.Builder (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit
\n

Class RestAdapter.Builder

\n
\n
\n\n
\n\n
\n
\n\n
\n
\n\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/RestAdapter.Log.html", "content": "\n\n\n\n\n\nRestAdapter.Log (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit
\n

Interface RestAdapter.Log

\n
\n
\n
\n
    \n
  • \n
    \n
    All Known Implementing Classes:
    \n
    AndroidLog
    \n
    \n
    \n
    Enclosing class:
    \n
    RestAdapter
    \n
    \n
    \n
    \n
    public static interface RestAdapter.Log
    \n
    Simple logging abstraction for debug messages.
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n\n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        log

        \n
        void log(String message)
        \n
        Log a debug message to the appropriate console.
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/RestAdapter.LogLevel.html", "content": "\n\n\n\n\n\nRestAdapter.LogLevel (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n\n
\n
retrofit
\n

Enum RestAdapter.LogLevel

\n
\n
\n\n
\n\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Enum Constant Detail

      \n\n\n\n\n\n\n\n
        \n
      • \n

        BASIC

        \n
        public static final RestAdapter.LogLevel BASIC
        \n
        Log only the request method and URL and the response status code and execution time.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        HEADERS

        \n
        public static final RestAdapter.LogLevel HEADERS
        \n
        Log the basic information along with request and response headers.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        HEADERS_AND_ARGS

        \n
        public static final RestAdapter.LogLevel HEADERS_AND_ARGS
        \n
        Log the basic information along with request and response objects via toString().
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        FULL

        \n
        public static final RestAdapter.LogLevel FULL
        \n
        Log the headers, body, and metadata for both requests and responses.\n

        \n Note: This requires that the entire request and response body be buffered in memory!

        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        values

        \n
        public static RestAdapter.LogLevel[] values()
        \n
        Returns an array containing the constants of this enum type, in\nthe order they are declared. This method may be used to iterate\nover the constants as follows:\n
        \nfor (RestAdapter.LogLevel c : RestAdapter.LogLevel.values())\n    System.out.println(c);\n
        \n
        \n
        Returns:
        \n
        an array containing the constants of this enum type, in the order they are declared
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        valueOf

        \n
        public static RestAdapter.LogLevel valueOf(String name)
        \n
        Returns the enum constant of this type with the specified name.\nThe string must match exactly an identifier used to declare an\nenum constant in this type. (Extraneous whitespace characters are \nnot permitted.)
        \n
        \n
        Parameters:
        \n
        name - the name of the enum constant to be returned.
        \n
        Returns:
        \n
        the enum constant with the specified name
        \n
        Throws:
        \n
        IllegalArgumentException - if this enum type has no constant with the specified name
        \n
        NullPointerException - if the argument is null
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        log

        \n
        public boolean log()
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/RestAdapter.html", "content": "\n\n\n\n\n\nRestAdapter (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit
\n

Class RestAdapter

\n
\n
\n\n
\n
    \n
  • \n
    \n
    \n
    public class RestAdapter\nextends Object
    \n
    Adapts a Java interface to a REST API.\n

    \n API endpoints are defined as methods on an interface with annotations providing metadata about\n the form in which the HTTP call should be made.\n

    \n The relative path for a given method is obtained from an annotation on the method describing\n the request type. The built-in methods are GET,\n PUT, POST, HEAD,\n and DELETE. You can define your own HTTP method by creating an\n annotation that takes a {code String} value and itself is annotated with\n @RestMethod.\n

    \n Method parameters can be used to replace parts of the URL by annotating them with\n @Path. Replacement sections are denoted by an identifier surrounded\n by curly braces (e.g., \"{foo}\"). To add items to the query string of a URL use\n @Query.\n

    \n HTTP requests happen in one of two ways:\n

      \n
    • On the provided HTTP Executor with callbacks marshaled to the callback\n Executor. The last method parameter should be of type Callback. The HTTP\n response will be converted to the callback's parameter type using the specified\n Converter. If the callback parameter type uses a wildcard,\n the lower bound will be used as the conversion type.\n
    • On the current thread returning the response or throwing a RetrofitError. The HTTP\n response will be converted to the method's return type using the specified\n Converter.\n
    \n

    \n The body of a request is denoted by the @Body annotation. The object\n will be converted to request representation by a call to\n toBody on the supplied\n Converter for this instance. The body can also be a\n TypedOutput where it will be used directly.\n

    \n Alternative request body formats are supported by method annotations and corresponding parameter\n annotations:\n

      \n
    • @FormUrlEncoded - Form-encoded data with key-value\n pairs specified by the @Field parameter annotation.\n
    • @Multipart - RFC 2387-compliant multi-part data with parts\n specified by the @Part parameter annotation.\n
    \n

    \n Additional static headers can be added for an endpoint using the\n @Headers method annotation. For per-request control over a header\n annotate a parameter with @Header.\n

    \n For example:\n 

    \n public interface MyApi {\n   @POST(\"/category/{cat}\") // Asynchronous execution.\n   void categoryList(@Path(\"cat\") String a, @Query(\"page\") int b,\n                     Callback<List<Item>> cb);\n   @POST(\"/category/{cat}\") // Synchronous execution.\n   List<Item> categoryList(@Path(\"cat\") String a, @Query(\"page\") int b);\n }\n
    \n

    \n Calling create(Class) with MyApi.class will validate and create a new\n implementation of the API.

    \n
    \n
    Author:
    \n
    Bob Lee (bob@squareup.com), Jake Wharton (jw@squareup.com)
    \n
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        setLogLevel

        \n
        public void setLogLevel(RestAdapter.LogLevel loglevel)
        \n
        Change the level of logging.
        \n
        • \n
      \n\n\n\n\n\n\n\n
        \n
      • \n

        create

        \n
        public <T> T create(Class<T> service)
        \n
        Create an implementation of the API defined by the specified service interface.
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/RetrofitError.Kind.html", "content": "\n\n\n\n\n\nRetrofitError.Kind (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n\n
\n
retrofit
\n

Enum RetrofitError.Kind

\n
\n
\n\n
\n\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Enum Constant Detail

      \n\n\n\n\n\n\n\n
        \n
      • \n

        CONVERSION

        \n
        public static final RetrofitError.Kind CONVERSION
        \n
        An exception was thrown while (de)serializing a body.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        HTTP

        \n
        public static final RetrofitError.Kind HTTP
        \n
        A non-200 HTTP status code was received from the server.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        UNEXPECTED

        \n
        public static final RetrofitError.Kind UNEXPECTED
        \n
        An internal error occurred while attempting to execute a request. It is best practice to\n re-throw this exception so your application crashes.
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        values

        \n
        public static RetrofitError.Kind[] values()
        \n
        Returns an array containing the constants of this enum type, in\nthe order they are declared. This method may be used to iterate\nover the constants as follows:\n
        \nfor (RetrofitError.Kind c : RetrofitError.Kind.values())\n    System.out.println(c);\n
        \n
        \n
        Returns:
        \n
        an array containing the constants of this enum type, in the order they are declared
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        valueOf

        \n
        public static RetrofitError.Kind valueOf(String name)
        \n
        Returns the enum constant of this type with the specified name.\nThe string must match exactly an identifier used to declare an\nenum constant in this type. (Extraneous whitespace characters are \nnot permitted.)
        \n
        \n
        Parameters:
        \n
        name - the name of the enum constant to be returned.
        \n
        Returns:
        \n
        the enum constant with the specified name
        \n
        Throws:
        \n
        IllegalArgumentException - if this enum type has no constant with the specified name
        \n
        NullPointerException - if the argument is null
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/RetrofitError.html", "content": "\n\n\n\n\n\nRetrofitError (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit
\n

Class RetrofitError

\n
\n
\n\n
\n\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
        \n
      • \n

        getUrl

        \n
        public String getUrl()
        \n
        The request URL which produced the error.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getResponse

        \n
        public Response getResponse()
        \n
        Response object containing status code, headers, body, etc.
        \n
        • \n
      \n\n\n\n\n\n\n\n
        \n
      • \n

        getKind

        \n
        public RetrofitError.Kind getKind()
        \n
        The event kind which triggered this error.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getBody

        \n
        public Object getBody()
        \n
        HTTP response body converted to the type declared by either the interface method return type\n or the generic type of the supplied Callback parameter. null if there is no\n response.
        \n
        \n
        Throws:
        \n
        RuntimeException - if unable to convert the body to the success\n type.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getSuccessType

        \n
        public Type getSuccessType()
        \n
        The type declared by either the interface method return type or the generic type of the\n supplied Callback parameter.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getBodyAs

        \n
        public Object getBodyAs(Type type)
        \n
        HTTP response body converted to specified type. null if there is no response.
        \n
        \n
        Throws:
        \n
        RuntimeException - if unable to convert the body to the specified type.
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/android/AndroidApacheClient.html", "content": "\n\n\n\n\n\nAndroidApacheClient (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.android
\n

Class AndroidApacheClient

\n
\n
\n\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    Client
    \n
    \n
    \n
    \n
    public final class AndroidApacheClient\nextends ApacheClient
    \n
    Provides a Client which uses the Android-specific version of\n HttpClient, AndroidHttpClient.\n

    \n If you need to provide a customized version of the AndroidHttpClient or a different\n HttpClient on Android use ApacheClient directly.

    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        AndroidApacheClient

        \n
        public AndroidApacheClient()
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/android/AndroidLog.html", "content": "\n\n\n\n\n\nAndroidLog (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.android
\n

Class AndroidLog

\n
\n
\n\n
\n\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        AndroidLog

        \n
        public AndroidLog(String tag)
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        log

        \n
        public final void log(String message)
        \n
        Description copied from interface: RestAdapter.Log
        \n
        Log a debug message to the appropriate console.
        \n
        \n
        Specified by:
        \n
        log in interface RestAdapter.Log
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        logChunk

        \n
        public void logChunk(String chunk)
        \n
        Called one or more times for each call to log(String). The length of chunk\n will be no more than 4000 characters to support Android's Log class.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getTag

        \n
        public String getTag()
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/android/MainThreadExecutor.html", "content": "\n\n\n\n\n\nMainThreadExecutor (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.android
\n

Class MainThreadExecutor

\n
\n
\n\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    Executor
    \n
    \n
    \n
    \n
    public final class MainThreadExecutor\nextends Object\nimplements Executor
    \n
    Executor that runs tasks on Android's main thread.
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        MainThreadExecutor

        \n
        public MainThreadExecutor()
        \n
        • \n
      \n
      • \n
    \n\n\n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/android/class-use/AndroidApacheClient.html", "content": "\n\n\n\n\n\nUses of Class retrofit.android.AndroidApacheClient (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.android.AndroidApacheClient

\n
\n
No usage of retrofit.android.AndroidApacheClient
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/android/class-use/AndroidLog.html", "content": "\n\n\n\n\n\nUses of Class retrofit.android.AndroidLog (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.android.AndroidLog

\n
\n
No usage of retrofit.android.AndroidLog
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/android/class-use/MainThreadExecutor.html", "content": "\n\n\n\n\n\nUses of Class retrofit.android.MainThreadExecutor (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.android.MainThreadExecutor

\n
\n
No usage of retrofit.android.MainThreadExecutor
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/android/package-frame.html", "content": "\n\n\n\n\n\nretrofit.android (Retrofit 1.9.0 API)\n\n\n\n\n\n

retrofit.android

\n
\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/android/package-summary.html", "content": "\n\n\n\n\n\nretrofit.android (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Package retrofit.android

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    AndroidApacheClient\n
    Provides a Client which uses the Android-specific version of\n HttpClient, AndroidHttpClient.
    \n
    AndroidLog\n
    A logger for Android.
    \n
    MainThreadExecutor\n
    Executor that runs tasks on Android's main thread.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/android/package-tree.html", "content": "\n\n\n\n\n\nretrofit.android Class Hierarchy (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit.android

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/android/package-use.html", "content": "\n\n\n\n\n\nUses of Package retrofit.android (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Package
retrofit.android

\n
\n
No usage of retrofit.android
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/appengine/UrlFetchClient.html", "content": "\n\n\n\n\n\nUrlFetchClient (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.appengine
\n

Class UrlFetchClient

\n
\n
\n\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    Client
    \n
    \n
    \n
    \n
    public class UrlFetchClient\nextends Object\nimplements Client
    \n
    A Client for Google AppEngine's which uses its URLFetchService.
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        UrlFetchClient

        \n
        public UrlFetchClient()
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        UrlFetchClient

        \n
        public UrlFetchClient(com.google.appengine.api.urlfetch.URLFetchService urlFetchService)
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        execute

        \n
        public Response execute(Request request)\n                 throws IOException
        \n
        Description copied from interface: Client
        \n
        Synchronously execute an HTTP represented by request and encapsulate all response data\n into a Response instance.\n

        \n Note: If the request has a body, its length and mime type will have already been added to the\n header list as Content-Length and Content-Type, respectively. Do NOT alter\n these values as they might have been set as a result of an application-level configuration.

        \n
        \n
        Specified by:
        \n
        execute in interface Client
        \n
        Throws:
        \n
        IOException
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        execute

        \n
        protected com.google.appengine.api.urlfetch.HTTPResponse execute(com.google.appengine.api.urlfetch.URLFetchService urlFetchService,\n                                                                 com.google.appengine.api.urlfetch.HTTPRequest request)\n                                                          throws IOException
        \n
        Execute the specified request using the provided urlFetchService.
        \n
        \n
        Throws:
        \n
        IOException
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/appengine/class-use/UrlFetchClient.html", "content": "\n\n\n\n\n\nUses of Class retrofit.appengine.UrlFetchClient (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.appengine.UrlFetchClient

\n
\n
No usage of retrofit.appengine.UrlFetchClient
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/appengine/package-frame.html", "content": "\n\n\n\n\n\nretrofit.appengine (Retrofit 1.9.0 API)\n\n\n\n\n\n

retrofit.appengine

\n
\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/appengine/package-summary.html", "content": "\n\n\n\n\n\nretrofit.appengine (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Package retrofit.appengine

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    UrlFetchClient\n
    A Client for Google AppEngine's which uses its URLFetchService.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/appengine/package-tree.html", "content": "\n\n\n\n\n\nretrofit.appengine Class Hierarchy (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit.appengine

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/appengine/package-use.html", "content": "\n\n\n\n\n\nUses of Package retrofit.appengine (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Package
retrofit.appengine

\n
\n
No usage of retrofit.appengine
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/class-use/Callback.html", "content": "\n\n\n\n\n\nUses of Interface retrofit.Callback (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Interface
retrofit.Callback

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/class-use/Endpoint.html", "content": "\n\n\n\n\n\nUses of Interface retrofit.Endpoint (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Interface
retrofit.Endpoint

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/class-use/Endpoints.html", "content": "\n\n\n\n\n\nUses of Class retrofit.Endpoints (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.Endpoints

\n
\n
No usage of retrofit.Endpoints
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/class-use/ErrorHandler.html", "content": "\n\n\n\n\n\nUses of Interface retrofit.ErrorHandler (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Interface
retrofit.ErrorHandler

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/class-use/Profiler.RequestInformation.html", "content": "\n\n\n\n\n\nUses of Class retrofit.Profiler.RequestInformation (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.Profiler.RequestInformation

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/class-use/Profiler.html", "content": "\n\n\n\n\n\nUses of Interface retrofit.Profiler (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Interface
retrofit.Profiler

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/class-use/RequestInterceptor.RequestFacade.html", "content": "\n\n\n\n\n\nUses of Interface retrofit.RequestInterceptor.RequestFacade (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Interface
retrofit.RequestInterceptor.RequestFacade

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/class-use/RequestInterceptor.html", "content": "\n\n\n\n\n\nUses of Interface retrofit.RequestInterceptor (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Interface
retrofit.RequestInterceptor

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/class-use/ResponseCallback.html", "content": "\n\n\n\n\n\nUses of Class retrofit.ResponseCallback (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.ResponseCallback

\n
\n
No usage of retrofit.ResponseCallback
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/class-use/RestAdapter.Builder.html", "content": "\n\n\n\n\n\nUses of Class retrofit.RestAdapter.Builder (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.RestAdapter.Builder

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/class-use/RestAdapter.Log.html", "content": "\n\n\n\n\n\nUses of Interface retrofit.RestAdapter.Log (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Interface
retrofit.RestAdapter.Log

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/class-use/RestAdapter.LogLevel.html", "content": "\n\n\n\n\n\nUses of Class retrofit.RestAdapter.LogLevel (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.RestAdapter.LogLevel

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/class-use/RestAdapter.html", "content": "\n\n\n\n\n\nUses of Class retrofit.RestAdapter (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.RestAdapter

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/class-use/RetrofitError.Kind.html", "content": "\n\n\n\n\n\nUses of Class retrofit.RetrofitError.Kind (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.RetrofitError.Kind

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/class-use/RetrofitError.html", "content": "\n\n\n\n\n\nUses of Class retrofit.RetrofitError (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.RetrofitError

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/ApacheClient.html", "content": "\n\n\n\n\n\nApacheClient (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.client
\n

Class ApacheClient

\n
\n
\n\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    Client
    \n
    \n
    \n
    Direct Known Subclasses:
    \n
    AndroidApacheClient
    \n
    \n
    \n
    \n
    public class ApacheClient\nextends Object\nimplements Client
    \n
    A Client which uses an implementation of Apache's HttpClient.
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        ApacheClient

        \n
        public ApacheClient()
        \n
        Creates an instance backed by DefaultHttpClient.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        ApacheClient

        \n
        public ApacheClient(org.apache.http.client.HttpClient client)
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        execute

        \n
        public Response execute(Request request)\n                 throws IOException
        \n
        Description copied from interface: Client
        \n
        Synchronously execute an HTTP represented by request and encapsulate all response data\n into a Response instance.\n

        \n Note: If the request has a body, its length and mime type will have already been added to the\n header list as Content-Length and Content-Type, respectively. Do NOT alter\n these values as they might have been set as a result of an application-level configuration.

        \n
        \n
        Specified by:
        \n
        execute in interface Client
        \n
        Throws:
        \n
        IOException
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        execute

        \n
        protected org.apache.http.HttpResponse execute(org.apache.http.client.HttpClient client,\n                                               org.apache.http.client.methods.HttpUriRequest request)\n                                        throws IOException
        \n
        Execute the specified request using the provided client.
        \n
        \n
        Throws:
        \n
        IOException
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/Client.Provider.html", "content": "\n\n\n\n\n\nClient.Provider (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.client
\n

Interface Client.Provider

\n
\n
\n
\n
    \n
  • \n
    \n
    Enclosing interface:
    \n
    Client
    \n
    \n
    \n
    \n
    public static interface Client.Provider
    \n
    Deferred means of obtaining a Client. For asynchronous requests this will always be\n called on a background thread.
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        get

        \n
        Client get()
        \n
        Obtain an HTTP client. Called once for each request.
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/Client.html", "content": "\n\n\n\n\n\nClient (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.client
\n

Interface Client

\n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Nested Class Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Nested Classes 
      Modifier and TypeInterface and Description
      static interface Client.Provider\n
      Deferred means of obtaining a Client.
      \n
      \n
      • \n
    \n\n\n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        execute

        \n
        Response execute(Request request)\n          throws IOException
        \n
        Synchronously execute an HTTP represented by request and encapsulate all response data\n into a Response instance.\n

        \n Note: If the request has a body, its length and mime type will have already been added to the\n header list as Content-Length and Content-Type, respectively. Do NOT alter\n these values as they might have been set as a result of an application-level configuration.

        \n
        \n
        Throws:
        \n
        IOException
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/Header.html", "content": "\n\n\n\n\n\nHeader (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.client
\n

Class Header

\n
\n
\n\n
\n
    \n
  • \n
    \n
    \n
    public final class Header\nextends Object
    \n
    Represents an HTTP header name/value pair.
    \n
    • \n
\n
\n
\n\n
\n
\n\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/OkClient.html", "content": "\n\n\n\n\n\nOkClient (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.client
\n

Class OkClient

\n
\n
\n\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    Client
    \n
    \n
    \n
    \n
    public class OkClient\nextends Object\nimplements Client
    \n
    Retrofit client that uses OkHttp for communication.
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        OkClient

        \n
        public OkClient()
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        OkClient

        \n
        public OkClient(com.squareup.okhttp.OkHttpClient client)
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        execute

        \n
        public Response execute(Request request)\n                 throws IOException
        \n
        Description copied from interface: Client
        \n
        Synchronously execute an HTTP represented by request and encapsulate all response data\n into a Response instance.\n

        \n Note: If the request has a body, its length and mime type will have already been added to the\n header list as Content-Length and Content-Type, respectively. Do NOT alter\n these values as they might have been set as a result of an application-level configuration.

        \n
        \n
        Specified by:
        \n
        execute in interface Client
        \n
        Throws:
        \n
        IOException
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/Request.html", "content": "\n\n\n\n\n\nRequest (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.client
\n

Class Request

\n
\n
\n\n
\n
    \n
  • \n
    \n
    \n
    public final class Request\nextends Object
    \n
    Encapsulates all of the information necessary to make an HTTP request.
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n\n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        getMethod

        \n
        public String getMethod()
        \n
        HTTP method verb.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getUrl

        \n
        public String getUrl()
        \n
        Target URL.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getHeaders

        \n
        public List<Header> getHeaders()
        \n
        Returns an unmodifiable list of headers, never null.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getBody

        \n
        public TypedOutput getBody()
        \n
        Returns the request body or null.
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/Response.html", "content": "\n\n\n\n\n\nResponse (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.client
\n

Class Response

\n
\n
\n\n
\n
    \n
  • \n
    \n
    \n
    public final class Response\nextends Object
    \n
    An HTTP response.\n

    \n When used directly as a data type for an interface method, the response body is buffered to a\n byte[]. Annotate the method with @Streaming for an\n unbuffered stream from the network.

    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n\n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        getUrl

        \n
        public String getUrl()
        \n
        Request URL.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getStatus

        \n
        public int getStatus()
        \n
        Status line code.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getReason

        \n
        public String getReason()
        \n
        Status line reason phrase.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getHeaders

        \n
        public List<Header> getHeaders()
        \n
        An unmodifiable collection of headers.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getBody

        \n
        public TypedInput getBody()
        \n
        Response body. May be null.
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/UrlConnectionClient.html", "content": "\n\n\n\n\n\nUrlConnectionClient (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.client
\n

Class UrlConnectionClient

\n
\n
\n\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    Client
    \n
    \n
    \n
    \n
    public class UrlConnectionClient\nextends Object\nimplements Client
    \n
    Retrofit client that uses HttpURLConnection for communication.
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        UrlConnectionClient

        \n
        public UrlConnectionClient()
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        execute

        \n
        public Response execute(Request request)\n                 throws IOException
        \n
        Description copied from interface: Client
        \n
        Synchronously execute an HTTP represented by request and encapsulate all response data\n into a Response instance.\n

        \n Note: If the request has a body, its length and mime type will have already been added to the\n header list as Content-Length and Content-Type, respectively. Do NOT alter\n these values as they might have been set as a result of an application-level configuration.

        \n
        \n
        Specified by:
        \n
        execute in interface Client
        \n
        Throws:
        \n
        IOException
        \n
        \n
        • \n
      \n\n\n\n\n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/class-use/ApacheClient.html", "content": "\n\n\n\n\n\nUses of Class retrofit.client.ApacheClient (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.client.ApacheClient

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/class-use/Client.Provider.html", "content": "\n\n\n\n\n\nUses of Interface retrofit.client.Client.Provider (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Interface
retrofit.client.Client.Provider

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/class-use/Client.html", "content": "\n\n\n\n\n\nUses of Interface retrofit.client.Client (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Interface
retrofit.client.Client

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/class-use/Header.html", "content": "\n\n\n\n\n\nUses of Class retrofit.client.Header (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.client.Header

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/class-use/OkClient.html", "content": "\n\n\n\n\n\nUses of Class retrofit.client.OkClient (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.client.OkClient

\n
\n
No usage of retrofit.client.OkClient
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/class-use/Request.html", "content": "\n\n\n\n\n\nUses of Class retrofit.client.Request (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.client.Request

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/class-use/Response.html", "content": "\n\n\n\n\n\nUses of Class retrofit.client.Response (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.client.Response

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/class-use/UrlConnectionClient.html", "content": "\n\n\n\n\n\nUses of Class retrofit.client.UrlConnectionClient (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.client.UrlConnectionClient

\n
\n
No usage of retrofit.client.UrlConnectionClient
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/package-frame.html", "content": "\n\n\n\n\n\nretrofit.client (Retrofit 1.9.0 API)\n\n\n\n\n\n

retrofit.client

\n
\n

Interfaces

\n\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/package-summary.html", "content": "\n\n\n\n\n\nretrofit.client (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Package retrofit.client

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    Interface Summary 
    InterfaceDescription
    Client\n
    Abstraction of an HTTP client which can execute Requests.
    \n
    Client.Provider\n
    Deferred means of obtaining a Client.
    \n
    \n
    • \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    ApacheClient\n
    A Client which uses an implementation of Apache's HttpClient.
    \n
    Header\n
    Represents an HTTP header name/value pair.
    \n
    OkClient\n
    Retrofit client that uses OkHttp for communication.
    \n
    Request\n
    Encapsulates all of the information necessary to make an HTTP request.
    \n
    Response\n
    An HTTP response.
    \n
    UrlConnectionClient\n
    Retrofit client that uses HttpURLConnection for communication.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/package-tree.html", "content": "\n\n\n\n\n\nretrofit.client Class Hierarchy (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit.client

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n

Interface Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/client/package-use.html", "content": "\n\n\n\n\n\nUses of Package retrofit.client (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Package
retrofit.client

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/converter/ConversionException.html", "content": "\n\n\n\n\n\nConversionException (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.converter
\n

Class ConversionException

\n
\n
\n\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    Serializable
    \n
    \n
    \n
    \n
    public class ConversionException\nextends Exception
    \n
    Indicate that conversion was unable to complete successfully.
    \n
    \n
    See Also:
    \n
    Serialized Form
    \n
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        ConversionException

        \n
        public ConversionException(String message)
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        ConversionException

        \n
        public ConversionException(String message,\n                           Throwable throwable)
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        ConversionException

        \n
        public ConversionException(Throwable throwable)
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/converter/Converter.html", "content": "\n\n\n\n\n\nConverter (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.converter
\n

Interface Converter

\n
\n
\n
\n
    \n
  • \n
    \n
    All Known Implementing Classes:
    \n
    GsonConverter
    \n
    \n
    \n
    \n
    public interface Converter
    \n
    Arbiter for converting objects to and from their representation in HTTP.
    \n
    \n
    Author:
    \n
    Jake Wharton (jw@squareup.com)
    \n
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        fromBody

        \n
        Object fromBody(TypedInput body,\n                Type type)\n         throws ConversionException
        \n
        Convert an HTTP response body to a concrete object of the specified type.
        \n
        \n
        Parameters:
        \n
        body - HTTP response body.
        \n
        type - Target object type.
        \n
        Returns:
        \n
        Instance of type which will be cast by the caller.
        \n
        Throws:
        \n
        ConversionException - if conversion was unable to complete. This will trigger a call to\n Callback.failure(retrofit.RetrofitError) or throw a\n RetrofitError. The exception message should report all necessary information\n about its cause as the response body will be set to null.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        toBody

        \n
        TypedOutput toBody(Object object)
        \n
        Convert an object to an appropriate representation for HTTP transport.
        \n
        \n
        Parameters:
        \n
        object - Object instance to convert.
        \n
        Returns:
        \n
        Representation of the specified object as bytes.
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/converter/GsonConverter.html", "content": "\n\n\n\n\n\nGsonConverter (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.converter
\n

Class GsonConverter

\n
\n
\n\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    Converter
    \n
    \n
    \n
    \n
    public class GsonConverter\nextends Object\nimplements Converter
    \n
    A Converter which uses GSON for serialization and deserialization of entities.
    \n
    \n
    Author:
    \n
    Jake Wharton (jw@squareup.com)
    \n
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        GsonConverter

        \n
        public GsonConverter(com.google.gson.Gson gson)
        \n
        Create an instance using the supplied Gson object for conversion. Encoding to JSON and\n decoding from JSON (when no charset is specified by a header) will use UTF-8.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        GsonConverter

        \n
        public GsonConverter(com.google.gson.Gson gson,\n                     String charset)
        \n
        Create an instance using the supplied Gson object for conversion. Encoding to JSON and\n decoding from JSON (when no charset is specified by a header) will use the specified charset.
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        fromBody

        \n
        public Object fromBody(TypedInput body,\n                       Type type)\n                throws ConversionException
        \n
        Description copied from interface: Converter
        \n
        Convert an HTTP response body to a concrete object of the specified type.
        \n
        \n
        Specified by:
        \n
        fromBody in interface Converter
        \n
        Parameters:
        \n
        body - HTTP response body.
        \n
        type - Target object type.
        \n
        Returns:
        \n
        Instance of type which will be cast by the caller.
        \n
        Throws:
        \n
        ConversionException - if conversion was unable to complete. This will trigger a call to\n Callback.failure(retrofit.RetrofitError) or throw a\n RetrofitError. The exception message should report all necessary information\n about its cause as the response body will be set to null.
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        toBody

        \n
        public TypedOutput toBody(Object object)
        \n
        Description copied from interface: Converter
        \n
        Convert an object to an appropriate representation for HTTP transport.
        \n
        \n
        Specified by:
        \n
        toBody in interface Converter
        \n
        Parameters:
        \n
        object - Object instance to convert.
        \n
        Returns:
        \n
        Representation of the specified object as bytes.
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/converter/class-use/ConversionException.html", "content": "\n\n\n\n\n\nUses of Class retrofit.converter.ConversionException (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.converter.ConversionException

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/converter/class-use/Converter.html", "content": "\n\n\n\n\n\nUses of Interface retrofit.converter.Converter (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Interface
retrofit.converter.Converter

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/converter/class-use/GsonConverter.html", "content": "\n\n\n\n\n\nUses of Class retrofit.converter.GsonConverter (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.converter.GsonConverter

\n
\n
No usage of retrofit.converter.GsonConverter
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/converter/package-frame.html", "content": "\n\n\n\n\n\nretrofit.converter (Retrofit 1.9.0 API)\n\n\n\n\n\n

retrofit.converter

\n
\n

Interfaces

\n\n

Classes

\n\n

Exceptions

\n\n
\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/converter/package-summary.html", "content": "\n\n\n\n\n\nretrofit.converter (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Package retrofit.converter

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Interface Summary 
    InterfaceDescription
    Converter\n
    Arbiter for converting objects to and from their representation in HTTP.
    \n
    \n
    • \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    GsonConverter\n
    A Converter which uses GSON for serialization and deserialization of entities.
    \n
    \n
    • \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Exception Summary 
    ExceptionDescription
    ConversionException\n
    Indicate that conversion was unable to complete successfully.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/converter/package-tree.html", "content": "\n\n\n\n\n\nretrofit.converter Class Hierarchy (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit.converter

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n

Interface Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/converter/package-use.html", "content": "\n\n\n\n\n\nUses of Package retrofit.converter (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Package
retrofit.converter

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/Body.html", "content": "\n\n\n\n\n\nBody (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Element
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type Body

\n
\n
\n
\n
    \n
  • \n
    \n
    \n
    @Documented\n @Target(value=PARAMETER)\n @Retention(value=RUNTIME)\npublic @interface Body
    \n
    Use this annotation on a service method param when you want to directly control the request body\n of a POST/PUT request (instead of sending in as request parameters or form-style request\n body). If the value of the parameter implements TypedOutput,\n the request body will be written exactly as specified by\n TypedOutput.writeTo(java.io.OutputStream). If the value does not implement\n TypedOutput, the object will be serialized using the RestAdapter's\n Converter and the result will be set directly as the\n request body.\n

    \n Body parameters may not be null.

    \n
    \n
    Author:
    \n
    Eric Denman (edenman@squareup.com)
    \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Element
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/DELETE.html", "content": "\n\n\n\n\n\nDELETE (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type DELETE

\n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Required Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Required Elements 
      Modifier and TypeRequired Element and Description
      Stringvalue 
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        value

        \n
        public abstract String value
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/EncodedPath.html", "content": "\n\n\n\n\n\nEncodedPath (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type EncodedPath

\n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Required Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Required Elements 
      Modifier and TypeRequired Element and Description
      Stringvalue\n
      Deprecated. 
      \n 
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        value

        \n
        public abstract String value
        \n
        Deprecated. 
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/EncodedQuery.html", "content": "\n\n\n\n\n\nEncodedQuery (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type EncodedQuery

\n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Required Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Required Elements 
      Modifier and TypeRequired Element and Description
      Stringvalue\n
      Deprecated. 
      \n 
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        value

        \n
        public abstract String value
        \n
        Deprecated. 
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/EncodedQueryMap.html", "content": "\n\n\n\n\n\nEncodedQueryMap (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Element
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type EncodedQueryMap

\n
\n
\n
\n\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Element
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/Field.html", "content": "\n\n\n\n\n\nField (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type Field

\n
\n
\n
\n
    \n
  • \n
    \n
    \n
    @Documented\n @Target(value=PARAMETER)\n @Retention(value=RUNTIME)\npublic @interface Field
    \n
    Named pair for a form-encoded request.\n

    \n Values are converted to strings using String.valueOf(Object) and then form URL encoded.\n null values are ignored. Passing a List or array will result in a\n field pair for each non-null item.\n

    \n Simple Example:\n 

    \n @FormUrlEncoded\n @POST(\"/\")\n void example(@Field(\"name\") String name, @Field(\"occupation\") String occupation);\n }\n
    \n Calling with foo.example(\"Bob Smith\", \"President\") yields a request body of\n name=Bob+Smith&occupation=President.\n

    \n Array Example:\n 

    \n @FormUrlEncoded\n @POST(\"/list\")\n void example(@Field(\"name\") String... names);\n
    \n Calling with foo.example(\"Bob Smith\", \"Jane Doe\") yields a request body of\n name=Bob+Smith&name=Jane+Doe.
    \n
    \n
    See Also:
    \n
    FormUrlEncoded, \nFieldMap
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Required Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Required Elements 
      Modifier and TypeRequired Element and Description
      Stringvalue 
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Optional Element Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      Optional Elements 
      Modifier and TypeOptional Element and Description
      booleanencodeName\n
      Specifies whether value() is URL encoded.
      \n
      booleanencodeValue\n
      Specifies whether the argument value to the annotated method parameter is URL encoded.
      \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        value

        \n
        public abstract String value
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n
        \n
      • \n

        encodeName

        \n
        public abstract boolean encodeName
        \n
        Specifies whether value() is URL encoded.
        \n
        \n
        Default:
        \n
        true
        \n
        \n
        • \n
      \n
      • \n
    \n
      \n
    • \n\n\n
        \n
      • \n

        encodeValue

        \n
        public abstract boolean encodeValue
        \n
        Specifies whether the argument value to the annotated method parameter is URL encoded.
        \n
        \n
        Default:
        \n
        true
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/FieldMap.html", "content": "\n\n\n\n\n\nFieldMap (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type FieldMap

\n
\n
\n
\n
    \n
  • \n
    \n
    \n
    @Documented\n @Target(value=PARAMETER)\n @Retention(value=RUNTIME)\npublic @interface FieldMap
    \n
    Named key/value pairs for a form-encoded request.\n

    \n Field values may be null which will omit them from the request body.\n

    \n Simple Example:\n 

    \n @FormUrlEncoded\n @POST(\"/things\")\n void things(@FieldMap Map<String, String> fields);\n }\n
    \n Calling with foo.things(ImmutableMap.of(\"foo\", \"bar\", \"kit\", \"kat\") yields a request\n body of foo=bar&kit=kat.
    \n
    \n
    See Also:
    \n
    FormUrlEncoded, \nField
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Optional Element Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      Optional Elements 
      Modifier and TypeOptional Element and Description
      booleanencodeNames\n
      Specifies whether parameter names (keys in the map) are URL encoded.
      \n
      booleanencodeValues\n
      Specifies whether parameter values (values in the map) are URL encoded.
      \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        encodeNames

        \n
        public abstract boolean encodeNames
        \n
        Specifies whether parameter names (keys in the map) are URL encoded.
        \n
        \n
        Default:
        \n
        true
        \n
        \n
        • \n
      \n
      • \n
    \n
      \n
    • \n\n\n
        \n
      • \n

        encodeValues

        \n
        public abstract boolean encodeValues
        \n
        Specifies whether parameter values (values in the map) are URL encoded.
        \n
        \n
        Default:
        \n
        true
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/FormUrlEncoded.html", "content": "\n\n\n\n\n\nFormUrlEncoded (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Element
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type FormUrlEncoded

\n
\n
\n
\n
    \n
  • \n
    \n
    \n
    @Documented\n @Target(value=METHOD)\n @Retention(value=RUNTIME)\npublic @interface FormUrlEncoded
    \n
    Denotes that the request body will use form URL encoding. Fields should be declared as\n parameters and annotated with @Field.\n

    \n Requests made with this annotation will have application/x-www-form-urlencoded MIME\n type. Field names and values will be UTF-8 encoded before being URI-encoded in accordance to\n RFC-3986.

    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Element
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/GET.html", "content": "\n\n\n\n\n\nGET (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type GET

\n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Required Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Required Elements 
      Modifier and TypeRequired Element and Description
      Stringvalue 
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        value

        \n
        public abstract String value
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/HEAD.html", "content": "\n\n\n\n\n\nHEAD (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type HEAD

\n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Required Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Required Elements 
      Modifier and TypeRequired Element and Description
      Stringvalue 
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        value

        \n
        public abstract String value
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/Header.html", "content": "\n\n\n\n\n\nHeader (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type Header

\n
\n
\n
\n
    \n
  • \n
    \n
    \n
    @Documented\n @Retention(value=RUNTIME)\n @Target(value=PARAMETER)\npublic @interface Header
    \n
    Replaces the header with the value of its target.\n

    \n 

    \n @GET(\"/\")\n void foo(@Header(\"Accept-Language\") String lang, Callback<Response> cb);\n
    \n

    \n Header parameters may be null which will omit them from the request. Passing a\n List or array will result in a header for each non-null item.\n

    \n Note: Headers do not overwrite each other. All headers with the same name will\n be included in the request.

    \n
    \n
    Author:
    \n
    Adrian Cole (adrianc@netflix.com)
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Required Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Required Elements 
      Modifier and TypeRequired Element and Description
      Stringvalue 
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        value

        \n
        public abstract String value
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/Headers.html", "content": "\n\n\n\n\n\nHeaders (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type Headers

\n
\n
\n
\n
    \n
  • \n
    \n
    \n
    @Documented\n @Target(value=METHOD)\n @Retention(value=RUNTIME)\npublic @interface Headers
    \n
    Adds headers literally supplied in the value.\n

    \n 

    \n @Headers(\"Cache-Control: max-age=640000\")\n @GET(\"/\")\n ...\n\n @Headers({\n   \"X-Foo: Bar\",\n   \"X-Ping: Pong\"\n })\n @GET(\"/\")\n ...\n
    \n

    \n Note: Headers do not overwrite each other. All headers with the same name will\n be included in the request.

    \n
    \n
    Author:
    \n
    Adrian Cole (adrianc@netflix.com)
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Required Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Required Elements 
      Modifier and TypeRequired Element and Description
      String[]value 
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        value

        \n
        public abstract String[] value
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/Multipart.html", "content": "\n\n\n\n\n\nMultipart (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Element
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type Multipart

\n
\n
\n
\n\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Element
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/PATCH.html", "content": "\n\n\n\n\n\nPATCH (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type PATCH

\n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Required Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Required Elements 
      Modifier and TypeRequired Element and Description
      Stringvalue 
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        value

        \n
        public abstract String value
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/POST.html", "content": "\n\n\n\n\n\nPOST (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type POST

\n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Required Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Required Elements 
      Modifier and TypeRequired Element and Description
      Stringvalue 
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        value

        \n
        public abstract String value
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/PUT.html", "content": "\n\n\n\n\n\nPUT (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type PUT

\n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Required Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Required Elements 
      Modifier and TypeRequired Element and Description
      Stringvalue 
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        value

        \n
        public abstract String value
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/Part.html", "content": "\n\n\n\n\n\nPart (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type Part

\n
\n
\n
\n
    \n
  • \n
    \n
    \n
    @Documented\n @Target(value=PARAMETER)\n @Retention(value=RUNTIME)\npublic @interface Part
    \n
    Denotes a single part of a multi-part request.\n

    \n The parameter type on which this annotation exists will be processed in one of three ways:\n

      \n
    • If the type implements TypedOutput the headers and\n body will be used directly.
      • \n
    • If the type is String the value will also be used directly with a text/plain\n content type.
      • \n
    • Other object types will be converted to an appropriate representation by calling Converter.toBody(Object).
      • \n
    \n

    \n Values may be null which will omit them from the request body.\n

    \n 

    \n @Multipart\n @POST(\"/\")\n void example(@Part(\"description\") String description,\n              @Part(\"image\") TypedFile image,\n              ...\n );\n
    \n

    \n Part parameters may not be null.

    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Required Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Required Elements 
      Modifier and TypeRequired Element and Description
      Stringvalue 
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Optional Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Optional Elements 
      Modifier and TypeOptional Element and Description
      Stringencoding\n
      The Content-Transfer-Encoding of this part.
      \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        value

        \n
        public abstract String value
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n
        \n
      • \n

        encoding

        \n
        public abstract String encoding
        \n
        The Content-Transfer-Encoding of this part.
        \n
        \n
        Default:
        \n
        \"binary\"
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/PartMap.html", "content": "\n\n\n\n\n\nPartMap (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type PartMap

\n
\n
\n
\n
    \n
  • \n
    \n
    \n
    @Documented\n @Target(value=PARAMETER)\n @Retention(value=RUNTIME)\npublic @interface PartMap
    \n
    Denotes name and value parts of a multi-part request\n

    \n Values of the map on which this annotation exists will be processed in one of three ways:\n

      \n
    • If the type implements TypedOutput the headers and\n body will be used directly.
      • \n
    • If the type is String the value will also be used directly with a text/plain\n content type.
      • \n
    • Other object types will be converted to an appropriate representation by calling Converter.toBody(Object).
      • \n
    \n

    \n 

    \n @Multipart\n @POST(\"/upload\")\n void upload(@Part(\"file\") TypedFile file, @PartMap Map<String, String> params);\n
    \n

    \n
    \n
    See Also:
    \n
    Multipart, \nPart
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Optional Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Optional Elements 
      Modifier and TypeOptional Element and Description
      Stringencoding\n
      The Content-Transfer-Encoding of this part.
      \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        encoding

        \n
        public abstract String encoding
        \n
        The Content-Transfer-Encoding of this part.
        \n
        \n
        Default:
        \n
        \"binary\"
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/Path.html", "content": "\n\n\n\n\n\nPath (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type Path

\n
\n
\n
\n
    \n
  • \n
    \n
    \n
    @Documented\n @Retention(value=RUNTIME)\n @Target(value=PARAMETER)\npublic @interface Path
    \n
    Named replacement in the URL path. Values are converted to string using\n String.valueOf(Object) and URL encoded.\n

    \n Simple example:\n 

    \n @GET(\"/image/{id}\")\n void example(@Path(\"id\") int id);\n
    \n Calling with foo.example(1) yields /image/1.\n

    \n Values are URL encoded by default. Disable with encode=false.\n 

    \n @GET(\"/user/{name}\")\n void encoded(@Path(\"name\") String name);\n\n @GET(\"/user/{name}\")\n void notEncoded(@Path(value=\"name\", encode=false) String name);\n
    \n Calling foo.encoded(\"John+Doe\") yields /user/John%2BDoe whereas\n foo.notEncoded(\"John+Doe\") yields /user/John+Doe.\n

    \n Path parameters may not be null.

    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Required Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Required Elements 
      Modifier and TypeRequired Element and Description
      Stringvalue 
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Optional Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Optional Elements 
      Modifier and TypeOptional Element and Description
      booleanencode\n
      Specifies whether the argument value to the annotated method parameter is URL encoded.
      \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        value

        \n
        public abstract String value
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n
        \n
      • \n

        encode

        \n
        public abstract boolean encode
        \n
        Specifies whether the argument value to the annotated method parameter is URL encoded.
        \n
        \n
        Default:
        \n
        true
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/Query.html", "content": "\n\n\n\n\n\nQuery (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type Query

\n
\n
\n
\n
    \n
  • \n
    \n
    \n
    @Documented\n @Target(value=PARAMETER)\n @Retention(value=RUNTIME)\npublic @interface Query
    \n
    Query parameter appended to the URL.\n

    \n Values are converted to strings using String.valueOf(Object) and then URL encoded.\n null values are ignored. Passing a List or array will result in a\n query parameter for each non-null item.\n

    \n Simple Example:\n 

    \n @GET(\"/list\")\n void list(@Query(\"page\") int page);\n
    \n Calling with foo.list(1) yields /list?page=1.\n

    \n Example with null:\n 

    \n @GET(\"/list\")\n void list(@Query(\"category\") String category);\n
    \n Calling with foo.list(null) yields /list.\n

    \n Array Example:\n 

    \n @GET(\"/list\")\n void list(@Query(\"category\") String... categories);\n
    \n Calling with foo.list(\"bar\", \"baz\") yields\n /list?category=foo&category=bar.\n

    \n Parameter names are not URL encoded. Specify encodeName=true to change\n this behavior.\n 

    \n @GET(\"/search\")\n void list(@Query(value=\"foo+bar\", encodeName=true) String foobar);\n
    \n Calling with foo.list(\"baz\") yields /search?foo%2Bbar=foo.\n

    \n Parameter values are URL encoded by default. Specify encodeValue=false to\n change this behavior.\n 

    \n @GET(\"/search\")\n void list(@Query(value=\"foo\", encodeValue=false) String foo);\n
    \n Calling with foo.list(\"foo+foo\")) yields /search?foo=foo+bar.
    \n
    \n
    See Also:
    \n
    QueryMap
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Required Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Required Elements 
      Modifier and TypeRequired Element and Description
      Stringvalue\n
      The query parameter name.
      \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Optional Element Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      Optional Elements 
      Modifier and TypeOptional Element and Description
      booleanencodeName\n
      Specifies whether value() is URL encoded.
      \n
      booleanencodeValue\n
      Specifies whether the argument value to the annotated method parameter is URL encoded.
      \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        value

        \n
        public abstract String value
        \n
        The query parameter name.
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n
        \n
      • \n

        encodeName

        \n
        public abstract boolean encodeName
        \n
        Specifies whether value() is URL encoded.
        \n
        \n
        Default:
        \n
        false
        \n
        \n
        • \n
      \n
      • \n
    \n
      \n
    • \n\n\n
        \n
      • \n

        encodeValue

        \n
        public abstract boolean encodeValue
        \n
        Specifies whether the argument value to the annotated method parameter is URL encoded.
        \n
        \n
        Default:
        \n
        true
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/QueryMap.html", "content": "\n\n\n\n\n\nQueryMap (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type QueryMap

\n
\n
\n
\n
    \n
  • \n
    \n
    \n
    @Documented\n @Target(value=PARAMETER)\n @Retention(value=RUNTIME)\npublic @interface QueryMap
    \n
    Query parameter keys and values appended to the URL.\n

    \n Both keys and values are converted to strings using String.valueOf(Object). Values are\n URL encoded and null will not include the query parameter in the URL. null keys\n are not allowed.\n

    \n Simple Example:\n 

    \n @GET(\"/search\")\n void list(@QueryMap Map<String, String> filters);\n
    \n Calling with foo.list(ImmutableMap.of(\"foo\", \"bar\", \"kit\", \"kat\")) yields\n /search?foo=bar&kit=kat.\n

    \n Map keys representing the parameter names are not URL encoded. Specify\n encodeNames=true to change this behavior.\n 

    \n @GET(\"/search\")\n void list(@QueryMap(encodeNames=true) Map<String, String> filters);\n
    \n Calling with foo.list(ImmutableMap.of(\"foo+bar\", \"foo+bar\")) yields\n /search?foo%2Bbar=foo.\n

    \n Map values representing parameter values are URL encoded by default. Specify\n encodeValues=false to change this behavior.\n 

    \n @GET(\"/search\")\n void list(@QueryMap(encodeValues=false) Map<String, String> filters);\n
    \n Calling with foo.list(ImmutableMap.of(\"foo\", \"foo+foo\")) yields\n /search?foo=foo%2Bbar.
    \n
    \n
    See Also:
    \n
    Query
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Optional Element Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      Optional Elements 
      Modifier and TypeOptional Element and Description
      booleanencodeNames\n
      Specifies whether parameter names (keys in the map) are URL encoded.
      \n
      booleanencodeValues\n
      Specifies whether parameter values (values in the map) are URL encoded.
      \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        encodeNames

        \n
        public abstract boolean encodeNames
        \n
        Specifies whether parameter names (keys in the map) are URL encoded.
        \n
        \n
        Default:
        \n
        false
        \n
        \n
        • \n
      \n
      • \n
    \n
      \n
    • \n\n\n
        \n
      • \n

        encodeValues

        \n
        public abstract boolean encodeValues
        \n
        Specifies whether parameter values (values in the map) are URL encoded.
        \n
        \n
        Default:
        \n
        true
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/RestMethod.html", "content": "\n\n\n\n\n\nRestMethod (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type RestMethod

\n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Required Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Required Elements 
      Modifier and TypeRequired Element and Description
      Stringvalue 
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Optional Element Summary

      \n\n\n\n\n\n\n\n\n\n\n
      Optional Elements 
      Modifier and TypeOptional Element and Description
      booleanhasBody 
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Element Detail

      \n\n\n\n
        \n
      • \n

        value

        \n
        public abstract String value
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n
        \n
      • \n

        hasBody

        \n
        public abstract boolean hasBody
        \n
        \n
        Default:
        \n
        false
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/Streaming.html", "content": "\n\n\n\n\n\nStreaming (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Element
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.http
\n

Annotation Type Streaming

\n
\n
\n
\n\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Field | 
    • \n
  • Required | 
    • \n
  • Optional
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Element
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/Body.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.Body (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.Body

\n
\n
No usage of retrofit.http.Body
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/DELETE.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.DELETE (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.DELETE

\n
\n
No usage of retrofit.http.DELETE
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/EncodedPath.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.EncodedPath (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.EncodedPath

\n
\n
No usage of retrofit.http.EncodedPath
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/EncodedQuery.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.EncodedQuery (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.EncodedQuery

\n
\n
No usage of retrofit.http.EncodedQuery
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/EncodedQueryMap.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.EncodedQueryMap (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.EncodedQueryMap

\n
\n
No usage of retrofit.http.EncodedQueryMap
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/Field.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.Field (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.Field

\n
\n
No usage of retrofit.http.Field
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/FieldMap.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.FieldMap (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.FieldMap

\n
\n
No usage of retrofit.http.FieldMap
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/FormUrlEncoded.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.FormUrlEncoded (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.FormUrlEncoded

\n
\n
No usage of retrofit.http.FormUrlEncoded
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/GET.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.GET (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.GET

\n
\n
No usage of retrofit.http.GET
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/HEAD.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.HEAD (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.HEAD

\n
\n
No usage of retrofit.http.HEAD
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/Header.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.Header (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.Header

\n
\n
No usage of retrofit.http.Header
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/Headers.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.Headers (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.Headers

\n
\n
No usage of retrofit.http.Headers
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/Multipart.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.Multipart (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.Multipart

\n
\n
No usage of retrofit.http.Multipart
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/PATCH.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.PATCH (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.PATCH

\n
\n
No usage of retrofit.http.PATCH
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/POST.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.POST (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.POST

\n
\n
No usage of retrofit.http.POST
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/PUT.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.PUT (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.PUT

\n
\n
No usage of retrofit.http.PUT
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/Part.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.Part (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.Part

\n
\n
No usage of retrofit.http.Part
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/PartMap.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.PartMap (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.PartMap

\n
\n
No usage of retrofit.http.PartMap
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/Path.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.Path (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.Path

\n
\n
No usage of retrofit.http.Path
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/Query.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.Query (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.Query

\n
\n
No usage of retrofit.http.Query
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/QueryMap.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.QueryMap (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.QueryMap

\n
\n
No usage of retrofit.http.QueryMap
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/RestMethod.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.RestMethod (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.RestMethod

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Packages that use RestMethod 
    PackageDescription
    retrofit.http\n
    Annotations for interface methods to control the HTTP request behavior.
    \n
    \n
    • \n
  • \n
      \n
    • \n\n\n

      Uses of RestMethod in retrofit.http

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      Classes in retrofit.http with annotations of type RestMethod 
      Modifier and TypeClass and Description
      interface DELETE\n
      Make a DELETE request to a REST path relative to base URL.
      \n
      interface GET\n
      Make a GET request to a REST path relative to base URL.
      \n
      interface HEAD\n
      Make a HEAD request to a REST path relative to base URL.
      \n
      interface PATCH\n
      Make a PATCH request to a REST path relative to base URL.
      \n
      interface POST\n
      Make a POST request to a REST path relative to base URL.
      \n
      interface PUT\n
      Make a PUT request to a REST path relative to base URL.
      \n
      \n
      • \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/class-use/Streaming.html", "content": "\n\n\n\n\n\nUses of Class retrofit.http.Streaming (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.http.Streaming

\n
\n
No usage of retrofit.http.Streaming
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/package-frame.html", "content": "\n\n\n\n\n\nretrofit.http (Retrofit 1.9.0 API)\n\n\n\n\n\n

retrofit.http

\n
\n

Annotation Types

\n\n
\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/package-summary.html", "content": "\n\n\n\n\n\nretrofit.http (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Package retrofit.http

\n
\n
Annotations for interface methods to control the HTTP request behavior.
\n
\n

See: Description

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    Annotation Types Summary 
    Annotation TypeDescription
    Body\n
    Use this annotation on a service method param when you want to directly control the request body\n of a POST/PUT request (instead of sending in as request parameters or form-style request\n body).
    \n
    DELETE\n
    Make a DELETE request to a REST path relative to base URL.
    \n
    EncodedPathDeprecated\n
    Use Path with encode = false.
    \n
    EncodedQueryDeprecated\n
    Use Query with encodeValue = false.
    \n
    EncodedQueryMapDeprecated\n
    Use QueryMap with encodeValues = false.
    \n
    Field\n
    Named pair for a form-encoded request.
    \n
    FieldMap\n
    Named key/value pairs for a form-encoded request.
    \n
    FormUrlEncoded\n
    Denotes that the request body will use form URL encoding.
    \n
    GET\n
    Make a GET request to a REST path relative to base URL.
    \n
    HEAD\n
    Make a HEAD request to a REST path relative to base URL.
    \n
    Header\n
    Replaces the header with the value of its target.
    \n
    Headers\n
    Adds headers literally supplied in the value.
    \n
    Multipart\n
    Denotes that the request body is multi-part.
    \n
    Part\n
    Denotes a single part of a multi-part request.
    \n
    PartMap\n
    Denotes name and value parts of a multi-part request
    \n
    PATCH\n
    Make a PATCH request to a REST path relative to base URL.
    \n
    Path\n
    Named replacement in the URL path.
    \n
    POST\n
    Make a POST request to a REST path relative to base URL.
    \n
    PUT\n
    Make a PUT request to a REST path relative to base URL.
    \n
    Query\n
    Query parameter appended to the URL.
    \n
    QueryMap\n
    Query parameter keys and values appended to the URL.
    \n
    RestMethod 
    Streaming\n
    Treat the response body on methods returning Response as is,\n i.e.
    \n
    \n
    • \n
\n\n\n\n

Package retrofit.http Description

\n
Annotations for interface methods to control the HTTP request behavior.
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/package-tree.html", "content": "\n\n\n\n\n\nretrofit.http Class Hierarchy (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit.http

\nPackage Hierarchies:\n\n
\n
\n

Annotation Type Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/http/package-use.html", "content": "\n\n\n\n\n\nUses of Package retrofit.http (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Package
retrofit.http

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/FormUrlEncodedTypedOutput.html", "content": "\n\n\n\n\n\nFormUrlEncodedTypedOutput (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.mime
\n

Class FormUrlEncodedTypedOutput

\n
\n
\n\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    TypedOutput
    \n
    \n
    \n
    \n
    public final class FormUrlEncodedTypedOutput\nextends Object\nimplements TypedOutput
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        FormUrlEncodedTypedOutput

        \n
        public FormUrlEncodedTypedOutput()
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        addField

        \n
        public void addField(String name,\n                     String value)
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        addField

        \n
        public void addField(String name,\n                     boolean encodeName,\n                     String value,\n                     boolean encodeValue)
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        fileName

        \n
        public String fileName()
        \n
        Description copied from interface: TypedOutput
        \n
        Original filename.\n\n Used only for multipart requests, may be null.
        \n
        \n
        Specified by:
        \n
        fileName in interface TypedOutput
        \n
        \n
        • \n
      \n\n\n\n\n\n\n\n
        \n
      • \n

        length

        \n
        public long length()
        \n
        Description copied from interface: TypedOutput
        \n
        Length in bytes or -1 if unknown.
        \n
        \n
        Specified by:
        \n
        length in interface TypedOutput
        \n
        \n
        • \n
      \n\n\n\n\n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/MimeUtil.html", "content": "\n\n\n\n\n\nMimeUtil (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.mime
\n

Class MimeUtil

\n
\n
\n\n
\n
    \n
  • \n
    \n
    \n
    public final class MimeUtil\nextends Object
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n\n\n\n\n
        \n
      • \n

        parseCharset

        \n
        public static String parseCharset(String mimeType,\n                                  String defaultCharset)
        \n
        Parse the MIME type from a Content-Type header value.
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/MultipartTypedOutput.html", "content": "\n\n\n\n\n\nMultipartTypedOutput (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n\n
\n
retrofit.mime
\n

Class MultipartTypedOutput

\n
\n
\n\n
\n\n
\n
\n\n
\n
\n
    \n
  • \n\n\n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        MultipartTypedOutput

        \n
        public MultipartTypedOutput()
        \n
        • \n
      \n
      • \n
    \n\n\n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/TypedByteArray.html", "content": "\n\n\n\n\n\nTypedByteArray (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.mime
\n

Class TypedByteArray

\n
\n
\n\n
\n\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        TypedByteArray

        \n
        public TypedByteArray(String mimeType,\n                      byte[] bytes)
        \n
        Constructs a new typed byte array. Sets mimeType to application/unknown if absent.
        \n
        \n
        Throws:
        \n
        NullPointerException - if bytes are null
        \n
        \n
        • \n
      \n
      • \n
    \n\n\n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/TypedFile.html", "content": "\n\n\n\n\n\nTypedFile (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.mime
\n

Class TypedFile

\n
\n
\n\n
\n\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        TypedFile

        \n
        public TypedFile(String mimeType,\n                 File file)
        \n
        Constructs a new typed file.
        \n
        \n
        Throws:
        \n
        NullPointerException - if file or mimeType is null
        \n
        \n
        • \n
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        file

        \n
        public File file()
        \n
        Returns the file.
        \n
        • \n
      \n\n\n\n\n\n\n\n
        \n
      • \n

        length

        \n
        public long length()
        \n
        Description copied from interface: TypedInput
        \n
        Length in bytes. Returns -1 if length is unknown.
        \n
        \n
        Specified by:
        \n
        length in interface TypedInput
        \n
        Specified by:
        \n
        length in interface TypedOutput
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        fileName

        \n
        public String fileName()
        \n
        Description copied from interface: TypedOutput
        \n
        Original filename.\n\n Used only for multipart requests, may be null.
        \n
        \n
        Specified by:
        \n
        fileName in interface TypedOutput
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        in

        \n
        public InputStream in()\n               throws IOException
        \n
        Description copied from interface: TypedInput
        \n
        Read bytes as stream. Unless otherwise specified, this method may only be called once. It is\n the responsibility of the caller to close the stream.
        \n
        \n
        Specified by:
        \n
        in in interface TypedInput
        \n
        Throws:
        \n
        IOException
        \n
        \n
        • \n
      \n\n\n\n\n\n\n\n
        \n
      • \n

        moveTo

        \n
        public void moveTo(TypedFile destination)\n            throws IOException
        \n
        Atomically moves the contents of this file to a new location.
        \n
        \n
        Parameters:
        \n
        destination - file
        \n
        Throws:
        \n
        IOException - if the move fails
        \n
        \n
        • \n
      \n\n\n\n\n\n\n\n
        \n
      • \n

        equals

        \n
        public boolean equals(Object o)
        \n
        \n
        Overrides:
        \n
        equals in class Object
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        hashCode

        \n
        public int hashCode()
        \n
        \n
        Overrides:
        \n
        hashCode in class Object
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/TypedInput.html", "content": "\n\n\n\n\n\nTypedInput (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.mime
\n

Interface TypedInput

\n
\n
\n
\n
    \n
  • \n
    \n
    All Known Implementing Classes:
    \n
    TypedByteArray, TypedFile, TypedString
    \n
    \n
    \n
    \n
    public interface TypedInput
    \n
    Binary data with an associated mime type.
    \n
    \n
    Author:
    \n
    Jake Wharton (jw@squareup.com)
    \n
    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        mimeType

        \n
        String mimeType()
        \n
        Returns the mime type.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        length

        \n
        long length()
        \n
        Length in bytes. Returns -1 if length is unknown.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        in

        \n
        InputStream in()\n        throws IOException
        \n
        Read bytes as stream. Unless otherwise specified, this method may only be called once. It is\n the responsibility of the caller to close the stream.
        \n
        \n
        Throws:
        \n
        IOException
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/TypedOutput.html", "content": "\n\n\n\n\n\nTypedOutput (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.mime
\n

Interface TypedOutput

\n
\n
\n
\n\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        fileName

        \n
        String fileName()
        \n
        Original filename.\n\n Used only for multipart requests, may be null.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        mimeType

        \n
        String mimeType()
        \n
        Returns the mime type.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        length

        \n
        long length()
        \n
        Length in bytes or -1 if unknown.
        \n
        • \n
      \n\n\n\n\n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/TypedString.html", "content": "\n\n\n\n\n\nTypedString (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit.mime
\n

Class TypedString

\n
\n
\n\n
\n\n
\n
\n\n
\n
\n\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/class-use/FormUrlEncodedTypedOutput.html", "content": "\n\n\n\n\n\nUses of Class retrofit.mime.FormUrlEncodedTypedOutput (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.mime.FormUrlEncodedTypedOutput

\n
\n
No usage of retrofit.mime.FormUrlEncodedTypedOutput
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/class-use/MimeUtil.html", "content": "\n\n\n\n\n\nUses of Class retrofit.mime.MimeUtil (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.mime.MimeUtil

\n
\n
No usage of retrofit.mime.MimeUtil
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/class-use/MultipartTypedOutput.html", "content": "\n\n\n\n\n\nUses of Class retrofit.mime.MultipartTypedOutput (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.mime.MultipartTypedOutput

\n
\n
No usage of retrofit.mime.MultipartTypedOutput
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/class-use/TypedByteArray.html", "content": "\n\n\n\n\n\nUses of Class retrofit.mime.TypedByteArray (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.mime.TypedByteArray

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/class-use/TypedFile.html", "content": "\n\n\n\n\n\nUses of Class retrofit.mime.TypedFile (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.mime.TypedFile

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/class-use/TypedInput.html", "content": "\n\n\n\n\n\nUses of Interface retrofit.mime.TypedInput (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Interface
retrofit.mime.TypedInput

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/class-use/TypedOutput.html", "content": "\n\n\n\n\n\nUses of Interface retrofit.mime.TypedOutput (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Interface
retrofit.mime.TypedOutput

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/class-use/TypedString.html", "content": "\n\n\n\n\n\nUses of Class retrofit.mime.TypedString (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.mime.TypedString

\n
\n
No usage of retrofit.mime.TypedString
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/package-frame.html", "content": "\n\n\n\n\n\nretrofit.mime (Retrofit 1.9.0 API)\n\n\n\n\n\n

retrofit.mime

\n
\n

Interfaces

\n\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/package-summary.html", "content": "\n\n\n\n\n\nretrofit.mime (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Package retrofit.mime

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/package-tree.html", "content": "\n\n\n\n\n\nretrofit.mime Class Hierarchy (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit.mime

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n

Interface Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/mime/package-use.html", "content": "\n\n\n\n\n\nUses of Package retrofit.mime (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Package
retrofit.mime

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/package-frame.html", "content": "\n\n\n\n\n\nretrofit (Retrofit 1.9.0 API)\n\n\n\n\n\n

retrofit

\n
\n

Interfaces

\n\n

Classes

\n\n

Enums

\n\n

Exceptions

\n\n
\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/package-summary.html", "content": "\n\n\n\n\n\nretrofit (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Package retrofit

\n
\n
Retrofit turns your REST API into a Java interface.
\n
\n

See: Description

\n
\n
\n\n\n\n\n

Package retrofit Description

\n
Retrofit turns your REST API into a Java interface.\n 
\n public interface GitHubService {\n   @GET(\"/users/{user}/repos\")\n   List<Repo> listRepos(@Path(\"user\") String user);\n }\n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/package-tree.html", "content": "\n\n\n\n\n\nretrofit Class Hierarchy (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n

Interface Hierarchy

\n\n

Enum Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/retrofit/package-use.html", "content": "\n\n\n\n\n\nUses of Package retrofit (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Package
retrofit

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/1.x/retrofit/serialized-form.html", "content": "\n\n\n\n\n\nSerialized Form (Retrofit 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Serialized Form

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n width:100%;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/1.x/retrofit/version.txt", "content": "1.9.0" }, { "path": "website/public/1.x/retrofit-mock/allclasses-frame.html", "content": "\n\n\n\n\n\nAll Classes (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/allclasses-noframe.html", "content": "\n\n\n\n\n\nAll Classes (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/constant-values.html", "content": "\n\n\n\n\n\nConstant Field Values (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/deprecated-list.html", "content": "\n\n\n\n\n\nDeprecated List (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/help-doc.html", "content": "\n\n\n\n\n\nAPI Help (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Overview

    \n

    The Overview page is the front page of this API document and provides a list of all packages with a summary for each. This page can also contain an overall description of the set of packages.

    \n
    • \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Use

    \n

    Each documented package, class and interface has its own Use page. This page describes what packages, classes, methods, constructors and fields use any part of the given class or package. Given a class or interface A, its Use page includes subclasses of A, fields declared as A, methods that return A, and methods and constructors with parameters of type A. You can access this page by first going to the package, class or interface, then clicking on the \"Use\" link in the navigation bar.

    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/index-all.html", "content": "\n\n\n\n\n\nIndex (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
A C E F G I M N O R S W \n\n\n

A

\n
\n
AndroidMockValuePersistence - Class in retrofit.android
\n
\n
A value change listener for MockRestAdapter\n which stores any customized behavior values into shared preferences.
\n
\n
\n\n\n\n

C

\n
\n
calculateDelayForCall() - Method in class retrofit.MockRestAdapter
\n
\n
Get the delay (in milliseconds) that should be used for delaying a network call response.
\n
\n
calculateDelayForError() - Method in class retrofit.MockRestAdapter
\n
\n
Get the delay (in milliseconds) that should be used for triggering a network error.
\n
\n
calculateIsFailure() - Method in class retrofit.MockRestAdapter
\n
\n
Randomly determine whether this call should result in a network failure.
\n
\n
create(Class<T>, T) - Method in class retrofit.MockRestAdapter
\n
\n
Wrap the supplied mock implementation of a service so that it exhibits the delay and error\n characteristics of a real network.
\n
\n
\n\n\n\n

E

\n
\n
EMPTY - Static variable in interface retrofit.MockRestAdapter.ValueChangeListener
\n
 
\n
\n\n\n\n

F

\n
\n
from(RestAdapter) - Static method in class retrofit.MockRestAdapter
\n
\n
Create a new MockRestAdapter which will act as a factory for mock services.
\n
\n
\n\n\n\n

G

\n
\n
getDelay() - Method in class retrofit.MockRestAdapter
\n
\n
The network round trip delay, in milliseconds
\n
\n
getErrorPercentage() - Method in class retrofit.MockRestAdapter
\n
\n
The percentage of calls to MockRestAdapter.calculateIsFailure() that return true.
\n
\n
getVariancePercentage() - Method in class retrofit.MockRestAdapter
\n
\n
The plus-or-minus variance percentage of the network round trip delay.
\n
\n
\n\n\n\n

I

\n
\n
install(MockRestAdapter, SharedPreferences) - Static method in class retrofit.android.AndroidMockValuePersistence
\n
\n
Install a value change listener on the supplied\n MockRestAdapter using the SharedPreferences for storing customized behavior\n values.
\n
\n
\n\n\n\n

M

\n
\n
MockHttpException - Exception in retrofit
\n
\n
An exception used to trigger the simulation of an HTTP error for mock services.
\n
\n
MockHttpException(int, String, Object) - Constructor for exception retrofit.MockHttpException
\n
\n
Create a new HTTP exception.
\n
\n
MockRestAdapter - Class in retrofit
\n
\n
Wraps mock implementations of API interfaces so that they exhibit the delay and error\n characteristics of a real network.
\n
\n
MockRestAdapter.ValueChangeListener - Interface in retrofit
\n
\n
A listener invoked when the network behavior values for a MockRestAdapter change.
\n
\n
\n\n\n\n

N

\n
\n
newBadRequest(Object) - Static method in exception retrofit.MockHttpException
\n
\n
Create a new MockHttpException for HTTP 400 Bad Request.
\n
\n
newForbidden(Object) - Static method in exception retrofit.MockHttpException
\n
\n
Create a new MockHttpException for HTTP 403 Forbidden.
\n
\n
newInternalError(Object) - Static method in exception retrofit.MockHttpException
\n
\n
Create a new MockHttpException for HTTP 500 Internal Server Error.
\n
\n
newMovedPermanentely(String, Object) - Static method in exception retrofit.MockHttpException
\n
\n
Create a new MockHttpException for HTTP 301 Moved Permanently.
\n
\n
newMovedTemporarily(String, Object) - Static method in exception retrofit.MockHttpException
\n
\n
Create a new MockHttpException for HTTP 302 Moved Temporarily.
\n
\n
newNotFound(Object) - Static method in exception retrofit.MockHttpException
\n
\n
Create a new MockHttpException for HTTP 404 Not Found.
\n
\n
newUnauthorized(Object) - Static method in exception retrofit.MockHttpException
\n
\n
Create a new MockHttpException for HTTP 401 Unauthorized.
\n
\n
\n\n\n\n

O

\n
\n
onMockValuesChanged(long, int, int) - Method in class retrofit.android.AndroidMockValuePersistence
\n
 
\n
onMockValuesChanged(long, int, int) - Method in interface retrofit.MockRestAdapter.ValueChangeListener
\n
 
\n
\n\n\n\n

R

\n
\n
retrofit - package retrofit
\n
 
\n
retrofit.android - package retrofit.android
\n
 
\n
\n\n\n\n

S

\n
\n
setDelay(long) - Method in class retrofit.MockRestAdapter
\n
\n
Set the network round trip delay, in milliseconds.
\n
\n
setErrorPercentage(int) - Method in class retrofit.MockRestAdapter
\n
\n
Set the percentage of calls to MockRestAdapter.calculateIsFailure() that return true.
\n
\n
setValueChangeListener(MockRestAdapter.ValueChangeListener) - Method in class retrofit.MockRestAdapter
\n
\n
Set a listener to be notified when any mock value changes.
\n
\n
setVariancePercentage(int) - Method in class retrofit.MockRestAdapter
\n
\n
Set the plus-or-minus variance percentage of the network round trip delay.
\n
\n
\n\n\n\n

W

\n
\n
withHeader(String, String) - Method in exception retrofit.MockHttpException
\n
\n
Add a header to the response.
\n
\n
\nA C E F G I M N O R S W 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/index.html", "content": "\n\n\n\n\n\nRetrofit Mock Adapter 1.9.0 API\n\n\n\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"overview-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/overview-frame.html", "content": "\n\n\n\n\n\nOverview List (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n
All Classes
\n
\n

Packages

\n\n
\n

 

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/overview-summary.html", "content": "\n\n\n\n\n\nOverview (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Retrofit Mock Adapter 1.9.0 API

\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Packages 
PackageDescription
retrofit 
retrofit.android 
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/overview-tree.html", "content": "\n\n\n\n\n\nClass Hierarchy (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n

Interface Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/package-list", "content": "retrofit\nretrofit.android\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/MockHttpException.html", "content": "\n\n\n\n\n\nMockHttpException (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit
\n

Class MockHttpException

\n
\n
\n\n
\n\n
\n
\n\n
\n
\n\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/MockRestAdapter.ValueChangeListener.html", "content": "\n\n\n\n\n\nMockRestAdapter.ValueChangeListener (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n\n
\n
retrofit
\n

Interface MockRestAdapter.ValueChangeListener

\n
\n
\n
\n\n
\n
\n\n
\n
\n
    \n
  • \n\n\n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        onMockValuesChanged

        \n
        void onMockValuesChanged(long delayMs,\n                         int variancePct,\n                         int errorPct)
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/MockRestAdapter.html", "content": "\n\n\n\n\n\nMockRestAdapter (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit
\n

Class MockRestAdapter

\n
\n
\n\n
\n
    \n
  • \n
    \n
    \n
    public final class MockRestAdapter\nextends Object
    \n
    Wraps mock implementations of API interfaces so that they exhibit the delay and error\n characteristics of a real network.\n

    \n Because APIs are defined as interfaces, versions of the API that use mock data can be created by\n simply implementing the API interface on a class. These mock implementations execute\n synchronously which is a large deviation from the behavior of those backed by an API call over\n the network. By wrapping the mock instances using this class, the interface will still use mock\n data but exhibit the delays and errors that a real network would face.\n

    \n Create an API interface and a mock implementation of it.\n 

    \n   public interface UserService {\n     @GET(\"/user/{id}\")\n     User getUser(@Path(\"id\") String userId);\n   }\n   public class MockUserService implements UserService {\n     @Override public User getUser(String userId) {\n       return new User(\"Jake\");\n     }\n   }\n
    \n Given a RestAdapter an instance of this class can be created by calling from(retrofit.RestAdapter).\n 
    \n   MockRestAdapter mockRestAdapter = MockRestAdapter.from(restAdapter);\n
    \n Instances of this class should be used as a singleton so that the behavior of every mock service\n is consistent.\n

    \n Rather than using the MockUserService directly, pass it through\n the create method.\n 

    \n   UserService service = mockRestAdapter.create(UserService.class, new MockUserService());\n
    \n The returned UserService instance will now behave like it is happening over the network\n while allowing the mock implementation to be written synchronously.\n

    \n HTTP errors can be simulated in your mock services by throwing an instance of\n MockHttpException. This should be done for both synchronous and asynchronous methods.\n Do not call the failure() method of a callback.

    \n
    • \n
\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n\n\n\n\n
        \n
      • \n

        setValueChangeListener

        \n
        public void setValueChangeListener(MockRestAdapter.ValueChangeListener listener)
        \n
        Set a listener to be notified when any mock value changes.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setDelay

        \n
        public void setDelay(long delayMs)
        \n
        Set the network round trip delay, in milliseconds.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getDelay

        \n
        public long getDelay()
        \n
        The network round trip delay, in milliseconds
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setVariancePercentage

        \n
        public void setVariancePercentage(int variancePct)
        \n
        Set the plus-or-minus variance percentage of the network round trip delay.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getVariancePercentage

        \n
        public int getVariancePercentage()
        \n
        The plus-or-minus variance percentage of the network round trip delay.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        setErrorPercentage

        \n
        public void setErrorPercentage(int errorPct)
        \n
        Set the percentage of calls to calculateIsFailure() that return true.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        getErrorPercentage

        \n
        public int getErrorPercentage()
        \n
        The percentage of calls to calculateIsFailure() that return true.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        calculateIsFailure

        \n
        public boolean calculateIsFailure()
        \n
        Randomly determine whether this call should result in a network failure.\n

        \n This method is exposed for implementing other, non-Retrofit services which exhibit similar\n network behavior. Retrofit services automatically will exhibit network behavior when wrapped\n using create(Class, Object).

        \n
        • \n
      \n\n\n\n
        \n
      • \n

        calculateDelayForError

        \n
        public int calculateDelayForError()
        \n
        Get the delay (in milliseconds) that should be used for triggering a network error.\n

        \n Because we are triggering an error, use a random delay between 0 and three times the normal\n network delay to simulate a flaky connection failing anywhere from quickly to slowly.\n

        \n This method is exposed for implementing other, non-Retrofit services which exhibit similar\n network behavior. Retrofit services automatically will exhibit network behavior when wrapped\n using create(Class, Object).

        \n
        • \n
      \n\n\n\n
        \n
      • \n

        calculateDelayForCall

        \n
        public int calculateDelayForCall()
        \n
        Get the delay (in milliseconds) that should be used for delaying a network call response.\n

        \n This method is exposed for implementing other, non-Retrofit services which exhibit similar\n network behavior. Retrofit services automatically will exhibit network behavior when wrapped\n using create(Class, Object).

        \n
        • \n
      \n\n\n\n\n\n\n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/android/AndroidMockValuePersistence.html", "content": "\n\n\n\n\n\nAndroidMockValuePersistence (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.android
\n

Class AndroidMockValuePersistence

\n
\n
\n\n
\n\n
\n
\n\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        install

        \n
        public static void install(MockRestAdapter mockRestAdapter,\n                           android.content.SharedPreferences preferences)
        \n
        Install a value change listener on the supplied\n MockRestAdapter using the SharedPreferences for storing customized behavior\n values. Invoking this will load any existing stored values for the mock adapter's behavior.
        \n
        • \n
      \n\n\n\n\n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/android/class-use/AndroidMockValuePersistence.html", "content": "\n\n\n\n\n\nUses of Class retrofit.android.AndroidMockValuePersistence (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.android.AndroidMockValuePersistence

\n
\n
No usage of retrofit.android.AndroidMockValuePersistence
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/android/package-frame.html", "content": "\n\n\n\n\n\nretrofit.android (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n

retrofit.android

\n
\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/android/package-summary.html", "content": "\n\n\n\n\n\nretrofit.android (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Package retrofit.android

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/android/package-tree.html", "content": "\n\n\n\n\n\nretrofit.android Class Hierarchy (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit.android

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/android/package-use.html", "content": "\n\n\n\n\n\nUses of Package retrofit.android (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Package
retrofit.android

\n
\n
No usage of retrofit.android
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/class-use/MockHttpException.html", "content": "\n\n\n\n\n\nUses of Class retrofit.MockHttpException (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.MockHttpException

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/class-use/MockRestAdapter.ValueChangeListener.html", "content": "\n\n\n\n\n\nUses of Interface retrofit.MockRestAdapter.ValueChangeListener (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Interface
retrofit.MockRestAdapter.ValueChangeListener

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/class-use/MockRestAdapter.html", "content": "\n\n\n\n\n\nUses of Class retrofit.MockRestAdapter (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Class
retrofit.MockRestAdapter

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/package-frame.html", "content": "\n\n\n\n\n\nretrofit (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n

retrofit

\n
\n

Interfaces

\n\n

Classes

\n\n

Exceptions

\n\n
\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/package-summary.html", "content": "\n\n\n\n\n\nretrofit (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Package retrofit

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Interface Summary 
    InterfaceDescription
    MockRestAdapter.ValueChangeListener\n
    A listener invoked when the network behavior values for a MockRestAdapter change.
    \n
    \n
    • \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    MockRestAdapter\n
    Wraps mock implementations of API interfaces so that they exhibit the delay and error\n characteristics of a real network.
    \n
    \n
    • \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Exception Summary 
    ExceptionDescription
    MockHttpException\n
    An exception used to trigger the simulation of an HTTP error for mock services.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/package-tree.html", "content": "\n\n\n\n\n\nretrofit Class Hierarchy (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n

Interface Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/retrofit/package-use.html", "content": "\n\n\n\n\n\nUses of Package retrofit (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Uses of Package
retrofit

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/1.x/retrofit-mock/serialized-form.html", "content": "\n\n\n\n\n\nSerialized Form (Retrofit Mock Adapter 1.9.0 API)\n\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Serialized Form

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n

Copyright © 2015 Square, Inc.. All Rights Reserved.

\n\n\n" }, { "path": "website/public/1.x/retrofit-mock/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n width:100%;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/1.x/retrofit-mock/version.txt", "content": "1.9.0" }, { "path": "website/public/2.x/adapter-guava/allclasses-frame.html", "content": "\n\n\n\n\nAll Classes (guava API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-guava/allclasses-noframe.html", "content": "\n\n\n\n\nAll Classes (guava API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-guava/constant-values.html", "content": "\n\n\n\n\nConstant Field Values (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-guava/deprecated-list.html", "content": "\n\n\n\n\nDeprecated List (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n\n
\n
\n\n\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-guava/help-doc.html", "content": "\n\n\n\n\nAPI Help (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-guava/index-all.html", "content": "\n\n\n\n\nIndex (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
C G H R \n\n\n

C

\n
\n
create() - Static method in class retrofit2.adapter.guava.GuavaCallAdapterFactory
\n
 
\n
\n\n\n\n

G

\n
\n
get(Type, Annotation[], Retrofit) - Method in class retrofit2.adapter.guava.GuavaCallAdapterFactory
\n
 
\n
GuavaCallAdapterFactory - Class in retrofit2.adapter.guava
\n
\n
A call adapter which creates Guava futures.
\n
\n
\n\n\n\n

H

\n
\n
HttpException - Exception in retrofit2.adapter.guava
\n
\n
Deprecated.\n
Use HttpException.
\n
\n
\n
HttpException(Response<?>) - Constructor for exception retrofit2.adapter.guava.HttpException
\n
\n
Deprecated.
\n 
\n
\n\n\n\n

R

\n
\n
retrofit2.adapter.guava - package retrofit2.adapter.guava
\n
 
\n
\nC G H R 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-guava/index.html", "content": "\n\n\n\n\nguava API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit2/adapter/guava/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/2.x/adapter-guava/overview-tree.html", "content": "\n\n\n\n\nClass Hierarchy (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n
      \n
    • retrofit2.CallAdapter.Factory\n\n
      • \n
    • java.lang.Throwable (implements java.io.Serializable)\n
        \n
      • java.lang.Exception\n
          \n
        • java.lang.RuntimeException\n
            \n
          • retrofit2.HttpException\n\n
            • \n
          \n
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-guava/package-list", "content": "retrofit2.adapter.guava\n" }, { "path": "website/public/2.x/adapter-guava/retrofit2/adapter/guava/GuavaCallAdapterFactory.html", "content": "\n\n\n\n\nGuavaCallAdapterFactory (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.adapter.guava
\n

Class GuavaCallAdapterFactory

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • retrofit2.CallAdapter.Factory
      • \n
    • \n
        \n
      • retrofit2.adapter.guava.GuavaCallAdapterFactory
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public final class GuavaCallAdapterFactory\nextends retrofit2.CallAdapter.Factory
    \n
    A call adapter which creates Guava futures.\n\n

    Adding this class to Retrofit allows you to return ListenableFuture from\n service methods.\n\n 

    \n interface MyService {\n   @GET(\"user/me\")\n   ListenableFuture<User> getUser()\n }\n
    \n\n There are two configurations supported for the ListenableFuture type parameter:\n\n
      \n
    • Direct body (e.g., ListenableFuture<User>) returns the deserialized body for 2XX\n responses, sets HttpException errors for non-2XX responses,\n and sets IOException for network errors.\n
    • Response wrapped body (e.g., ListenableFuture<Response<User>>) returns a Response object for all HTTP responses and sets IOException for network errors\n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static GuavaCallAdapterFactorycreate() 
      retrofit2.CallAdapter<?,?>get(java.lang.reflect.Type returnType,\n java.lang.annotation.Annotation[] annotations,\n retrofit2.Retrofit retrofit) 
      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.CallAdapter.Factory

        \ngetParameterUpperBound, getRawType
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n\n\n\n\n
        \n
      • \n

        get

        \n
        @Nullable\npublic retrofit2.CallAdapter<?,?> get(java.lang.reflect.Type returnType,\n                                                java.lang.annotation.Annotation[] annotations,\n                                                retrofit2.Retrofit retrofit)
        \n
        \n
        Specified by:
        \n
        get in class retrofit2.CallAdapter.Factory
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-guava/retrofit2/adapter/guava/HttpException.html", "content": "\n\n\n\n\nHttpException (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.adapter.guava
\n

Class HttpException

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • java.lang.Throwable
      • \n
    • \n
        \n
      • java.lang.Exception
        • \n
      • \n
          \n
        • java.lang.RuntimeException
          • \n
        • \n
            \n
          • retrofit2.HttpException
            • \n
          • \n
              \n
            • retrofit2.adapter.guava.HttpException
              • \n
            \n
            • \n
          \n
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    java.io.Serializable
    \n
    \n
    \n
    Deprecated. \n
    Use HttpException.
    \n
    \n
    \n
    @Deprecated\npublic final class HttpException\nextends retrofit2.HttpException
    \n
    \n
    See Also:
    \n
    Serialized Form
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Summary

      \n\n\n\n\n\n\n\n\n
      Constructors 
      Constructor and Description
      HttpException(retrofit2.Response<?> response)\n
      Deprecated. 
      \n 
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Summary

      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.HttpException

        \ncode, message, response
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Throwable

        \naddSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        HttpException

        \n
        public HttpException(retrofit2.Response<?> response)
        \n
        Deprecated. 
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-guava/retrofit2/adapter/guava/package-frame.html", "content": "\n\n\n\n\nretrofit2.adapter.guava (guava API)\n\n\n\n\n

retrofit2.adapter.guava

\n
\n

Classes

\n\n

Exceptions

\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-guava/retrofit2/adapter/guava/package-summary.html", "content": "\n\n\n\n\nretrofit2.adapter.guava (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

@EverythingIsNonNull\n

\n

Package retrofit2.adapter.guava

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    GuavaCallAdapterFactory\n
    A call adapter which creates Guava futures.
    \n
    \n
    • \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Exception Summary 
    ExceptionDescription
    HttpExceptionDeprecated\n
    Use HttpException.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-guava/retrofit2/adapter/guava/package-tree.html", "content": "\n\n\n\n\nretrofit2.adapter.guava Class Hierarchy (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit2.adapter.guava

\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n
      \n
    • retrofit2.CallAdapter.Factory\n\n
      • \n
    • java.lang.Throwable (implements java.io.Serializable)\n
        \n
      • java.lang.Exception\n
          \n
        • java.lang.RuntimeException\n
            \n
          • retrofit2.HttpException\n\n
            • \n
          \n
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-guava/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/2.x/adapter-guava/serialized-form.html", "content": "\n\n\n\n\nSerialized Form (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Serialized Form

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-guava/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.useSummary td.colFirst, .useSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/2.x/adapter-java8/allclasses-frame.html", "content": "\n\n\n\n\nAll Classes (java8 API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-java8/allclasses-noframe.html", "content": "\n\n\n\n\nAll Classes (java8 API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-java8/constant-values.html", "content": "\n\n\n\n\nConstant Field Values (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-java8/deprecated-list.html", "content": "\n\n\n\n\nDeprecated List (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n\n
\n
\n\n\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n
    Deprecated Classes 
    Class and Description
    retrofit2.adapter.java8.Java8CallAdapterFactory\n
    Retrofit includes support for CompletableFuture. This no longer needs to be added to\n the Retrofit instance explicitly.\n

    A call adapter which creates Java 8 futures.\n

    Adding this class to Retrofit allows you to return CompletableFuture from\n service methods.\n 

    \n interface MyService {\n   @GET(\"user/me\")\n   CompletableFuture<User> getUser()\n }\n
    \n There are two configurations supported for the CompletableFuture type parameter:\n
      \n
    • Direct body (e.g., CompletableFuture<User>) returns the deserialized body for\n 2XX responses, sets HttpException errors for non-2XX\n responses, and sets IOException for network errors.\n
    • Response wrapped body (e.g., CompletableFuture<Response<User>>) returns a\n Response object for all HTTP responses and sets IOException for network\n errors\n
    \n
    \n
    • \n
\n\n\n\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-java8/help-doc.html", "content": "\n\n\n\n\nAPI Help (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-java8/index-all.html", "content": "\n\n\n\n\nIndex (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
C G H J R \n\n\n

C

\n
\n
create() - Static method in class retrofit2.adapter.java8.Java8CallAdapterFactory
\n
\n
Deprecated.
\n 
\n
\n\n\n\n

G

\n
\n
get(Type, Annotation[], Retrofit) - Method in class retrofit2.adapter.java8.Java8CallAdapterFactory
\n
\n
Deprecated.
\n 
\n
\n\n\n\n

H

\n
\n
HttpException - Exception in retrofit2.adapter.java8
\n
\n
Deprecated.\n
Use HttpException.
\n
\n
\n
HttpException(Response<?>) - Constructor for exception retrofit2.adapter.java8.HttpException
\n
\n
Deprecated.
\n 
\n
\n\n\n\n

J

\n
\n
Java8CallAdapterFactory - Class in retrofit2.adapter.java8
\n
\n
Deprecated.\n
Retrofit includes support for CompletableFuture. This no longer needs to be added to\n the Retrofit instance explicitly.\n

A call adapter which creates Java 8 futures.\n

Adding this class to Retrofit allows you to return CompletableFuture from\n service methods.\n 

\n interface MyService {\n   @GET(\"user/me\")\n   CompletableFuture<User> getUser()\n }\n
\n There are two configurations supported for the CompletableFuture type parameter:\n
    \n
  • Direct body (e.g., CompletableFuture<User>) returns the deserialized body for\n 2XX responses, sets HttpException errors for non-2XX\n responses, and sets IOException for network errors.\n
  • Response wrapped body (e.g., CompletableFuture<Response<User>>) returns a\n Response object for all HTTP responses and sets IOException for network\n errors\n
\n
\n
\n
\n\n\n\n

R

\n
\n
retrofit2.adapter.java8 - package retrofit2.adapter.java8
\n
 
\n
\nC G H J R 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-java8/index.html", "content": "\n\n\n\n\njava8 API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit2/adapter/java8/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/2.x/adapter-java8/overview-tree.html", "content": "\n\n\n\n\nClass Hierarchy (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n
      \n
    • retrofit2.CallAdapter.Factory\n\n
      • \n
    • java.lang.Throwable (implements java.io.Serializable)\n
        \n
      • java.lang.Exception\n
          \n
        • java.lang.RuntimeException\n
            \n
          • retrofit2.HttpException\n\n
            • \n
          \n
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-java8/package-list", "content": "retrofit2.adapter.java8\n" }, { "path": "website/public/2.x/adapter-java8/retrofit2/adapter/java8/HttpException.html", "content": "\n\n\n\n\nHttpException (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.adapter.java8
\n

Class HttpException

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • java.lang.Throwable
      • \n
    • \n
        \n
      • java.lang.Exception
        • \n
      • \n
          \n
        • java.lang.RuntimeException
          • \n
        • \n
            \n
          • retrofit2.HttpException
            • \n
          • \n
              \n
            • retrofit2.adapter.java8.HttpException
              • \n
            \n
            • \n
          \n
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    java.io.Serializable
    \n
    \n
    \n
    Deprecated. \n
    Use HttpException.
    \n
    \n
    \n
    @Deprecated\npublic final class HttpException\nextends retrofit2.HttpException
    \n
    \n
    See Also:
    \n
    Serialized Form
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Summary

      \n\n\n\n\n\n\n\n\n
      Constructors 
      Constructor and Description
      HttpException(retrofit2.Response<?> response)\n
      Deprecated. 
      \n 
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Summary

      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.HttpException

        \ncode, message, response
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Throwable

        \naddSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        HttpException

        \n
        public HttpException(retrofit2.Response<?> response)
        \n
        Deprecated. 
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-java8/retrofit2/adapter/java8/Java8CallAdapterFactory.html", "content": "\n\n\n\n\nJava8CallAdapterFactory (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.adapter.java8
\n

Class Java8CallAdapterFactory

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • retrofit2.CallAdapter.Factory
      • \n
    • \n
        \n
      • retrofit2.adapter.java8.Java8CallAdapterFactory
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    Deprecated. \n
    Retrofit includes support for CompletableFuture. This no longer needs to be added to\n the Retrofit instance explicitly.\n

    A call adapter which creates Java 8 futures.\n

    Adding this class to Retrofit allows you to return CompletableFuture from\n service methods.\n 

    \n interface MyService {\n   @GET(\"user/me\")\n   CompletableFuture<User> getUser()\n }\n
    \n There are two configurations supported for the CompletableFuture type parameter:\n
      \n
    • Direct body (e.g., CompletableFuture<User>) returns the deserialized body for\n 2XX responses, sets HttpException errors for non-2XX\n responses, and sets IOException for network errors.\n
    • Response wrapped body (e.g., CompletableFuture<Response<User>>) returns a\n Response object for all HTTP responses and sets IOException for network\n errors\n
    \n
    \n
    \n
    @Deprecated\npublic final class Java8CallAdapterFactory\nextends retrofit2.CallAdapter.Factory
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and TypeMethod and Description
      static Java8CallAdapterFactorycreate()\n
      Deprecated. 
      \n 
      retrofit2.CallAdapter<?,?>get(java.lang.reflect.Type returnType,\n java.lang.annotation.Annotation[] annotations,\n retrofit2.Retrofit retrofit)\n
      Deprecated. 
      \n 
      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.CallAdapter.Factory

        \ngetParameterUpperBound, getRawType
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n\n\n\n\n
        \n
      • \n

        get

        \n
        @Nullable\npublic retrofit2.CallAdapter<?,?> get(java.lang.reflect.Type returnType,\n                                                java.lang.annotation.Annotation[] annotations,\n                                                retrofit2.Retrofit retrofit)
        \n
        Deprecated. 
        \n
        \n
        Specified by:
        \n
        get in class retrofit2.CallAdapter.Factory
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-java8/retrofit2/adapter/java8/package-frame.html", "content": "\n\n\n\n\nretrofit2.adapter.java8 (java8 API)\n\n\n\n\n

retrofit2.adapter.java8

\n
\n

Classes

\n\n

Exceptions

\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-java8/retrofit2/adapter/java8/package-summary.html", "content": "\n\n\n\n\nretrofit2.adapter.java8 (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

@EverythingIsNonNull\n

\n

Package retrofit2.adapter.java8

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    Java8CallAdapterFactoryDeprecated\n
    Retrofit includes support for CompletableFuture.
    \n
    \n
    • \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Exception Summary 
    ExceptionDescription
    HttpExceptionDeprecated\n
    Use HttpException.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-java8/retrofit2/adapter/java8/package-tree.html", "content": "\n\n\n\n\nretrofit2.adapter.java8 Class Hierarchy (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit2.adapter.java8

\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n
      \n
    • retrofit2.CallAdapter.Factory\n\n
      • \n
    • java.lang.Throwable (implements java.io.Serializable)\n
        \n
      • java.lang.Exception\n
          \n
        • java.lang.RuntimeException\n
            \n
          • retrofit2.HttpException\n\n
            • \n
          \n
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-java8/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/2.x/adapter-java8/serialized-form.html", "content": "\n\n\n\n\nSerialized Form (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Serialized Form

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-java8/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.useSummary td.colFirst, .useSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/2.x/adapter-rxjava/allclasses-frame.html", "content": "\n\n\n\n\nAll Classes (rxjava API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava/allclasses-noframe.html", "content": "\n\n\n\n\nAll Classes (rxjava API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava/constant-values.html", "content": "\n\n\n\n\nConstant Field Values (rxjava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava/deprecated-list.html", "content": "\n\n\n\n\nDeprecated List (rxjava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n\n
\n
\n\n\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava/help-doc.html", "content": "\n\n\n\n\nAPI Help (rxjava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava/index-all.html", "content": "\n\n\n\n\nIndex (rxjava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
C E G H I R T \n\n\n

C

\n
\n
create() - Static method in class retrofit2.adapter.rxjava.RxJavaCallAdapterFactory
\n
\n
Returns an instance which creates synchronous observables that do not operate on any scheduler\n by default.
\n
\n
createAsync() - Static method in class retrofit2.adapter.rxjava.RxJavaCallAdapterFactory
\n
\n
Returns an instance which creates asynchronous observables.
\n
\n
createWithScheduler(Scheduler) - Static method in class retrofit2.adapter.rxjava.RxJavaCallAdapterFactory
\n
\n
Returns an instance which creates synchronous observables that subscribe on scheduler by default.
\n
\n
\n\n\n\n

E

\n
\n
error(Throwable) - Static method in class retrofit2.adapter.rxjava.Result
\n
 
\n
error() - Method in class retrofit2.adapter.rxjava.Result
\n
\n
The error experienced while attempting to execute an HTTP request.
\n
\n
\n\n\n\n

G

\n
\n
get(Type, Annotation[], Retrofit) - Method in class retrofit2.adapter.rxjava.RxJavaCallAdapterFactory
\n
 
\n
\n\n\n\n

H

\n
\n
HttpException - Exception in retrofit2.adapter.rxjava
\n
\n
Deprecated.\n
Use HttpException.
\n
\n
\n
HttpException(Response<?>) - Constructor for exception retrofit2.adapter.rxjava.HttpException
\n
\n
Deprecated.
\n 
\n
\n\n\n\n

I

\n
\n
isError() - Method in class retrofit2.adapter.rxjava.Result
\n
\n
true if the request resulted in an error.
\n
\n
\n\n\n\n

R

\n
\n
response(Response<T>) - Static method in class retrofit2.adapter.rxjava.Result
\n
 
\n
response() - Method in class retrofit2.adapter.rxjava.Result
\n
\n
The response received from executing an HTTP request.
\n
\n
Result<T> - Class in retrofit2.adapter.rxjava
\n
\n
The result of executing an HTTP request.
\n
\n
retrofit2.adapter.rxjava - package retrofit2.adapter.rxjava
\n
 
\n
RxJavaCallAdapterFactory - Class in retrofit2.adapter.rxjava
\n
\n
A call adapter which uses RxJava for creating observables.
\n
\n
\n\n\n\n

T

\n
\n
toString() - Method in class retrofit2.adapter.rxjava.Result
\n
 
\n
\nC E G H I R T 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava/index.html", "content": "\n\n\n\n\nrxjava API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit2/adapter/rxjava/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava/overview-tree.html", "content": "\n\n\n\n\nClass Hierarchy (rxjava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n
      \n
    • retrofit2.CallAdapter.Factory\n\n
      • \n
    • retrofit2.adapter.rxjava.Result<T>
      • \n
    • java.lang.Throwable (implements java.io.Serializable)\n
        \n
      • java.lang.Exception\n
          \n
        • java.lang.RuntimeException\n
            \n
          • retrofit2.HttpException\n\n
            • \n
          \n
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava/package-list", "content": "retrofit2.adapter.rxjava\n" }, { "path": "website/public/2.x/adapter-rxjava/retrofit2/adapter/rxjava/HttpException.html", "content": "\n\n\n\n\nHttpException (rxjava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.adapter.rxjava
\n

Class HttpException

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • java.lang.Throwable
      • \n
    • \n
        \n
      • java.lang.Exception
        • \n
      • \n
          \n
        • java.lang.RuntimeException
          • \n
        • \n
            \n
          • retrofit2.HttpException
            • \n
          • \n
              \n
            • retrofit2.adapter.rxjava.HttpException
              • \n
            \n
            • \n
          \n
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    java.io.Serializable
    \n
    \n
    \n
    Deprecated. \n
    Use HttpException.
    \n
    \n
    \n
    @Deprecated\npublic final class HttpException\nextends retrofit2.HttpException
    \n
    \n
    See Also:
    \n
    Serialized Form
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Summary

      \n\n\n\n\n\n\n\n\n
      Constructors 
      Constructor and Description
      HttpException(retrofit2.Response<?> response)\n
      Deprecated. 
      \n 
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Summary

      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.HttpException

        \ncode, message, response
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Throwable

        \naddSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        HttpException

        \n
        public HttpException(retrofit2.Response<?> response)
        \n
        Deprecated. 
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava/retrofit2/adapter/rxjava/Result.html", "content": "\n\n\n\n\nResult (rxjava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.adapter.rxjava
\n

Class Result<T>

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • retrofit2.adapter.rxjava.Result<T>
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public final class Result<T>\nextends java.lang.Object
    \n
    The result of executing an HTTP request.
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      java.lang.Throwableerror()\n
      The error experienced while attempting to execute an HTTP request.
      \n
      static <T> Result<T>error(java.lang.Throwable error) 
      booleanisError()\n
      true if the request resulted in an error.
      \n
      retrofit2.Response<T>response()\n
      The response received from executing an HTTP request.
      \n
      static <T> Result<T>response(retrofit2.Response<T> response) 
      java.lang.StringtoString() 
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        error

        \n
        public static <T> Result<T> error(java.lang.Throwable error)
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        response

        \n
        public static <T> Result<T> response(retrofit2.Response<T> response)
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        response

        \n
        @Nullable\npublic retrofit2.Response<T> response()
        \n
        The response received from executing an HTTP request. Only present when isError() is\n false, null otherwise.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        error

        \n
        @Nullable\npublic java.lang.Throwable error()
        \n
        The error experienced while attempting to execute an HTTP request. Only present when isError() is true, null otherwise.\n\n

        If the error is an IOException then there was a problem with the transport to the\n remote server. Any other exception type indicates an unexpected failure and should be\n considered fatal (configuration error, programming error, etc.).

        \n
        • \n
      \n\n\n\n
        \n
      • \n

        isError

        \n
        public boolean isError()
        \n
        true if the request resulted in an error. See error() for the cause.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        toString

        \n
        public java.lang.String toString()
        \n
        \n
        Overrides:
        \n
        toString in class java.lang.Object
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava/retrofit2/adapter/rxjava/RxJavaCallAdapterFactory.html", "content": "\n\n\n\n\nRxJavaCallAdapterFactory (rxjava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.adapter.rxjava
\n

Class RxJavaCallAdapterFactory

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • retrofit2.CallAdapter.Factory
      • \n
    • \n
        \n
      • retrofit2.adapter.rxjava.RxJavaCallAdapterFactory
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public final class RxJavaCallAdapterFactory\nextends retrofit2.CallAdapter.Factory
    \n
    A call adapter which uses RxJava for creating observables.\n\n

    Adding this class to Retrofit allows you to return an Observable, Single, or Completable from service methods.\n\n 

    \n interface MyService {\n   @GET(\"user/me\")\n   Observable<User> getUser()\n }\n
    \n\n There are three configurations supported for the Observable or Single type\n parameter:\n\n
      \n
    • Direct body (e.g., Observable<User>) calls onNext with the deserialized\n body for 2XX responses and calls onError with HttpException for non-2XX\n responses and IOException for network errors.\n
    • Response wrapped body (e.g., Observable<Response<User>>) calls onNext with\n a Response object for all HTTP responses and calls onError with IOException for network errors\n
    • Result wrapped body (e.g., Observable<Result<User>>) calls onNext with a\n Result object for all HTTP responses and errors.\n
    \n\n

    Note: Support for Single and Completable is experimental and subject\n to backwards-incompatible changes at any time since both of these types are not considered stable\n by RxJava.

    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static RxJavaCallAdapterFactorycreate()\n
      Returns an instance which creates synchronous observables that do not operate on any scheduler\n by default.
      \n
      static RxJavaCallAdapterFactorycreateAsync()\n
      Returns an instance which creates asynchronous observables.
      \n
      static RxJavaCallAdapterFactorycreateWithScheduler(rx.Scheduler scheduler)\n
      Returns an instance which creates synchronous observables that subscribe on scheduler by default.
      \n
      retrofit2.CallAdapter<?,?>get(java.lang.reflect.Type returnType,\n java.lang.annotation.Annotation[] annotations,\n retrofit2.Retrofit retrofit) 
      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.CallAdapter.Factory

        \ngetParameterUpperBound, getRawType
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        create

        \n
        public static RxJavaCallAdapterFactory create()
        \n
        Returns an instance which creates synchronous observables that do not operate on any scheduler\n by default.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        createAsync

        \n
        public static RxJavaCallAdapterFactory createAsync()
        \n
        Returns an instance which creates asynchronous observables.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        createWithScheduler

        \n
        public static RxJavaCallAdapterFactory createWithScheduler(rx.Scheduler scheduler)
        \n
        Returns an instance which creates synchronous observables that subscribe on scheduler by default.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        get

        \n
        @Nullable\npublic retrofit2.CallAdapter<?,?> get(java.lang.reflect.Type returnType,\n                                                java.lang.annotation.Annotation[] annotations,\n                                                retrofit2.Retrofit retrofit)
        \n
        \n
        Specified by:
        \n
        get in class retrofit2.CallAdapter.Factory
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava/retrofit2/adapter/rxjava/package-frame.html", "content": "\n\n\n\n\nretrofit2.adapter.rxjava (rxjava API)\n\n\n\n\n

retrofit2.adapter.rxjava

\n
\n

Classes

\n\n

Exceptions

\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava/retrofit2/adapter/rxjava/package-summary.html", "content": "\n\n\n\n\nretrofit2.adapter.rxjava (rxjava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

@EverythingIsNonNull\n

\n

Package retrofit2.adapter.rxjava

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    Result<T>\n
    The result of executing an HTTP request.
    \n
    RxJavaCallAdapterFactory\n
    A call adapter which uses RxJava for creating observables.
    \n
    \n
    • \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Exception Summary 
    ExceptionDescription
    HttpExceptionDeprecated\n
    Use HttpException.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava/retrofit2/adapter/rxjava/package-tree.html", "content": "\n\n\n\n\nretrofit2.adapter.rxjava Class Hierarchy (rxjava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit2.adapter.rxjava

\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n
      \n
    • retrofit2.CallAdapter.Factory\n\n
      • \n
    • retrofit2.adapter.rxjava.Result<T>
      • \n
    • java.lang.Throwable (implements java.io.Serializable)\n
        \n
      • java.lang.Exception\n
          \n
        • java.lang.RuntimeException\n
            \n
          • retrofit2.HttpException\n\n
            • \n
          \n
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/2.x/adapter-rxjava/serialized-form.html", "content": "\n\n\n\n\nSerialized Form (rxjava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Serialized Form

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.useSummary td.colFirst, .useSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/2.x/adapter-rxjava2/allclasses-frame.html", "content": "\n\n\n\n\nAll Classes (rxjava2 API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava2/allclasses-noframe.html", "content": "\n\n\n\n\nAll Classes (rxjava2 API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava2/constant-values.html", "content": "\n\n\n\n\nConstant Field Values (rxjava2 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava2/deprecated-list.html", "content": "\n\n\n\n\nDeprecated List (rxjava2 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n\n
\n
\n\n\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava2/help-doc.html", "content": "\n\n\n\n\nAPI Help (rxjava2 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava2/index-all.html", "content": "\n\n\n\n\nIndex (rxjava2 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
C E G H I R \n\n\n

C

\n
\n
create() - Static method in class retrofit2.adapter.rxjava2.RxJava2CallAdapterFactory
\n
\n
Returns an instance which creates synchronous observables that do not operate on any scheduler\n by default.
\n
\n
createAsync() - Static method in class retrofit2.adapter.rxjava2.RxJava2CallAdapterFactory
\n
\n
Returns an instance which creates asynchronous observables.
\n
\n
createWithScheduler(Scheduler) - Static method in class retrofit2.adapter.rxjava2.RxJava2CallAdapterFactory
\n
\n
Returns an instance which creates synchronous observables that subscribe on scheduler by default.
\n
\n
\n\n\n\n

E

\n
\n
error(Throwable) - Static method in class retrofit2.adapter.rxjava2.Result
\n
 
\n
error() - Method in class retrofit2.adapter.rxjava2.Result
\n
\n
The error experienced while attempting to execute an HTTP request.
\n
\n
\n\n\n\n

G

\n
\n
get(Type, Annotation[], Retrofit) - Method in class retrofit2.adapter.rxjava2.RxJava2CallAdapterFactory
\n
 
\n
\n\n\n\n

H

\n
\n
HttpException - Exception in retrofit2.adapter.rxjava2
\n
\n
Deprecated.\n
Use HttpException.
\n
\n
\n
HttpException(Response<?>) - Constructor for exception retrofit2.adapter.rxjava2.HttpException
\n
\n
Deprecated.
\n 
\n
\n\n\n\n

I

\n
\n
isError() - Method in class retrofit2.adapter.rxjava2.Result
\n
\n
true if the request resulted in an error.
\n
\n
\n\n\n\n

R

\n
\n
response(Response<T>) - Static method in class retrofit2.adapter.rxjava2.Result
\n
 
\n
response() - Method in class retrofit2.adapter.rxjava2.Result
\n
\n
The response received from executing an HTTP request.
\n
\n
Result<T> - Class in retrofit2.adapter.rxjava2
\n
\n
The result of executing an HTTP request.
\n
\n
retrofit2.adapter.rxjava2 - package retrofit2.adapter.rxjava2
\n
 
\n
RxJava2CallAdapterFactory - Class in retrofit2.adapter.rxjava2
\n
\n
A call adapter which uses RxJava 2 for creating observables.
\n
\n
\nC E G H I R 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava2/index.html", "content": "\n\n\n\n\nrxjava2 API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit2/adapter/rxjava2/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava2/overview-tree.html", "content": "\n\n\n\n\nClass Hierarchy (rxjava2 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n
      \n
    • retrofit2.CallAdapter.Factory\n\n
      • \n
    • retrofit2.adapter.rxjava2.Result<T>
      • \n
    • java.lang.Throwable (implements java.io.Serializable)\n
        \n
      • java.lang.Exception\n
          \n
        • java.lang.RuntimeException\n
            \n
          • retrofit2.HttpException\n\n
            • \n
          \n
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava2/package-list", "content": "retrofit2.adapter.rxjava2\n" }, { "path": "website/public/2.x/adapter-rxjava2/retrofit2/adapter/rxjava2/HttpException.html", "content": "\n\n\n\n\nHttpException (rxjava2 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.adapter.rxjava2
\n

Class HttpException

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • java.lang.Throwable
      • \n
    • \n
        \n
      • java.lang.Exception
        • \n
      • \n
          \n
        • java.lang.RuntimeException
          • \n
        • \n
            \n
          • retrofit2.HttpException
            • \n
          • \n
              \n
            • retrofit2.adapter.rxjava2.HttpException
              • \n
            \n
            • \n
          \n
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    java.io.Serializable
    \n
    \n
    \n
    Deprecated. \n
    Use HttpException.
    \n
    \n
    \n
    @Deprecated\npublic final class HttpException\nextends retrofit2.HttpException
    \n
    \n
    See Also:
    \n
    Serialized Form
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Summary

      \n\n\n\n\n\n\n\n\n
      Constructors 
      Constructor and Description
      HttpException(retrofit2.Response<?> response)\n
      Deprecated. 
      \n 
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Summary

      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.HttpException

        \ncode, message, response
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Throwable

        \naddSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        HttpException

        \n
        public HttpException(retrofit2.Response<?> response)
        \n
        Deprecated. 
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava2/retrofit2/adapter/rxjava2/Result.html", "content": "\n\n\n\n\nResult (rxjava2 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.adapter.rxjava2
\n

Class Result<T>

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • retrofit2.adapter.rxjava2.Result<T>
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public final class Result<T>\nextends java.lang.Object
    \n
    The result of executing an HTTP request.
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      java.lang.Throwableerror()\n
      The error experienced while attempting to execute an HTTP request.
      \n
      static <T> Result<T>error(java.lang.Throwable error) 
      booleanisError()\n
      true if the request resulted in an error.
      \n
      retrofit2.Response<T>response()\n
      The response received from executing an HTTP request.
      \n
      static <T> Result<T>response(retrofit2.Response<T> response) 
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        error

        \n
        public static <T> Result<T> error(java.lang.Throwable error)
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        response

        \n
        public static <T> Result<T> response(retrofit2.Response<T> response)
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        response

        \n
        @Nullable\npublic retrofit2.Response<T> response()
        \n
        The response received from executing an HTTP request. Only present when isError() is\n false, null otherwise.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        error

        \n
        @Nullable\npublic java.lang.Throwable error()
        \n
        The error experienced while attempting to execute an HTTP request. Only present when isError() is true, null otherwise.\n\n

        If the error is an IOException then there was a problem with the transport to the\n remote server. Any other exception type indicates an unexpected failure and should be\n considered fatal (configuration error, programming error, etc.).

        \n
        • \n
      \n\n\n\n
        \n
      • \n

        isError

        \n
        public boolean isError()
        \n
        true if the request resulted in an error. See error() for the cause.
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava2/retrofit2/adapter/rxjava2/RxJava2CallAdapterFactory.html", "content": "\n\n\n\n\nRxJava2CallAdapterFactory (rxjava2 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.adapter.rxjava2
\n

Class RxJava2CallAdapterFactory

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • retrofit2.CallAdapter.Factory
      • \n
    • \n
        \n
      • retrofit2.adapter.rxjava2.RxJava2CallAdapterFactory
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public final class RxJava2CallAdapterFactory\nextends retrofit2.CallAdapter.Factory
    \n
    A call adapter which uses RxJava 2 for creating observables.\n\n

    Adding this class to Retrofit allows you to return an Observable, Flowable, Single, Completable or Maybe from service methods.\n\n 

    \n interface MyService {\n   @GET(\"user/me\")\n   Observable<User> getUser()\n }\n
    \n\n There are three configurations supported for the Observable, Flowable, Single, Completable and Maybe type parameter:\n\n
      \n
    • Direct body (e.g., Observable<User>) calls onNext with the deserialized\n body for 2XX responses and calls onError with HttpException for non-2XX\n responses and IOException for network errors.\n
    • Response wrapped body (e.g., Observable<Response<User>>) calls onNext with\n a Response object for all HTTP responses and calls onError with IOException for network errors\n
    • Result wrapped body (e.g., Observable<Result<User>>) calls onNext with a\n Result object for all HTTP responses and errors.\n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static RxJava2CallAdapterFactorycreate()\n
      Returns an instance which creates synchronous observables that do not operate on any scheduler\n by default.
      \n
      static RxJava2CallAdapterFactorycreateAsync()\n
      Returns an instance which creates asynchronous observables.
      \n
      static RxJava2CallAdapterFactorycreateWithScheduler(io.reactivex.Scheduler scheduler)\n
      Returns an instance which creates synchronous observables that subscribe on scheduler by default.
      \n
      retrofit2.CallAdapter<?,?>get(java.lang.reflect.Type returnType,\n java.lang.annotation.Annotation[] annotations,\n retrofit2.Retrofit retrofit) 
      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.CallAdapter.Factory

        \ngetParameterUpperBound, getRawType
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        create

        \n
        public static RxJava2CallAdapterFactory create()
        \n
        Returns an instance which creates synchronous observables that do not operate on any scheduler\n by default.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        createAsync

        \n
        public static RxJava2CallAdapterFactory createAsync()
        \n
        Returns an instance which creates asynchronous observables.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        createWithScheduler

        \n
        public static RxJava2CallAdapterFactory createWithScheduler(io.reactivex.Scheduler scheduler)
        \n
        Returns an instance which creates synchronous observables that subscribe on scheduler by default.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        get

        \n
        @Nullable\npublic retrofit2.CallAdapter<?,?> get(java.lang.reflect.Type returnType,\n                                                java.lang.annotation.Annotation[] annotations,\n                                                retrofit2.Retrofit retrofit)
        \n
        \n
        Specified by:
        \n
        get in class retrofit2.CallAdapter.Factory
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava2/retrofit2/adapter/rxjava2/package-frame.html", "content": "\n\n\n\n\nretrofit2.adapter.rxjava2 (rxjava2 API)\n\n\n\n\n

retrofit2.adapter.rxjava2

\n
\n

Classes

\n\n

Exceptions

\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava2/retrofit2/adapter/rxjava2/package-summary.html", "content": "\n\n\n\n\nretrofit2.adapter.rxjava2 (rxjava2 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

@EverythingIsNonNull\n

\n

Package retrofit2.adapter.rxjava2

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    Result<T>\n
    The result of executing an HTTP request.
    \n
    RxJava2CallAdapterFactory\n
    A call adapter which uses RxJava 2 for creating observables.
    \n
    \n
    • \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Exception Summary 
    ExceptionDescription
    HttpExceptionDeprecated\n
    Use HttpException.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava2/retrofit2/adapter/rxjava2/package-tree.html", "content": "\n\n\n\n\nretrofit2.adapter.rxjava2 Class Hierarchy (rxjava2 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit2.adapter.rxjava2

\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n
      \n
    • retrofit2.CallAdapter.Factory\n\n
      • \n
    • retrofit2.adapter.rxjava2.Result<T>
      • \n
    • java.lang.Throwable (implements java.io.Serializable)\n
        \n
      • java.lang.Exception\n
          \n
        • java.lang.RuntimeException\n
            \n
          • retrofit2.HttpException\n\n
            • \n
          \n
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava2/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/2.x/adapter-rxjava2/serialized-form.html", "content": "\n\n\n\n\nSerialized Form (rxjava2 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Serialized Form

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava2/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.useSummary td.colFirst, .useSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/2.x/adapter-rxjava3/allclasses-frame.html", "content": "\n\n\n\n\nAll Classes (rxjava3 API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava3/allclasses-noframe.html", "content": "\n\n\n\n\nAll Classes (rxjava3 API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava3/constant-values.html", "content": "\n\n\n\n\nConstant Field Values (rxjava3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava3/deprecated-list.html", "content": "\n\n\n\n\nDeprecated List (rxjava3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n\n
\n
\n\n\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava3/help-doc.html", "content": "\n\n\n\n\nAPI Help (rxjava3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava3/index-all.html", "content": "\n\n\n\n\nIndex (rxjava3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
C E G H I R \n\n\n

C

\n
\n
create() - Static method in class retrofit2.adapter.rxjava3.RxJava3CallAdapterFactory
\n
\n
Returns an instance which creates asynchronous observables that run on a background thread by\n default.
\n
\n
createSynchronous() - Static method in class retrofit2.adapter.rxjava3.RxJava3CallAdapterFactory
\n
\n
Returns an instance which creates synchronous observables that do not operate on any scheduler\n by default.
\n
\n
createWithScheduler(Scheduler) - Static method in class retrofit2.adapter.rxjava3.RxJava3CallAdapterFactory
\n
\n
Returns an instance which creates synchronous observables that subscribeOn(..) the\n supplied scheduler by default.
\n
\n
\n\n\n\n

E

\n
\n
error(Throwable) - Static method in class retrofit2.adapter.rxjava3.Result
\n
 
\n
error() - Method in class retrofit2.adapter.rxjava3.Result
\n
\n
The error experienced while attempting to execute an HTTP request.
\n
\n
\n\n\n\n

G

\n
\n
get(Type, Annotation[], Retrofit) - Method in class retrofit2.adapter.rxjava3.RxJava3CallAdapterFactory
\n
 
\n
\n\n\n\n

H

\n
\n
HttpException - Exception in retrofit2.adapter.rxjava3
\n
\n
Deprecated.\n
Use HttpException.
\n
\n
\n
HttpException(Response<?>) - Constructor for exception retrofit2.adapter.rxjava3.HttpException
\n
\n
Deprecated.
\n 
\n
\n\n\n\n

I

\n
\n
isError() - Method in class retrofit2.adapter.rxjava3.Result
\n
\n
true if the request resulted in an error.
\n
\n
\n\n\n\n

R

\n
\n
response(Response<T>) - Static method in class retrofit2.adapter.rxjava3.Result
\n
 
\n
response() - Method in class retrofit2.adapter.rxjava3.Result
\n
\n
The response received from executing an HTTP request.
\n
\n
Result<T> - Class in retrofit2.adapter.rxjava3
\n
\n
The result of executing an HTTP request.
\n
\n
retrofit2.adapter.rxjava3 - package retrofit2.adapter.rxjava3
\n
 
\n
RxJava3CallAdapterFactory - Class in retrofit2.adapter.rxjava3
\n
\n
A call adapter which uses RxJava 3 for creating observables.
\n
\n
\nC E G H I R 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava3/index.html", "content": "\n\n\n\n\nrxjava3 API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit2/adapter/rxjava3/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava3/overview-tree.html", "content": "\n\n\n\n\nClass Hierarchy (rxjava3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n
      \n
    • retrofit2.CallAdapter.Factory\n\n
      • \n
    • retrofit2.adapter.rxjava3.Result<T>
      • \n
    • java.lang.Throwable (implements java.io.Serializable)\n
        \n
      • java.lang.Exception\n
          \n
        • java.lang.RuntimeException\n
            \n
          • retrofit2.HttpException\n\n
            • \n
          \n
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava3/package-list", "content": "retrofit2.adapter.rxjava3\n" }, { "path": "website/public/2.x/adapter-rxjava3/retrofit2/adapter/rxjava3/HttpException.html", "content": "\n\n\n\n\nHttpException (rxjava3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.adapter.rxjava3
\n

Class HttpException

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • java.lang.Throwable
      • \n
    • \n
        \n
      • java.lang.Exception
        • \n
      • \n
          \n
        • java.lang.RuntimeException
          • \n
        • \n
            \n
          • retrofit2.HttpException
            • \n
          • \n
              \n
            • retrofit2.adapter.rxjava3.HttpException
              • \n
            \n
            • \n
          \n
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    All Implemented Interfaces:
    \n
    java.io.Serializable
    \n
    \n
    \n
    Deprecated. \n
    Use HttpException.
    \n
    \n
    \n
    @Deprecated\npublic final class HttpException\nextends retrofit2.HttpException
    \n
    \n
    See Also:
    \n
    Serialized Form
    \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Summary

      \n\n\n\n\n\n\n\n\n
      Constructors 
      Constructor and Description
      HttpException(retrofit2.Response<?> response)\n
      Deprecated. 
      \n 
      \n
      • \n
    \n\n
      \n
    • \n\n\n

      Method Summary

      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.HttpException

        \ncode, message, response
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Throwable

        \naddSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Constructor Detail

      \n\n\n\n
        \n
      • \n

        HttpException

        \n
        public HttpException(retrofit2.Response<?> response)
        \n
        Deprecated. 
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava3/retrofit2/adapter/rxjava3/Result.html", "content": "\n\n\n\n\nResult (rxjava3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.adapter.rxjava3
\n

Class Result<T>

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • retrofit2.adapter.rxjava3.Result<T>
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public final class Result<T>\nextends java.lang.Object
    \n
    The result of executing an HTTP request.
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      java.lang.Throwableerror()\n
      The error experienced while attempting to execute an HTTP request.
      \n
      static <T> Result<T>error(java.lang.Throwable error) 
      booleanisError()\n
      true if the request resulted in an error.
      \n
      retrofit2.Response<T>response()\n
      The response received from executing an HTTP request.
      \n
      static <T> Result<T>response(retrofit2.Response<T> response) 
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        error

        \n
        public static <T> Result<T> error(java.lang.Throwable error)
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        response

        \n
        public static <T> Result<T> response(retrofit2.Response<T> response)
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        response

        \n
        @Nullable\npublic retrofit2.Response<T> response()
        \n
        The response received from executing an HTTP request. Only present when isError() is\n false, null otherwise.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        error

        \n
        @Nullable\npublic java.lang.Throwable error()
        \n
        The error experienced while attempting to execute an HTTP request. Only present when isError() is true, null otherwise.\n\n

        If the error is an IOException then there was a problem with the transport to the\n remote server. Any other exception type indicates an unexpected failure and should be\n considered fatal (configuration error, programming error, etc.).

        \n
        • \n
      \n\n\n\n
        \n
      • \n

        isError

        \n
        public boolean isError()
        \n
        true if the request resulted in an error. See error() for the cause.
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava3/retrofit2/adapter/rxjava3/RxJava3CallAdapterFactory.html", "content": "\n\n\n\n\nRxJava3CallAdapterFactory (rxjava3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.adapter.rxjava3
\n

Class RxJava3CallAdapterFactory

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • retrofit2.CallAdapter.Factory
      • \n
    • \n
        \n
      • retrofit2.adapter.rxjava3.RxJava3CallAdapterFactory
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public final class RxJava3CallAdapterFactory\nextends retrofit2.CallAdapter.Factory
    \n
    A call adapter which uses RxJava 3 for creating observables.\n\n

    Adding this class to Retrofit allows you to return an Observable, Flowable, Single, Completable or Maybe from service methods.\n\n 

    \n interface MyService {\n   @GET(\"user/me\")\n   Observable<User> getUser()\n }\n
    \n\n There are three configurations supported for the Observable, Flowable, Single, Completable and Maybe type parameter:\n\n
      \n
    • Direct body (e.g., Observable<User>) calls onNext with the deserialized\n body for 2XX responses and calls onError with HttpException for non-2XX\n responses and IOException for network errors.\n
    • Response wrapped body (e.g., Observable<Response<User>>) calls onNext with\n a Response object for all HTTP responses and calls onError with IOException for network errors\n
    • Result wrapped body (e.g., Observable<Result<User>>) calls onNext with a\n Result object for all HTTP responses and errors.\n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static RxJava3CallAdapterFactorycreate()\n
      Returns an instance which creates asynchronous observables that run on a background thread by\n default.
      \n
      static RxJava3CallAdapterFactorycreateSynchronous()\n
      Returns an instance which creates synchronous observables that do not operate on any scheduler\n by default.
      \n
      static RxJava3CallAdapterFactorycreateWithScheduler(io.reactivex.rxjava3.core.Scheduler scheduler)\n
      Returns an instance which creates synchronous observables that subscribeOn(..) the\n supplied scheduler by default.
      \n
      retrofit2.CallAdapter<?,?>get(java.lang.reflect.Type returnType,\n java.lang.annotation.Annotation[] annotations,\n retrofit2.Retrofit retrofit) 
      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.CallAdapter.Factory

        \ngetParameterUpperBound, getRawType
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        create

        \n
        public static RxJava3CallAdapterFactory create()
        \n
        Returns an instance which creates asynchronous observables that run on a background thread by\n default. Applying subscribeOn(..) has no effect on instances created by the returned\n factory.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        createSynchronous

        \n
        public static RxJava3CallAdapterFactory createSynchronous()
        \n
        Returns an instance which creates synchronous observables that do not operate on any scheduler\n by default. Applying subscribeOn(..) will change the scheduler on which the HTTP calls\n are made.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        createWithScheduler

        \n
        public static RxJava3CallAdapterFactory createWithScheduler(io.reactivex.rxjava3.core.Scheduler scheduler)
        \n
        Returns an instance which creates synchronous observables that subscribeOn(..) the\n supplied scheduler by default.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        get

        \n
        @Nullable\npublic retrofit2.CallAdapter<?,?> get(java.lang.reflect.Type returnType,\n                                                java.lang.annotation.Annotation[] annotations,\n                                                retrofit2.Retrofit retrofit)
        \n
        \n
        Specified by:
        \n
        get in class retrofit2.CallAdapter.Factory
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava3/retrofit2/adapter/rxjava3/package-frame.html", "content": "\n\n\n\n\nretrofit2.adapter.rxjava3 (rxjava3 API)\n\n\n\n\n

retrofit2.adapter.rxjava3

\n
\n

Classes

\n\n

Exceptions

\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava3/retrofit2/adapter/rxjava3/package-summary.html", "content": "\n\n\n\n\nretrofit2.adapter.rxjava3 (rxjava3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

@EverythingIsNonNull\n

\n

Package retrofit2.adapter.rxjava3

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    Result<T>\n
    The result of executing an HTTP request.
    \n
    RxJava3CallAdapterFactory\n
    A call adapter which uses RxJava 3 for creating observables.
    \n
    \n
    • \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Exception Summary 
    ExceptionDescription
    HttpExceptionDeprecated\n
    Use HttpException.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava3/retrofit2/adapter/rxjava3/package-tree.html", "content": "\n\n\n\n\nretrofit2.adapter.rxjava3 Class Hierarchy (rxjava3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit2.adapter.rxjava3

\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n
      \n
    • retrofit2.CallAdapter.Factory\n\n
      • \n
    • retrofit2.adapter.rxjava3.Result<T>
      • \n
    • java.lang.Throwable (implements java.io.Serializable)\n
        \n
      • java.lang.Exception\n
          \n
        • java.lang.RuntimeException\n
            \n
          • retrofit2.HttpException\n\n
            • \n
          \n
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava3/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/2.x/adapter-rxjava3/serialized-form.html", "content": "\n\n\n\n\nSerialized Form (rxjava3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Serialized Form

\n
\n
\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-rxjava3/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.useSummary td.colFirst, .useSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/2.x/adapter-scala/allclasses-frame.html", "content": "\n\n\n\n\nAll Classes (scala API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-scala/allclasses-noframe.html", "content": "\n\n\n\n\nAll Classes (scala API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-scala/constant-values.html", "content": "\n\n\n\n\nConstant Field Values (scala API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-scala/deprecated-list.html", "content": "\n\n\n\n\nDeprecated List (scala API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-scala/help-doc.html", "content": "\n\n\n\n\nAPI Help (scala API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-scala/index-all.html", "content": "\n\n\n\n\nIndex (scala API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
C G R S \n\n\n

C

\n
\n
create() - Static method in class retrofit2.adapter.scala.ScalaCallAdapterFactory
\n
 
\n
\n\n\n\n

G

\n
\n
get(Type, Annotation[], Retrofit) - Method in class retrofit2.adapter.scala.ScalaCallAdapterFactory
\n
 
\n
\n\n\n\n

R

\n
\n
retrofit2.adapter.scala - package retrofit2.adapter.scala
\n
 
\n
\n\n\n\n

S

\n
\n
ScalaCallAdapterFactory - Class in retrofit2.adapter.scala
\n
\n
A call adapter which creates Scala futures.
\n
\n
\nC G R S 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-scala/index.html", "content": "\n\n\n\n\nscala API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit2/adapter/scala/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/2.x/adapter-scala/overview-tree.html", "content": "\n\n\n\n\nClass Hierarchy (scala API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-scala/package-list", "content": "retrofit2.adapter.scala\n" }, { "path": "website/public/2.x/adapter-scala/retrofit2/adapter/scala/ScalaCallAdapterFactory.html", "content": "\n\n\n\n\nScalaCallAdapterFactory (scala API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.adapter.scala
\n

Class ScalaCallAdapterFactory

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • retrofit2.CallAdapter.Factory
      • \n
    • \n
        \n
      • retrofit2.adapter.scala.ScalaCallAdapterFactory
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public final class ScalaCallAdapterFactory\nextends retrofit2.CallAdapter.Factory
    \n
    A call adapter which creates Scala futures.\n\n

    Adding this class to Retrofit allows you to return Future from service\n methods.\n\n 

    \n interface MyService {\n   @GET(\"user/me\")\n   Future<User> getUser()\n }\n
    \n\n There are two configurations supported for the Future type parameter:\n\n
      \n
    • Direct body (e.g., Future<User>) returns the deserialized body for 2XX responses,\n sets HttpException errors for non-2XX responses, and sets\n IOException for network errors.\n
    • Response wrapped body (e.g., Future<Response<User>>) returns a Response\n object for all HTTP responses and sets IOException for network errors\n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static ScalaCallAdapterFactorycreate() 
      retrofit2.CallAdapter<?,?>get(java.lang.reflect.Type returnType,\n java.lang.annotation.Annotation[] annotations,\n retrofit2.Retrofit retrofit) 
      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.CallAdapter.Factory

        \ngetParameterUpperBound, getRawType
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n\n\n\n\n
        \n
      • \n

        get

        \n
        @Nullable\npublic retrofit2.CallAdapter<?,?> get(java.lang.reflect.Type returnType,\n                                                java.lang.annotation.Annotation[] annotations,\n                                                retrofit2.Retrofit retrofit)
        \n
        \n
        Specified by:
        \n
        get in class retrofit2.CallAdapter.Factory
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-scala/retrofit2/adapter/scala/package-frame.html", "content": "\n\n\n\n\nretrofit2.adapter.scala (scala API)\n\n\n\n\n

retrofit2.adapter.scala

\n
\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/2.x/adapter-scala/retrofit2/adapter/scala/package-summary.html", "content": "\n\n\n\n\nretrofit2.adapter.scala (scala API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

@EverythingIsNonNull\n

\n

Package retrofit2.adapter.scala

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    ScalaCallAdapterFactory\n
    A call adapter which creates Scala futures.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-scala/retrofit2/adapter/scala/package-tree.html", "content": "\n\n\n\n\nretrofit2.adapter.scala Class Hierarchy (scala API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit2.adapter.scala

\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/adapter-scala/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/2.x/adapter-scala/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.useSummary td.colFirst, .useSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/2.x/converter-gson/allclasses-frame.html", "content": "\n\n\n\n\nAll Classes (gson API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-gson/allclasses-noframe.html", "content": "\n\n\n\n\nAll Classes (gson API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-gson/constant-values.html", "content": "\n\n\n\n\nConstant Field Values (gson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-gson/deprecated-list.html", "content": "\n\n\n\n\nDeprecated List (gson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-gson/help-doc.html", "content": "\n\n\n\n\nAPI Help (gson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-gson/index-all.html", "content": "\n\n\n\n\nIndex (gson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
C G R W \n\n\n

C

\n
\n
create() - Static method in class retrofit2.converter.gson.GsonConverterFactory
\n
\n
Create an instance using a default Gson instance for conversion.
\n
\n
create(Gson) - Static method in class retrofit2.converter.gson.GsonConverterFactory
\n
\n
Create an instance using gson for conversion.
\n
\n
\n\n\n\n

G

\n
\n
GsonConverterFactory - Class in retrofit2.converter.gson
\n
\n
A converter which uses Gson for JSON.
\n
\n
\n\n\n\n

R

\n
\n
requestBodyConverter(Type, Annotation[], Annotation[], Retrofit) - Method in class retrofit2.converter.gson.GsonConverterFactory
\n
 
\n
responseBodyConverter(Type, Annotation[], Retrofit) - Method in class retrofit2.converter.gson.GsonConverterFactory
\n
 
\n
retrofit2.converter.gson - package retrofit2.converter.gson
\n
 
\n
\n\n\n\n

W

\n
\n
withStreaming() - Method in class retrofit2.converter.gson.GsonConverterFactory
\n
\n
Return a new factory which streams serialization of request messages to bytes on the HTTP thread\n This is either the calling thread for Call.execute(), or one of OkHttp's background\n threads for Call.enqueue(retrofit2.Callback<T>).
\n
\n
\nC G R W 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-gson/index.html", "content": "\n\n\n\n\ngson API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit2/converter/gson/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/2.x/converter-gson/overview-tree.html", "content": "\n\n\n\n\nClass Hierarchy (gson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n\n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-gson/package-list", "content": "retrofit2.converter.gson\n" }, { "path": "website/public/2.x/converter-gson/retrofit2/converter/gson/GsonConverterFactory.html", "content": "\n\n\n\n\nGsonConverterFactory (gson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.converter.gson
\n

Class GsonConverterFactory

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • retrofit2.Converter.Factory
      • \n
    • \n
        \n
      • retrofit2.converter.gson.GsonConverterFactory
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public final class GsonConverterFactory\nextends retrofit2.Converter.Factory
    \n
    A converter which uses Gson for JSON.\n\n

    Because Gson is so flexible in the types it supports, this converter assumes that it can\n handle all types. If you are mixing JSON serialization with something else (such as protocol\n buffers), you must add this\n instance last to allow the other converters a chance to see their types.

    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static GsonConverterFactorycreate()\n
      Create an instance using a default Gson instance for conversion.
      \n
      static GsonConverterFactorycreate(com.google.gson.Gson gson)\n
      Create an instance using gson for conversion.
      \n
      retrofit2.Converter<?,okhttp3.RequestBody>requestBodyConverter(java.lang.reflect.Type type,\n java.lang.annotation.Annotation[] parameterAnnotations,\n java.lang.annotation.Annotation[] methodAnnotations,\n retrofit2.Retrofit retrofit) 
      retrofit2.Converter<okhttp3.ResponseBody,?>responseBodyConverter(java.lang.reflect.Type type,\n java.lang.annotation.Annotation[] annotations,\n retrofit2.Retrofit retrofit) 
      GsonConverterFactorywithStreaming()\n
      Return a new factory which streams serialization of request messages to bytes on the HTTP thread\n This is either the calling thread for Call.execute(), or one of OkHttp's background\n threads for Call.enqueue(retrofit2.Callback<T>).
      \n
      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.Converter.Factory

        \ngetParameterUpperBound, getRawType, stringConverter
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        create

        \n
        public static GsonConverterFactory create()
        \n
        Create an instance using a default Gson instance for conversion. Encoding to JSON and\n decoding from JSON (when no charset is specified by a header) will use UTF-8.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        create

        \n
        public static GsonConverterFactory create(com.google.gson.Gson gson)
        \n
        Create an instance using gson for conversion. Encoding to JSON and decoding from JSON\n (when no charset is specified by a header) will use UTF-8.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        withStreaming

        \n
        public GsonConverterFactory withStreaming()
        \n
        Return a new factory which streams serialization of request messages to bytes on the HTTP thread\n This is either the calling thread for Call.execute(), or one of OkHttp's background\n threads for Call.enqueue(retrofit2.Callback<T>). Response bytes are always converted to message instances on\n one of OkHttp's background threads.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        responseBodyConverter

        \n
        public retrofit2.Converter<okhttp3.ResponseBody,?> responseBodyConverter(java.lang.reflect.Type type,\n                                                                         java.lang.annotation.Annotation[] annotations,\n                                                                         retrofit2.Retrofit retrofit)
        \n
        \n
        Overrides:
        \n
        responseBodyConverter in class retrofit2.Converter.Factory
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        requestBodyConverter

        \n
        public retrofit2.Converter<?,okhttp3.RequestBody> requestBodyConverter(java.lang.reflect.Type type,\n                                                                       java.lang.annotation.Annotation[] parameterAnnotations,\n                                                                       java.lang.annotation.Annotation[] methodAnnotations,\n                                                                       retrofit2.Retrofit retrofit)
        \n
        \n
        Overrides:
        \n
        requestBodyConverter in class retrofit2.Converter.Factory
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-gson/retrofit2/converter/gson/package-frame.html", "content": "\n\n\n\n\nretrofit2.converter.gson (gson API)\n\n\n\n\n

retrofit2.converter.gson

\n
\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-gson/retrofit2/converter/gson/package-summary.html", "content": "\n\n\n\n\nretrofit2.converter.gson (gson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

@EverythingIsNonNull\n

\n

Package retrofit2.converter.gson

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    GsonConverterFactory\n
    A converter which uses Gson for JSON.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-gson/retrofit2/converter/gson/package-tree.html", "content": "\n\n\n\n\nretrofit2.converter.gson Class Hierarchy (gson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit2.converter.gson

\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n\n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-gson/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/2.x/converter-gson/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.useSummary td.colFirst, .useSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/2.x/converter-guava/allclasses-frame.html", "content": "\n\n\n\n\nAll Classes (guava API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-guava/allclasses-noframe.html", "content": "\n\n\n\n\nAll Classes (guava API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-guava/constant-values.html", "content": "\n\n\n\n\nConstant Field Values (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-guava/deprecated-list.html", "content": "\n\n\n\n\nDeprecated List (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-guava/help-doc.html", "content": "\n\n\n\n\nAPI Help (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-guava/index-all.html", "content": "\n\n\n\n\nIndex (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
C G R \n\n\n

C

\n
\n
create() - Static method in class retrofit.converter.guava.GuavaOptionalConverterFactory
\n
 
\n
\n\n\n\n

G

\n
\n
GuavaOptionalConverterFactory - Class in retrofit.converter.guava
\n
\n
A converter for Optional<T> which delegates to another\n converter to deserialize T and then wraps it into Optional.
\n
\n
\n\n\n\n

R

\n
\n
responseBodyConverter(Type, Annotation[], Retrofit) - Method in class retrofit.converter.guava.GuavaOptionalConverterFactory
\n
 
\n
retrofit.converter.guava - package retrofit.converter.guava
\n
 
\n
\nC G R 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-guava/index.html", "content": "\n\n\n\n\nguava API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit/converter/guava/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/2.x/converter-guava/overview-tree.html", "content": "\n\n\n\n\nClass Hierarchy (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-guava/package-list", "content": "retrofit.converter.guava\n" }, { "path": "website/public/2.x/converter-guava/retrofit/converter/guava/GuavaOptionalConverterFactory.html", "content": "\n\n\n\n\nGuavaOptionalConverterFactory (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.converter.guava
\n

Class GuavaOptionalConverterFactory

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • retrofit2.Converter.Factory
      • \n
    • \n
        \n
      • retrofit.converter.guava.GuavaOptionalConverterFactory
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public final class GuavaOptionalConverterFactory\nextends retrofit2.Converter.Factory
    \n
    A converter for Optional<T> which delegates to another\n converter to deserialize T and then wraps it into Optional.
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static GuavaOptionalConverterFactorycreate() 
      retrofit2.Converter<okhttp3.ResponseBody,?>responseBodyConverter(java.lang.reflect.Type type,\n java.lang.annotation.Annotation[] annotations,\n retrofit2.Retrofit retrofit) 
      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.Converter.Factory

        \ngetParameterUpperBound, getRawType, requestBodyConverter, stringConverter
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n\n\n\n\n
        \n
      • \n

        responseBodyConverter

        \n
        @Nullable\npublic retrofit2.Converter<okhttp3.ResponseBody,?> responseBodyConverter(java.lang.reflect.Type type,\n                                                                                   java.lang.annotation.Annotation[] annotations,\n                                                                                   retrofit2.Retrofit retrofit)
        \n
        \n
        Overrides:
        \n
        responseBodyConverter in class retrofit2.Converter.Factory
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-guava/retrofit/converter/guava/package-frame.html", "content": "\n\n\n\n\nretrofit.converter.guava (guava API)\n\n\n\n\n

retrofit.converter.guava

\n
\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-guava/retrofit/converter/guava/package-summary.html", "content": "\n\n\n\n\nretrofit.converter.guava (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

@EverythingIsNonNull\n

\n

Package retrofit.converter.guava

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    GuavaOptionalConverterFactory\n
    A converter for Optional<T> which delegates to another\n converter to deserialize T and then wraps it into Optional.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-guava/retrofit/converter/guava/package-tree.html", "content": "\n\n\n\n\nretrofit.converter.guava Class Hierarchy (guava API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit.converter.guava

\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-guava/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/2.x/converter-guava/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.useSummary td.colFirst, .useSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/2.x/converter-jackson/allclasses-frame.html", "content": "\n\n\n\n\nAll Classes (jackson API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-jackson/allclasses-noframe.html", "content": "\n\n\n\n\nAll Classes (jackson API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-jackson/constant-values.html", "content": "\n\n\n\n\nConstant Field Values (jackson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jackson/deprecated-list.html", "content": "\n\n\n\n\nDeprecated List (jackson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jackson/help-doc.html", "content": "\n\n\n\n\nAPI Help (jackson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jackson/index-all.html", "content": "\n\n\n\n\nIndex (jackson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
C J R W \n\n\n

C

\n
\n
create() - Static method in class retrofit2.converter.jackson.JacksonConverterFactory
\n
\n
Create an instance using a default ObjectMapper instance for conversion.
\n
\n
create(ObjectMapper) - Static method in class retrofit2.converter.jackson.JacksonConverterFactory
\n
\n
Create an instance using mapper for conversion.
\n
\n
create(ObjectMapper, MediaType) - Static method in class retrofit2.converter.jackson.JacksonConverterFactory
\n
\n
Create an instance using mapper and mediaType for conversion.
\n
\n
\n\n\n\n

J

\n
\n
JacksonConverterFactory - Class in retrofit2.converter.jackson
\n
\n
A converter which uses Jackson.
\n
\n
\n\n\n\n

R

\n
\n
requestBodyConverter(Type, Annotation[], Annotation[], Retrofit) - Method in class retrofit2.converter.jackson.JacksonConverterFactory
\n
 
\n
responseBodyConverter(Type, Annotation[], Retrofit) - Method in class retrofit2.converter.jackson.JacksonConverterFactory
\n
 
\n
retrofit2.converter.jackson - package retrofit2.converter.jackson
\n
 
\n
\n\n\n\n

W

\n
\n
withStreaming() - Method in class retrofit2.converter.jackson.JacksonConverterFactory
\n
\n
Return a new factory which streams serialization of request messages to bytes on the HTTP thread\n This is either the calling thread for Call.execute(), or one of OkHttp's background\n threads for Call.enqueue(retrofit2.Callback<T>).
\n
\n
\nC J R W 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jackson/index.html", "content": "\n\n\n\n\njackson API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit2/converter/jackson/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/2.x/converter-jackson/overview-tree.html", "content": "\n\n\n\n\nClass Hierarchy (jackson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jackson/package-list", "content": "retrofit2.converter.jackson\n" }, { "path": "website/public/2.x/converter-jackson/retrofit2/converter/jackson/JacksonConverterFactory.html", "content": "\n\n\n\n\nJacksonConverterFactory (jackson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.converter.jackson
\n

Class JacksonConverterFactory

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • retrofit2.Converter.Factory
      • \n
    • \n
        \n
      • retrofit2.converter.jackson.JacksonConverterFactory
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public final class JacksonConverterFactory\nextends retrofit2.Converter.Factory
    \n
    A converter which uses Jackson.\n\n

    Because Jackson is so flexible in the types it supports, this converter assumes that it can\n handle all types. If you are mixing JSON serialization with something else (such as protocol\n buffers), you must add this\n instance last to allow the other converters a chance to see their types.

    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static JacksonConverterFactorycreate()\n
      Create an instance using a default ObjectMapper instance for conversion.
      \n
      static JacksonConverterFactorycreate(com.fasterxml.jackson.databind.ObjectMapper mapper)\n
      Create an instance using mapper for conversion.
      \n
      static JacksonConverterFactorycreate(com.fasterxml.jackson.databind.ObjectMapper mapper,\n okhttp3.MediaType mediaType)\n
      Create an instance using mapper and mediaType for conversion.
      \n
      retrofit2.Converter<?,okhttp3.RequestBody>requestBodyConverter(java.lang.reflect.Type type,\n java.lang.annotation.Annotation[] parameterAnnotations,\n java.lang.annotation.Annotation[] methodAnnotations,\n retrofit2.Retrofit retrofit) 
      retrofit2.Converter<okhttp3.ResponseBody,?>responseBodyConverter(java.lang.reflect.Type type,\n java.lang.annotation.Annotation[] annotations,\n retrofit2.Retrofit retrofit) 
      JacksonConverterFactorywithStreaming()\n
      Return a new factory which streams serialization of request messages to bytes on the HTTP thread\n This is either the calling thread for Call.execute(), or one of OkHttp's background\n threads for Call.enqueue(retrofit2.Callback<T>).
      \n
      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.Converter.Factory

        \ngetParameterUpperBound, getRawType, stringConverter
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        create

        \n
        public static JacksonConverterFactory create()
        \n
        Create an instance using a default ObjectMapper instance for conversion.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        create

        \n
        public static JacksonConverterFactory create(com.fasterxml.jackson.databind.ObjectMapper mapper)
        \n
        Create an instance using mapper for conversion.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        create

        \n
        public static JacksonConverterFactory create(com.fasterxml.jackson.databind.ObjectMapper mapper,\n                                             okhttp3.MediaType mediaType)
        \n
        Create an instance using mapper and mediaType for conversion.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        withStreaming

        \n
        public JacksonConverterFactory withStreaming()
        \n
        Return a new factory which streams serialization of request messages to bytes on the HTTP thread\n This is either the calling thread for Call.execute(), or one of OkHttp's background\n threads for Call.enqueue(retrofit2.Callback<T>). Response bytes are always converted to message instances on\n one of OkHttp's background threads.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        responseBodyConverter

        \n
        public retrofit2.Converter<okhttp3.ResponseBody,?> responseBodyConverter(java.lang.reflect.Type type,\n                                                                         java.lang.annotation.Annotation[] annotations,\n                                                                         retrofit2.Retrofit retrofit)
        \n
        \n
        Overrides:
        \n
        responseBodyConverter in class retrofit2.Converter.Factory
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        requestBodyConverter

        \n
        public retrofit2.Converter<?,okhttp3.RequestBody> requestBodyConverter(java.lang.reflect.Type type,\n                                                                       java.lang.annotation.Annotation[] parameterAnnotations,\n                                                                       java.lang.annotation.Annotation[] methodAnnotations,\n                                                                       retrofit2.Retrofit retrofit)
        \n
        \n
        Overrides:
        \n
        requestBodyConverter in class retrofit2.Converter.Factory
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jackson/retrofit2/converter/jackson/package-frame.html", "content": "\n\n\n\n\nretrofit2.converter.jackson (jackson API)\n\n\n\n\n

retrofit2.converter.jackson

\n
\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-jackson/retrofit2/converter/jackson/package-summary.html", "content": "\n\n\n\n\nretrofit2.converter.jackson (jackson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

@EverythingIsNonNull\n

\n

Package retrofit2.converter.jackson

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    JacksonConverterFactory\n
    A converter which uses Jackson.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jackson/retrofit2/converter/jackson/package-tree.html", "content": "\n\n\n\n\nretrofit2.converter.jackson Class Hierarchy (jackson API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit2.converter.jackson

\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jackson/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/2.x/converter-jackson/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.useSummary td.colFirst, .useSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/2.x/converter-java8/allclasses-frame.html", "content": "\n\n\n\n\nAll Classes (java8 API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-java8/allclasses-noframe.html", "content": "\n\n\n\n\nAll Classes (java8 API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-java8/constant-values.html", "content": "\n\n\n\n\nConstant Field Values (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-java8/deprecated-list.html", "content": "\n\n\n\n\nDeprecated List (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n\n
\n
\n\n\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n
    Deprecated Classes 
    Class and Description
    retrofit.converter.java8.Java8OptionalConverterFactory\n
    Retrofit includes support for Optional. This no longer needs to be added to the\n Retrofit instance explicitly.\n

    A converter for Optional<T> which delegates to\n another converter to deserialize T and then wraps it into Optional.

    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-java8/help-doc.html", "content": "\n\n\n\n\nAPI Help (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-java8/index-all.html", "content": "\n\n\n\n\nIndex (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
C J R \n\n\n

C

\n
\n
create() - Static method in class retrofit.converter.java8.Java8OptionalConverterFactory
\n
\n
Deprecated.
\n 
\n
\n\n\n\n

J

\n
\n
Java8OptionalConverterFactory - Class in retrofit.converter.java8
\n
\n
Deprecated.\n
Retrofit includes support for Optional. This no longer needs to be added to the\n Retrofit instance explicitly.\n

A converter for Optional<T> which delegates to\n another converter to deserialize T and then wraps it into Optional.

\n
\n
\n
\n\n\n\n

R

\n
\n
responseBodyConverter(Type, Annotation[], Retrofit) - Method in class retrofit.converter.java8.Java8OptionalConverterFactory
\n
\n
Deprecated.
\n 
\n
retrofit.converter.java8 - package retrofit.converter.java8
\n
 
\n
\nC J R 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-java8/index.html", "content": "\n\n\n\n\njava8 API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit/converter/java8/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/2.x/converter-java8/overview-tree.html", "content": "\n\n\n\n\nClass Hierarchy (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-java8/package-list", "content": "retrofit.converter.java8\n" }, { "path": "website/public/2.x/converter-java8/retrofit/converter/java8/Java8OptionalConverterFactory.html", "content": "\n\n\n\n\nJava8OptionalConverterFactory (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit.converter.java8
\n

Class Java8OptionalConverterFactory

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • retrofit2.Converter.Factory
      • \n
    • \n
        \n
      • retrofit.converter.java8.Java8OptionalConverterFactory
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    Deprecated. \n
    Retrofit includes support for Optional. This no longer needs to be added to the\n Retrofit instance explicitly.\n

    A converter for Optional<T> which delegates to\n another converter to deserialize T and then wraps it into Optional.

    \n
    \n
    \n
    @Deprecated\npublic final class Java8OptionalConverterFactory\nextends retrofit2.Converter.Factory
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and TypeMethod and Description
      static Java8OptionalConverterFactorycreate()\n
      Deprecated. 
      \n 
      retrofit2.Converter<okhttp3.ResponseBody,?>responseBodyConverter(java.lang.reflect.Type type,\n java.lang.annotation.Annotation[] annotations,\n retrofit2.Retrofit retrofit)\n
      Deprecated. 
      \n 
      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.Converter.Factory

        \ngetParameterUpperBound, getRawType, requestBodyConverter, stringConverter
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n\n\n\n\n
        \n
      • \n

        responseBodyConverter

        \n
        @Nullable\npublic retrofit2.Converter<okhttp3.ResponseBody,?> responseBodyConverter(java.lang.reflect.Type type,\n                                                                                   java.lang.annotation.Annotation[] annotations,\n                                                                                   retrofit2.Retrofit retrofit)
        \n
        Deprecated. 
        \n
        \n
        Overrides:
        \n
        responseBodyConverter in class retrofit2.Converter.Factory
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-java8/retrofit/converter/java8/package-frame.html", "content": "\n\n\n\n\nretrofit.converter.java8 (java8 API)\n\n\n\n\n

retrofit.converter.java8

\n
\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-java8/retrofit/converter/java8/package-summary.html", "content": "\n\n\n\n\nretrofit.converter.java8 (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

@EverythingIsNonNull\n

\n

Package retrofit.converter.java8

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    Java8OptionalConverterFactoryDeprecated\n
    Retrofit includes support for Optional.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-java8/retrofit/converter/java8/package-tree.html", "content": "\n\n\n\n\nretrofit.converter.java8 Class Hierarchy (java8 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit.converter.java8

\n
\n
\n

Class Hierarchy

\n\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-java8/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/2.x/converter-java8/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.useSummary td.colFirst, .useSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/2.x/converter-jaxb/allclasses-frame.html", "content": "\n\n\n\n\nAll Classes (jaxb API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-jaxb/allclasses-noframe.html", "content": "\n\n\n\n\nAll Classes (jaxb API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-jaxb/constant-values.html", "content": "\n\n\n\n\nConstant Field Values (jaxb API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb/deprecated-list.html", "content": "\n\n\n\n\nDeprecated List (jaxb API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb/help-doc.html", "content": "\n\n\n\n\nAPI Help (jaxb API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb/index-all.html", "content": "\n\n\n\n\nIndex (jaxb API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
C J R \n\n\n

C

\n
\n
create() - Static method in class retrofit2.converter.jaxb.JaxbConverterFactory
\n
\n
Create an instance using a default JAXBContext instance for conversion.
\n
\n
create(JAXBContext) - Static method in class retrofit2.converter.jaxb.JaxbConverterFactory
\n
\n
Create an instance using context for conversion.
\n
\n
\n\n\n\n

J

\n
\n
JaxbConverterFactory - Class in retrofit2.converter.jaxb
\n
\n
A converter which uses JAXB for XML.
\n
\n
\n\n\n\n

R

\n
\n
requestBodyConverter(Type, Annotation[], Annotation[], Retrofit) - Method in class retrofit2.converter.jaxb.JaxbConverterFactory
\n
 
\n
responseBodyConverter(Type, Annotation[], Retrofit) - Method in class retrofit2.converter.jaxb.JaxbConverterFactory
\n
 
\n
retrofit2.converter.jaxb - package retrofit2.converter.jaxb
\n
 
\n
\nC J R 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb/index.html", "content": "\n\n\n\n\njaxb API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit2/converter/jaxb/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb/overview-tree.html", "content": "\n\n\n\n\nClass Hierarchy (jaxb API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n\n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb/package-list", "content": "retrofit2.converter.jaxb\n" }, { "path": "website/public/2.x/converter-jaxb/retrofit2/converter/jaxb/JaxbConverterFactory.html", "content": "\n\n\n\n\nJaxbConverterFactory (jaxb API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.converter.jaxb
\n

Class JaxbConverterFactory

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • retrofit2.Converter.Factory
      • \n
    • \n
        \n
      • retrofit2.converter.jaxb.JaxbConverterFactory
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public final class JaxbConverterFactory\nextends retrofit2.Converter.Factory
    \n
    A converter which uses JAXB for XML. All validation events are\n ignored.
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static JaxbConverterFactorycreate()\n
      Create an instance using a default JAXBContext instance for conversion.
      \n
      static JaxbConverterFactorycreate(javax.xml.bind.JAXBContext context)\n
      Create an instance using context for conversion.
      \n
      retrofit2.Converter<?,okhttp3.RequestBody>requestBodyConverter(java.lang.reflect.Type type,\n java.lang.annotation.Annotation[] parameterAnnotations,\n java.lang.annotation.Annotation[] methodAnnotations,\n retrofit2.Retrofit retrofit) 
      retrofit2.Converter<okhttp3.ResponseBody,?>responseBodyConverter(java.lang.reflect.Type type,\n java.lang.annotation.Annotation[] annotations,\n retrofit2.Retrofit retrofit) 
      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.Converter.Factory

        \ngetParameterUpperBound, getRawType, stringConverter
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        create

        \n
        public static JaxbConverterFactory create()
        \n
        Create an instance using a default JAXBContext instance for conversion.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        create

        \n
        public static JaxbConverterFactory create(javax.xml.bind.JAXBContext context)
        \n
        Create an instance using context for conversion.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        requestBodyConverter

        \n
        @Nullable\npublic retrofit2.Converter<?,okhttp3.RequestBody> requestBodyConverter(java.lang.reflect.Type type,\n                                                                                 java.lang.annotation.Annotation[] parameterAnnotations,\n                                                                                 java.lang.annotation.Annotation[] methodAnnotations,\n                                                                                 retrofit2.Retrofit retrofit)
        \n
        \n
        Overrides:
        \n
        requestBodyConverter in class retrofit2.Converter.Factory
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        responseBodyConverter

        \n
        @Nullable\npublic retrofit2.Converter<okhttp3.ResponseBody,?> responseBodyConverter(java.lang.reflect.Type type,\n                                                                                   java.lang.annotation.Annotation[] annotations,\n                                                                                   retrofit2.Retrofit retrofit)
        \n
        \n
        Overrides:
        \n
        responseBodyConverter in class retrofit2.Converter.Factory
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb/retrofit2/converter/jaxb/package-frame.html", "content": "\n\n\n\n\nretrofit2.converter.jaxb (jaxb API)\n\n\n\n\n

retrofit2.converter.jaxb

\n
\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-jaxb/retrofit2/converter/jaxb/package-summary.html", "content": "\n\n\n\n\nretrofit2.converter.jaxb (jaxb API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

@EverythingIsNonNull\n

\n

Package retrofit2.converter.jaxb

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    JaxbConverterFactory\n
    A converter which uses JAXB for XML.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb/retrofit2/converter/jaxb/package-tree.html", "content": "\n\n\n\n\nretrofit2.converter.jaxb Class Hierarchy (jaxb API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit2.converter.jaxb

\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n\n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/2.x/converter-jaxb/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.useSummary td.colFirst, .useSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/2.x/converter-jaxb3/allclasses-frame.html", "content": "\n\n\n\n\nAll Classes (jaxb3 API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-jaxb3/allclasses-noframe.html", "content": "\n\n\n\n\nAll Classes (jaxb3 API)\n\n\n\n\n

All Classes

\n
\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-jaxb3/constant-values.html", "content": "\n\n\n\n\nConstant Field Values (jaxb3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Constant Field Values

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb3/deprecated-list.html", "content": "\n\n\n\n\nDeprecated List (jaxb3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Deprecated API

\n

Contents

\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb3/help-doc.html", "content": "\n\n\n\n\nAPI Help (jaxb3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

How This API Document Is Organized

\n
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
\n
\n
\n
    \n
  • \n

    Package

    \n

    Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:

    \n
      \n
    • Interfaces (italic)
      • \n
    • Classes
      • \n
    • Enums
      • \n
    • Exceptions
      • \n
    • Errors
      • \n
    • Annotation Types
      • \n
    \n
    • \n
  • \n

    Class/Interface

    \n

    Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:

    \n
      \n
    • Class inheritance diagram
      • \n
    • Direct Subclasses
      • \n
    • All Known Subinterfaces
      • \n
    • All Known Implementing Classes
      • \n
    • Class/interface declaration
      • \n
    • Class/interface description
      • \n
    \n
      \n
    • Nested Class Summary
      • \n
    • Field Summary
      • \n
    • Constructor Summary
      • \n
    • Method Summary
      • \n
    \n
      \n
    • Field Detail
      • \n
    • Constructor Detail
      • \n
    • Method Detail
      • \n
    \n

    Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.

    \n
    • \n
  • \n

    Annotation Type

    \n

    Each annotation type has its own separate page with the following sections:

    \n
      \n
    • Annotation Type declaration
      • \n
    • Annotation Type description
      • \n
    • Required Element Summary
      • \n
    • Optional Element Summary
      • \n
    • Element Detail
      • \n
    \n
    • \n
  • \n

    Enum

    \n

    Each enum has its own separate page with the following sections:

    \n
      \n
    • Enum declaration
      • \n
    • Enum description
      • \n
    • Enum Constant Summary
      • \n
    • Enum Constant Detail
      • \n
    \n
    • \n
  • \n

    Tree (Class Hierarchy)

    \n

    There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.

    \n
      \n
    • When viewing the Overview page, clicking on \"Tree\" displays the hierarchy for all packages.
      • \n
    • When viewing a particular package, class or interface page, clicking \"Tree\" displays the hierarchy for only that package.
      • \n
    \n
    • \n
  • \n

    Deprecated API

    \n

    The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.

    \n
    • \n
  • \n

    Index

    \n

    The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.

    \n
    • \n
  • \n

    Prev/Next

    \n

    These links take you to the next or previous class, interface, package, or related page.

    \n
    • \n
  • \n

    Frames/No Frames

    \n

    These links show and hide the HTML frames. All pages are available with or without frames.

    \n
    • \n
  • \n

    All Classes

    \n

    The All Classes link shows all classes and interfaces except non-static nested types.

    \n
    • \n
  • \n

    Serialized Form

    \n

    Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking \"Serialized Form\" in the \"See also\" section of the class description.

    \n
    • \n
  • \n

    Constant Field Values

    \n

    The Constant Field Values page lists the static final fields and their values.

    \n
    • \n
\nThis help file applies to API documentation generated using the standard doclet.
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb3/index-all.html", "content": "\n\n\n\n\nIndex (jaxb3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
C J R \n\n\n

C

\n
\n
create() - Static method in class retrofit2.converter.jaxb3.JaxbConverterFactory
\n
\n
Create an instance using a default JAXBContext instance for conversion.
\n
\n
create(JAXBContext) - Static method in class retrofit2.converter.jaxb3.JaxbConverterFactory
\n
\n
Create an instance using context for conversion.
\n
\n
\n\n\n\n

J

\n
\n
JaxbConverterFactory - Class in retrofit2.converter.jaxb3
\n
\n
A converter which uses JAXB for XML.
\n
\n
\n\n\n\n

R

\n
\n
requestBodyConverter(Type, Annotation[], Annotation[], Retrofit) - Method in class retrofit2.converter.jaxb3.JaxbConverterFactory
\n
 
\n
responseBodyConverter(Type, Annotation[], Retrofit) - Method in class retrofit2.converter.jaxb3.JaxbConverterFactory
\n
 
\n
retrofit2.converter.jaxb3 - package retrofit2.converter.jaxb3
\n
 
\n
\nC J R 
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb3/index.html", "content": "\n\n\n\n\njaxb3 API\n\n\n\n\n\n\n<noscript>\n<div>JavaScript is disabled on your browser.</div>\n</noscript>\n<h2>Frame Alert</h2>\n<p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client. Link to <a href=\"retrofit2/converter/jaxb3/package-summary.html\">Non-frame version</a>.</p>\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb3/overview-tree.html", "content": "\n\n\n\n\nClass Hierarchy (jaxb3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For All Packages

\nPackage Hierarchies:\n\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n\n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb3/package-list", "content": "retrofit2.converter.jaxb3\n" }, { "path": "website/public/2.x/converter-jaxb3/retrofit2/converter/jaxb3/JaxbConverterFactory.html", "content": "\n\n\n\n\nJaxbConverterFactory (jaxb3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n
\n
retrofit2.converter.jaxb3
\n

Class JaxbConverterFactory

\n
\n
\n
    \n
  • java.lang.Object
    • \n
  • \n
      \n
    • retrofit2.Converter.Factory
      • \n
    • \n
        \n
      • retrofit2.converter.jaxb3.JaxbConverterFactory
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
    \n
  • \n
    \n
    \n
    public final class JaxbConverterFactory\nextends retrofit2.Converter.Factory
    \n
    A converter which uses JAXB for XML. All validation events are\n ignored.
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Summary

      \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      static JaxbConverterFactorycreate()\n
      Create an instance using a default JAXBContext instance for conversion.
      \n
      static JaxbConverterFactorycreate(jakarta.xml.bind.JAXBContext context)\n
      Create an instance using context for conversion.
      \n
      retrofit2.Converter<?,okhttp3.RequestBody>requestBodyConverter(java.lang.reflect.Type type,\n java.lang.annotation.Annotation[] parameterAnnotations,\n java.lang.annotation.Annotation[] methodAnnotations,\n retrofit2.Retrofit retrofit) 
      retrofit2.Converter<okhttp3.ResponseBody,?>responseBodyConverter(java.lang.reflect.Type type,\n java.lang.annotation.Annotation[] annotations,\n retrofit2.Retrofit retrofit) 
      \n
        \n
      • \n\n\n

        Methods inherited from class retrofit2.Converter.Factory

        \ngetParameterUpperBound, getRawType, stringConverter
        • \n
      \n
        \n
      • \n\n\n

        Methods inherited from class java.lang.Object

        \nclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n
    \n
  • \n\n
      \n
    • \n\n\n

      Method Detail

      \n\n\n\n
        \n
      • \n

        create

        \n
        public static JaxbConverterFactory create()
        \n
        Create an instance using a default JAXBContext instance for conversion.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        create

        \n
        public static JaxbConverterFactory create(jakarta.xml.bind.JAXBContext context)
        \n
        Create an instance using context for conversion.
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        requestBodyConverter

        \n
        @Nullable\npublic retrofit2.Converter<?,okhttp3.RequestBody> requestBodyConverter(java.lang.reflect.Type type,\n                                                                                 java.lang.annotation.Annotation[] parameterAnnotations,\n                                                                                 java.lang.annotation.Annotation[] methodAnnotations,\n                                                                                 retrofit2.Retrofit retrofit)
        \n
        \n
        Overrides:
        \n
        requestBodyConverter in class retrofit2.Converter.Factory
        \n
        \n
        • \n
      \n\n\n\n
        \n
      • \n

        responseBodyConverter

        \n
        @Nullable\npublic retrofit2.Converter<okhttp3.ResponseBody,?> responseBodyConverter(java.lang.reflect.Type type,\n                                                                                   java.lang.annotation.Annotation[] annotations,\n                                                                                   retrofit2.Retrofit retrofit)
        \n
        \n
        Overrides:
        \n
        responseBodyConverter in class retrofit2.Converter.Factory
        \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
\n
\n
\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Class
    • \n
  • Next Class
    • \n
\n\n\n
\n\n
\n
\n
    \n
  • Summary: 
    • \n
  • Nested | 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
    \n
  • Detail: 
    • \n
  • Field | 
    • \n
  • Constr | 
    • \n
  • Method
    • \n
\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb3/retrofit2/converter/jaxb3/package-frame.html", "content": "\n\n\n\n\nretrofit2.converter.jaxb3 (jaxb3 API)\n\n\n\n\n

retrofit2.converter.jaxb3

\n
\n

Classes

\n\n
\n\n\n" }, { "path": "website/public/2.x/converter-jaxb3/retrofit2/converter/jaxb3/package-summary.html", "content": "\n\n\n\n\nretrofit2.converter.jaxb3 (jaxb3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

@EverythingIsNonNull\n

\n

Package retrofit2.converter.jaxb3

\n
\n
\n
    \n
  • \n\n\n\n\n\n\n\n\n\n\n\n\n
    Class Summary 
    ClassDescription
    JaxbConverterFactory\n
    A converter which uses JAXB for XML.
    \n
    \n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev Package
    • \n
  • Next Package
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb3/retrofit2/converter/jaxb3/package-tree.html", "content": "\n\n\n\n\nretrofit2.converter.jaxb3 Class Hierarchy (jaxb3 API)\n\n\n\n\n\n\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n
\n

Hierarchy For Package retrofit2.converter.jaxb3

\n
\n
\n

Class Hierarchy

\n
    \n
  • java.lang.Object\n\n
    • \n
\n
\n\n
\n\n\n
Skip navigation links
\n\n\n\n\n
\n
\n
    \n
  • Prev
    • \n
  • Next
    • \n
\n\n\n
\n\n
\n\n\n
\n\n\n\n" }, { "path": "website/public/2.x/converter-jaxb3/script.js", "content": "function show(type)\n{\n count = 0;\n for (var key in methods) {\n var row = document.getElementById(key);\n if ((methods[key] & type) != 0) {\n row.style.display = '';\n row.className = (count++ % 2) ? rowColor : altColor;\n }\n else\n row.style.display = 'none';\n }\n updateTabs(type);\n}\n\nfunction updateTabs(type)\n{\n for (var value in tabs) {\n var sNode = document.getElementById(tabs[value][0]);\n var spanNode = sNode.firstChild;\n if (value == type) {\n sNode.className = activeTableTab;\n spanNode.innerHTML = tabs[value][1];\n }\n else {\n sNode.className = tableTab;\n spanNode.innerHTML = \"\" + tabs[value][1] + \"\";\n }\n }\n}\n" }, { "path": "website/public/2.x/converter-jaxb3/stylesheet.css", "content": "/* Javadoc style sheet */\n/*\nOverall document style\n*/\n\n@import url('resources/fonts/dejavu.css');\n\nbody {\n background-color:#ffffff;\n color:#353833;\n font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;\n font-size:14px;\n margin:0;\n}\na:link, a:visited {\n text-decoration:none;\n color:#4A6782;\n}\na:hover, a:focus {\n text-decoration:none;\n color:#bb7a2a;\n}\na:active {\n text-decoration:none;\n color:#4A6782;\n}\na[name] {\n color:#353833;\n}\na[name]:hover {\n text-decoration:none;\n color:#353833;\n}\npre {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n}\nh1 {\n font-size:20px;\n}\nh2 {\n font-size:18px;\n}\nh3 {\n font-size:16px;\n font-style:italic;\n}\nh4 {\n font-size:13px;\n}\nh5 {\n font-size:12px;\n}\nh6 {\n font-size:11px;\n}\nul {\n list-style-type:disc;\n}\ncode, tt {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n margin-top:8px;\n line-height:1.4em;\n}\ndt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n padding-top:4px;\n}\ntable tr td dt code {\n font-family:'DejaVu Sans Mono', monospace;\n font-size:14px;\n vertical-align:top;\n padding-top:4px;\n}\nsup {\n font-size:8px;\n}\n/*\nDocument title and Copyright styles\n*/\n.clear {\n clear:both;\n height:0px;\n overflow:hidden;\n}\n.aboutLanguage {\n float:right;\n padding:0px 21px;\n font-size:11px;\n z-index:200;\n margin-top:-9px;\n}\n.legalCopy {\n margin-left:.5em;\n}\n.bar a, .bar a:link, .bar a:visited, .bar a:active {\n color:#FFFFFF;\n text-decoration:none;\n}\n.bar a:hover, .bar a:focus {\n color:#bb7a2a;\n}\n.tab {\n background-color:#0066FF;\n color:#ffffff;\n padding:8px;\n width:5em;\n font-weight:bold;\n}\n/*\nNavigation bar styles\n*/\n.bar {\n background-color:#4D7A97;\n color:#FFFFFF;\n padding:.8em .5em .4em .8em;\n height:auto;/*height:1.8em;*/\n font-size:11px;\n margin:0;\n}\n.topNav {\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px; \n}\n.bottomNav {\n margin-top:10px;\n background-color:#4D7A97;\n color:#FFFFFF;\n float:left;\n padding:0;\n width:100%;\n clear:right;\n height:2.8em;\n padding-top:10px;\n overflow:hidden;\n font-size:12px;\n}\n.subNav {\n background-color:#dee3e9;\n float:left;\n width:100%;\n overflow:hidden;\n font-size:12px;\n}\n.subNav div {\n clear:left;\n float:left;\n padding:0 0 5px 6px;\n text-transform:uppercase;\n}\nul.navList, ul.subNavList {\n float:left;\n margin:0 25px 0 0;\n padding:0;\n}\nul.navList li{\n list-style:none;\n float:left;\n padding: 5px 6px;\n text-transform:uppercase;\n}\nul.subNavList li{\n list-style:none;\n float:left;\n}\n.topNav a:link, .topNav a:active, .topNav a:visited, .bottomNav a:link, .bottomNav a:active, .bottomNav a:visited {\n color:#FFFFFF;\n text-decoration:none;\n text-transform:uppercase;\n}\n.topNav a:hover, .bottomNav a:hover {\n text-decoration:none;\n color:#bb7a2a;\n text-transform:uppercase;\n}\n.navBarCell1Rev {\n background-color:#F8981D;\n color:#253441;\n margin: auto 5px;\n}\n.skipNav {\n position:absolute;\n top:auto;\n left:-9999px;\n overflow:hidden;\n}\n/*\nPage header and footer styles\n*/\n.header, .footer {\n clear:both;\n margin:0 20px;\n padding:5px 0 0 0;\n}\n.indexHeader {\n margin:10px;\n position:relative;\n}\n.indexHeader span{\n margin-right:15px;\n}\n.indexHeader h1 {\n font-size:13px;\n}\n.title {\n color:#2c4557;\n margin:10px 0;\n}\n.subTitle {\n margin:5px 0 0 0;\n}\n.header ul {\n margin:0 0 15px 0;\n padding:0;\n}\n.footer ul {\n margin:20px 0 5px 0;\n}\n.header ul li, .footer ul li {\n list-style:none;\n font-size:13px;\n}\n/*\nHeading styles\n*/\ndiv.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n background-color:#dee3e9;\n border:1px solid #d0d9e0;\n margin:0 0 6px -8px;\n padding:7px 5px;\n}\nul.blockList ul.blockList li.blockList h3 {\n padding:0;\n margin:15px 0;\n}\nul.blockList li.blockList h2 {\n padding:0px 0 20px 0;\n}\n/*\nPage layout container styles\n*/\n.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {\n clear:both;\n padding:10px 20px;\n position:relative;\n}\n.indexContainer {\n margin:10px;\n position:relative;\n font-size:12px;\n}\n.indexContainer h2 {\n font-size:13px;\n padding:0 0 3px 0;\n}\n.indexContainer ul {\n margin:0;\n padding:0;\n}\n.indexContainer ul li {\n list-style:none;\n padding-top:2px;\n}\n.contentContainer .description dl dt, .contentContainer .details dl dt, .serializedFormContainer dl dt {\n font-size:12px;\n font-weight:bold;\n margin:10px 0 0 0;\n color:#4E4E4E;\n}\n.contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {\n margin:5px 0 10px 0px;\n font-size:14px;\n font-family:'DejaVu Sans Mono',monospace;\n}\n.serializedFormContainer dl.nameValue dt {\n margin-left:1px;\n font-size:1.1em;\n display:inline;\n font-weight:bold;\n}\n.serializedFormContainer dl.nameValue dd {\n margin:0 0 0 1px;\n font-size:1.1em;\n display:inline;\n}\n/*\nList styles\n*/\nul.horizontal li {\n display:inline;\n font-size:0.9em;\n}\nul.inheritance {\n margin:0;\n padding:0;\n}\nul.inheritance li {\n display:inline;\n list-style:none;\n}\nul.inheritance li ul.inheritance {\n margin-left:15px;\n padding-left:15px;\n padding-top:1px;\n}\nul.blockList, ul.blockListLast {\n margin:10px 0 10px 0;\n padding:0;\n}\nul.blockList li.blockList, ul.blockListLast li.blockList {\n list-style:none;\n margin-bottom:15px;\n line-height:1.4;\n}\nul.blockList ul.blockList li.blockList, ul.blockList ul.blockListLast li.blockList {\n padding:0px 20px 5px 10px;\n border:1px solid #ededed; \n background-color:#f8f8f8;\n}\nul.blockList ul.blockList ul.blockList li.blockList, ul.blockList ul.blockList ul.blockListLast li.blockList {\n padding:0 0 5px 8px;\n background-color:#ffffff;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockList {\n margin-left:0;\n padding-left:0;\n padding-bottom:15px;\n border:none;\n}\nul.blockList ul.blockList ul.blockList ul.blockList li.blockListLast {\n list-style:none;\n border-bottom:none;\n padding-bottom:0;\n}\ntable tr td dl, table tr td dl dt, table tr td dl dd {\n margin-top:0;\n margin-bottom:1px;\n}\n/*\nTable styles\n*/\n.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {\n width:100%;\n border-left:1px solid #EEE; \n border-right:1px solid #EEE; \n border-bottom:1px solid #EEE; \n}\n.overviewSummary, .memberSummary {\n padding:0px;\n}\n.overviewSummary caption, .memberSummary caption, .typeSummary caption,\n.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {\n position:relative;\n text-align:left;\n background-repeat:no-repeat;\n color:#253441;\n font-weight:bold;\n clear:none;\n overflow:hidden;\n padding:0px;\n padding-top:10px;\n padding-left:1px;\n margin:0px;\n white-space:pre;\n}\n.overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,\n.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,\n.overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,\n.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,\n.overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,\n.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,\n.overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,\n.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {\n color:#FFFFFF;\n}\n.overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,\n.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n padding-bottom:7px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n border: none;\n height:16px;\n}\n.memberSummary caption span.activeTableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#F8981D;\n height:16px;\n}\n.memberSummary caption span.tableTab span {\n white-space:nowrap;\n padding-top:5px;\n padding-left:12px;\n padding-right:12px;\n margin-right:3px;\n display:inline-block;\n float:left;\n background-color:#4D7A97;\n height:16px;\n}\n.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {\n padding-top:0px;\n padding-left:0px;\n padding-right:0px;\n background-image:none;\n float:none;\n display:inline;\n}\n.overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,\n.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {\n display:none;\n width:5px;\n position:relative;\n float:left;\n background-color:#F8981D;\n}\n.memberSummary .activeTableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative; \n float:left;\n background-color:#F8981D;\n}\n.memberSummary .tableTab .tabEnd {\n display:none;\n width:5px;\n margin-right:3px;\n position:relative;\n background-color:#4D7A97;\n float:left;\n\n}\n.overviewSummary td, .memberSummary td, .typeSummary td,\n.useSummary td, .constantsSummary td, .deprecatedSummary td {\n text-align:left;\n padding:0px 0px 12px 10px;\n}\nth.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,\ntd.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{\n vertical-align:top;\n padding-right:0px;\n padding-top:8px;\n padding-bottom:3px;\n}\nth.colFirst, th.colLast, th.colOne, .constantsSummary th {\n background:#dee3e9;\n text-align:left;\n padding:8px 3px 3px 7px;\n}\ntd.colFirst, th.colFirst {\n white-space:nowrap;\n font-size:13px;\n}\ntd.colLast, th.colLast {\n font-size:13px;\n}\ntd.colOne, th.colOne {\n font-size:13px;\n}\n.overviewSummary td.colFirst, .overviewSummary th.colFirst,\n.useSummary td.colFirst, .useSummary th.colFirst,\n.overviewSummary td.colOne, .overviewSummary th.colOne,\n.memberSummary td.colFirst, .memberSummary th.colFirst,\n.memberSummary td.colOne, .memberSummary th.colOne,\n.typeSummary td.colFirst{\n width:25%;\n vertical-align:top;\n}\ntd.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {\n font-weight:bold;\n}\n.tableSubHeadingColor {\n background-color:#EEEEFF;\n}\n.altColor {\n background-color:#FFFFFF;\n}\n.rowColor {\n background-color:#EEEEEF;\n}\n/*\nContent styles\n*/\n.description pre {\n margin-top:0;\n}\n.deprecatedContent {\n margin:0;\n padding:10px 0;\n}\n.docSummary {\n padding:0;\n}\n\nul.blockList ul.blockList ul.blockList li.blockList h3 {\n font-style:normal;\n}\n\ndiv.block {\n font-size:14px;\n font-family:'DejaVu Serif', Georgia, \"Times New Roman\", Times, serif;\n}\n\ntd.colLast div {\n padding-top:0px;\n}\n\n\ntd.colLast a {\n padding-bottom:3px;\n}\n/*\nFormatting effect styles\n*/\n.sourceLineNo {\n color:green;\n padding:0 30px 0 0;\n}\nh1.hidden {\n visibility:hidden;\n overflow:hidden;\n font-size:10px;\n}\n.block {\n display:block;\n margin:3px 10px 2px 0px;\n color:#474747;\n}\n.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,\n.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,\n.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {\n font-weight:bold;\n}\n.deprecationComment, .emphasizedPhrase, .interfaceName {\n font-style:italic;\n}\n\ndiv.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,\ndiv.block div.block span.interfaceName {\n font-style:normal;\n}\n\ndiv.contentContainer ul.blockList li.blockList h2{\n padding-bottom:0px;\n}\n" }, { "path": "website/public/2.x/converter-kotlinx-serialization/index.html", "content": "\n\n\n \n kotlinx-serialization\n \n \n \n \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n \n
\n
\n
\n
    \n
    \n \n kotlinx-serialization\n \n \n
    \n
    \n
\n
\n
\n
\n
\n
\n
\n
\n

kotlinx-serialization

\n
\n

Packages

\n
\n
\n
\n
\n
\n \n\n
Link copied to clipboard
\n
\n
\n
\n
jvm
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n \n © 2025 Copyright\n \n Generated by \n \n dokka\n \n \n
\n
\n
\n
\n\n" }, { "path": "website/public/2.x/converter-kotlinx-serialization/kotlinx-serialization/package-list", "content": "$dokka.format:html-v1\n$dokka.linkExtension:html\n$dokka.location:retrofit2.converter.kotlinx.serialization////PointingToDeclaration/\u001fkotlinx-serialization/retrofit2.converter.kotlinx.serialization/index.html\n$dokka.location:retrofit2.converter.kotlinx.serialization//asConverterFactory/kotlinx.serialization.BinaryFormat#okhttp3.MediaType/PointingToDeclaration/\u001fkotlinx-serialization/retrofit2.converter.kotlinx.serialization/as-converter-factory.html\n$dokka.location:retrofit2.converter.kotlinx.serialization//asConverterFactory/kotlinx.serialization.StringFormat#okhttp3.MediaType/PointingToDeclaration/\u001fkotlinx-serialization/retrofit2.converter.kotlinx.serialization/as-converter-factory.html\nretrofit2.converter.kotlinx.serialization\n" }, { "path": "website/public/2.x/converter-kotlinx-serialization/kotlinx-serialization/retrofit2.converter.kotlinx.serialization/as-converter-factory.html", "content": "\n\n\n \n asConverterFactory\n \n \n \n \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n \n
\n
\n
\n
    \n
    \n \n kotlinx-serialization\n \n \n
    \n
    \n
\n
\n
\n
\n
\n
\n
kotlinx-serialization/retrofit2.converter.kotlinx.serialization/asConverterFactory
\n
\n

asConverterFactory

\n
\n
@JvmName(name = "create")
fun StringFormat.asConverterFactory(contentType: MediaType): Converter.Factory

Return a Converter.Factory which uses Kotlin serialization for string-based payloads.

Because Kotlin serialization is so flexible in the types it supports, this converter assumes that it can handle all types. If you are mixing this with something else, you must add this instance last to allow the other converters a chance to see their types.

@JvmName(name = "create")
fun BinaryFormat.asConverterFactory(contentType: MediaType): Converter.Factory

Return a Converter.Factory which uses Kotlin serialization for byte-based payloads.

Because Kotlin serialization is so flexible in the types it supports, this converter assumes that it can handle all types. If you are mixing this with something else, you must add this instance last to allow the other converters a chance to see their types.

\n
\n
\n \n © 2025 Copyright\n \n Generated by \n \n dokka\n \n \n
\n
\n
\n
\n\n" }, { "path": "website/public/2.x/converter-kotlinx-serialization/kotlinx-serialization/retrofit2.converter.kotlinx.serialization/index.html", "content": "\n\n\n \n retrofit2.converter.kotlinx.serialization\n \n \n \n \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n \n
\n
\n
\n
    \n
    \n \n kotlinx-serialization\n \n \n
    \n
    \n
\n
\n
\n
\n
\n
\n
kotlinx-serialization/retrofit2.converter.kotlinx.serialization
\n
\n

Package-level declarations

\n
\n
\n
\n
\n
\n

Functions

\n
\n
\n
\n
\n \n\n
Link copied to clipboard
\n
\n
\n
\n
@JvmName(name = "create")
fun BinaryFormat.asConverterFactory(contentType: MediaType): Converter.Factory

Return a Converter.Factory which uses Kotlin serialization for byte-based payloads.

@JvmName(name = "create")
fun StringFormat.asConverterFactory(contentType: MediaType): Converter.Factory

Return a Converter.Factory which uses Kotlin serialization for string-based payloads.

\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n \n © 2025 Copyright\n \n Generated by \n \n dokka\n \n \n
\n
\n
\n
\n\n" }, { "path": "website/public/2.x/converter-kotlinx-serialization/navigation.html", "content": "
\n
kotlinx-serialization
\n
\n
retrofit2.converter.kotlinx.serialization
\n
\n
asConverterFactory()
\n
\n
\n
\n" }, { "path": "website/public/2.x/converter-kotlinx-serialization/scripts/clipboard.js", "content": "/*\n * Copyright 2014-2024 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.\n */\n\nwindow.addEventListener('load', () => {\n document.querySelectorAll('span.copy-icon').forEach(element => {\n element.addEventListener('click', (el) => copyElementsContentToClipboard(element));\n })\n\n document.querySelectorAll('span.anchor-icon').forEach(element => {\n element.addEventListener('click', (el) => {\n if(element.hasAttribute('pointing-to')){\n const location = hrefWithoutCurrentlyUsedAnchor() + '#' + element.getAttribute('pointing-to')\n copyTextToClipboard(element, location)\n }\n });\n })\n})\n\nconst copyElementsContentToClipboard = (element) => {\n const selection = window.getSelection();\n const range = document.createRange();\n range.selectNodeContents(element.parentNode.parentNode);\n selection.removeAllRanges();\n selection.addRange(range);\n\n copyAndShowPopup(element, () => selection.removeAllRanges())\n}\n\nconst copyTextToClipboard = (element, text) => {\n var textarea = document.createElement(\"textarea\");\n textarea.textContent = text;\n textarea.style.position = \"fixed\";\n document.body.appendChild(textarea);\n textarea.select();\n\n copyAndShowPopup(element, () => document.body.removeChild(textarea))\n}\n\nconst copyAndShowPopup = (element, after) => {\n try {\n document.execCommand('copy');\n element.nextElementSibling.classList.add('active-popup');\n setTimeout(() => {\n element.nextElementSibling.classList.remove('active-popup');\n }, 1200);\n } catch (e) {\n console.error('Failed to write to clipboard:', e)\n }\n finally {\n if(after) after()\n }\n}\n\nconst hrefWithoutCurrentlyUsedAnchor = () => window.location.href.split('#')[0]\n\n" }, { "path": "website/public/2.x/converter-kotlinx-serialization/scripts/main.js", "content": "(()=>{var e={1817:e=>{e.exports=''},4811:e=>{e.exports=''},5742:e=>{e.exports=''},7112:e=>{e.exports=''},8420:e=>{e.exports=''},7004:e=>{e.exports=''},7222:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>u});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(5280),c=a()(o());c.i(l.A),c.push([e.id,'.avatar_d716 {\\n display: inline-block;\\n -o-object-fit: cover;\\n object-fit: cover;\\n -o-object-position: center;\\n object-position: center;\\n\\n /* This is a \"graceful degradation\" fallback, while the real value is controlled by JS */\\n\\n border-radius: var(--ring-border-radius);\\n}\\n\\n.subavatar_b10d {\\n position: absolute;\\n top: 15px;\\n left: 27px;\\n\\n border: 1px var(--ring-content-background-color) solid;\\n}\\n\\n.empty_a151 {\\n display: inline-block;\\n\\n box-sizing: border-box;\\n\\n border: 1px solid var(--ring-borders-color);\\n}\\n',\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/avatar/avatar.css\"],names:[],mappings:\"AAEA;EACE,qBAAqB;EACrB,oBAAiB;KAAjB,iBAAiB;EACjB,0BAAuB;KAAvB,uBAAuB;;EAEvB,wFAAwF;;EAExF,wCAAwC;AAC1C;;AAEA;EACE,kBAAkB;EAClB,SAAS;EACT,UAAU;;EAEV,sDAAsD;AACxD;;AAEA;EACE,qBAAqB;;EAErB,sBAAsB;;EAEtB,2CAA2C;AAC7C\",sourcesContent:['@import \"../global/variables.css\";\\n\\n.avatar {\\n display: inline-block;\\n object-fit: cover;\\n object-position: center;\\n\\n /* This is a \"graceful degradation\" fallback, while the real value is controlled by JS */\\n\\n border-radius: var(--ring-border-radius);\\n}\\n\\n.subavatar {\\n position: absolute;\\n top: 15px;\\n left: 27px;\\n\\n border: 1px var(--ring-content-background-color) solid;\\n}\\n\\n.empty {\\n display: inline-block;\\n\\n box-sizing: border-box;\\n\\n border: 1px solid var(--ring-borders-color);\\n}\\n'],sourceRoot:\"\"}]),c.locals={avatar:\"avatar_d716\",subavatar:\"subavatar_b10d\",empty:\"empty_a151\"};const u=c},9892:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>s});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(9106),c=t(5280),u=a()(o());u.i(c.A),u.i(l.default,\"\",!0),u.push([e.id,'.heightS_b28d {\\n --ring-button-height: 24px;\\n --ring-button-font-size: var(--ring-font-size-smaller);\\n}\\n\\n.heightM_dfd3 {\\n --ring-button-height: 28px;\\n --ring-button-font-size: var(--ring-font-size);\\n}\\n\\n.heightL_a4d3 {\\n --ring-button-height: 32px;\\n --ring-button-font-size: var(--ring-font-size);\\n}\\n\\n.button_aba4 {\\n position: relative;\\n\\n display: inline-block;\\n\\n box-sizing: border-box;\\n height: var(--ring-button-height);\\n margin: 0;\\n padding: 0 16px;\\n\\n cursor: pointer;\\n transition: color var(--ring-ease), background-color var(--ring-ease), box-shadow var(--ring-ease);\\n text-decoration: none;\\n\\n color: var(--ring-text-color);\\n\\n border: 0;\\n border-radius: var(--ring-border-radius);\\n outline: 0;\\n background-color: var(--ring-content-background-color);\\n box-shadow: inset 0 0 0 1px var(--ring-borders-color);\\n\\n font-family: var(--ring-font-family);\\n font-size: var(--ring-button-font-size);\\n\\n line-height: var(--ring-button-height);\\n}\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.button_aba4:hover {\\n transition: none;\\n\\n box-shadow: inset 0 0 0 1px var(--ring-border-hover-color);\\n }}\\n\\n.button_aba4:active {\\n transition: none;\\n\\n background-color: var(--ring-selected-background-color);\\n box-shadow: inset 0 0 0 1px var(--ring-border-hover-color);\\n }\\n\\n.button_aba4:focus-visible {\\n transition: none;\\n\\n box-shadow: inset 0 0 0 1px var(--ring-border-hover-color), 0 0 0 1px var(--ring-border-hover-color);\\n }\\n\\n.button_aba4.active_bbe6 {\\n transition: none;\\n\\n background-color: var(--ring-hover-background-color);\\n box-shadow: inset 0 0 0 1px var(--ring-main-color);\\n }\\n\\n.button_aba4.active_bbe6:focus-visible {\\n box-shadow: inset 0 0 0 2px var(--ring-main-color), 0 0 0 1px var(--ring-border-hover-color);\\n }\\n\\n.button_aba4[disabled] {\\n pointer-events: none;\\n\\n background-color: var(--ring-disabled-background-color);\\n box-shadow: inset 0 0 0 1px var(--ring-border-disabled-color);\\n }\\n\\n.button_aba4.active_bbe6[disabled] {\\n background-color: var(--ring-disabled-selected-background-color);\\n box-shadow: inset 0 0 0 1px var(--ring-border-selected-disabled-color);\\n }\\n\\n.button_aba4[disabled],\\n .button_aba4.withIcon_ef77[disabled] {\\n color: var(--ring-disabled-color);\\n }\\n\\n.button_aba4[disabled] .icon_e878 {\\n color: var(--ring-icon-disabled-color);\\n }\\n\\n.button_aba4::-moz-focus-inner {\\n padding: 0;\\n\\n border: 0;\\n outline: 0;\\n }\\n\\n.withIcon_ef77 {\\n color: var(--ring-secondary-color);\\n}\\n\\n.primary_ddae {\\n color: var(--ring-white-text-color);\\n background-color: var(--ring-main-color);\\n box-shadow: none;\\n}\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.primary_ddae:hover {\\n transition: none;\\n\\n background-color: var(--ring-main-hover-color);\\n box-shadow: none;\\n }}\\n\\n.primary_ddae.withIcon_ef77,\\n .primary_ddae.withIcon_ef77:active,\\n .primary_ddae.withIcon_ef77.active_bbe6 {\\n color: var(--ring-action-link-color);\\n }\\n\\n.primary_ddae:focus-visible,\\n .primary_ddae:active,\\n .primary_ddae.active_bbe6 {\\n background-color: var(--ring-button-primary-background-color);\\n }\\n\\n.primary_ddae:active,\\n .primary_ddae.active_bbe6 {\\n box-shadow: inset 0 0 0 1px var(--ring-button-primary-border-color);\\n }\\n\\n.primary_ddae[disabled] {\\n background-color: var(--ring-disabled-background-color);\\n box-shadow: inset 0 0 0 1px var(--ring-border-disabled-color);\\n }\\n\\n.primary_ddae.loader_cbfc[disabled] {\\n color: var(--ring-white-text-color);\\n }\\n\\n.primary_ddae .loaderBackground_d9f5 {\\n top: 0;\\n right: 0;\\n bottom: 0;\\n left: 0;\\n\\n border-radius: var(--ring-border-radius);\\n }\\n\\n.primary_ddae .loaderBackground_d9f5::before {\\n background-image:\\n linear-gradient(\\n to right,\\n var(--ring-main-color),\\n var(--ring-button-loader-background) 40%,\\n var(--ring-main-color) 80%\\n );\\n }\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.danger_bcea:hover {\\n transition: none;\\n }}\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.danger_bcea:hover {\\n box-shadow: inset 0 0 0 1px var(--ring-button-danger-hover-color);\\n }}\\n\\n.danger_bcea,\\n .danger_bcea.withIcon_ef77,\\n .danger_bcea.withIcon_ef77:active,\\n .danger_bcea.withIcon_ef77.active_bbe6,\\n .danger_bcea.text_fc2a,\\n .danger_bcea.text_fc2a:active,\\n .danger_bcea.text_fc2a.active_bbe6 {\\n color: var(--ring-error-color);\\n }\\n\\n.danger_bcea:active,\\n .danger_bcea.active_bbe6 {\\n background-color: var(--ring-button-danger-active-color);\\n }\\n\\n.danger_bcea:active,\\n .danger_bcea.active_bbe6,\\n .danger_bcea:focus-visible {\\n box-shadow: inset 0 0 0 1px var(--ring-button-danger-hover-color);\\n }\\n\\n.danger_bcea:focus-visible {\\n transition: none;\\n }\\n\\n.text_fc2a.text_fc2a,\\n.withIcon_ef77.withIcon_ef77 {\\n background-color: transparent;\\n box-shadow: none;\\n}\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.text_fc2a.text_fc2a:hover, .withIcon_ef77.withIcon_ef77:hover {\\n transition: none;\\n }}\\n\\n.text_fc2a.text_fc2a:active,\\n .withIcon_ef77.withIcon_ef77:active,\\n .text_fc2a.text_fc2a.active_bbe6,\\n .withIcon_ef77.withIcon_ef77.active_bbe6 {\\n background-color: transparent;\\n box-shadow: none;\\n }\\n\\n.text_fc2a.text_fc2a:focus-visible, .withIcon_ef77.withIcon_ef77:focus-visible {\\n box-shadow: inset 0 0 0 2px var(--ring-border-hover-color);\\n }\\n\\n.loader_cbfc.text_fc2a > .content_b2b8 {\\n animation-name: text-loading_d1b4;\\n animation-duration: 1200ms;\\n animation-iteration-count: infinite;\\n}\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.text_fc2a.text_fc2a:hover {\\n background-color: transparent;\\n box-shadow: none;\\n}}\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.withIcon_ef77:hover:not(:focus-visible) {\\n background-color: transparent;\\n box-shadow: none;\\n}}\\n\\n.text_fc2a {\\n color: var(--ring-action-link-color);\\n}\\n\\n.inline_b4a2 {\\n display: inline-block;\\n\\n margin: 0;\\n padding: 0;\\n\\n font-size: var(--ring-font-size);\\n}\\n\\n.withIcon_ef77 {\\n padding: 0 8px;\\n}\\n\\n.text_fc2a:active,\\n .text_fc2a.active_bbe6 {\\n color: var(--ring-link-hover-color);\\n }\\n\\n.withIcon_ef77:active,\\n .withIcon_ef77.active_bbe6 {\\n color: var(--ring-action-link-color);\\n }\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.withIcon_ef77:hover {\\n color: var(--ring-link-hover-color);\\n}}\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.text_fc2a:hover {\\n color: var(--ring-link-hover-color);\\n}}\\n\\n.icon_e878 {\\n color: inherit;\\n\\n line-height: normal;\\n}\\n\\n.icon_e878:not(:last-child) {\\n margin-right: 4px;\\n }\\n\\n.withNormalIcon_aaca .icon_e878 {\\n transition: color var(--ring-ease);\\n\\n color: var(--ring-icon-color);\\n}\\n\\n.withNormalIcon_aaca:active,\\n.withNormalIcon_aaca.active_bbe6 {\\n color: var(--ring-main-color);\\n}\\n\\n.withNormalIcon_aaca:active .icon_e878, .withNormalIcon_aaca.active_bbe6 .icon_e878 {\\n transition: none;\\n\\n color: inherit;\\n }\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.withNormalIcon_aaca:hover .icon_e878,\\n.withDangerIcon_e3ca:hover .icon_e878 {\\n transition: none;\\n\\n color: inherit;\\n}}\\n\\n.withDangerIcon_e3ca .icon_e878,\\n.withDangerIcon_e3ca:active .icon_e878 {\\n color: var(--ring-icon-error-color);\\n}\\n\\n.loader_cbfc {\\n position: relative;\\n z-index: 0;\\n\\n pointer-events: none;\\n\\n background-color: transparent;\\n}\\n\\n.loaderBackground_d9f5 {\\n position: absolute;\\n z-index: -1;\\n top: 1px;\\n right: 1px;\\n bottom: 1px;\\n left: 1px;\\n\\n overflow: hidden;\\n\\n border-radius: var(--ring-border-radius-small);\\n}\\n\\n.loaderBackground_d9f5::before {\\n display: block;\\n\\n width: calc(100% + 64px);\\n height: 100%;\\n\\n content: \"\";\\n animation: progress_ed8f 1s linear infinite;\\n\\n background-image:\\n linear-gradient(\\n to right,\\n var(--ring-content-background-color),\\n var(--ring-selected-background-color) 40%,\\n var(--ring-content-background-color) 80%\\n );\\n\\n background-repeat: repeat;\\n background-size: 64px;\\n }\\n\\n.delayed_d562 .content_b2b8::after {\\n content: \"…\";\\n}\\n\\n.short_a07a {\\n width: 32px;\\n padding: 0;\\n}\\n\\n.dropdownIcon_e982 {\\n margin-right: -2px;\\n\\n margin-left: 2px;\\n\\n transition: color var(--ring-ease);\\n\\n color: var(--ring-icon-secondary-color);\\n\\n line-height: normal;\\n}\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.button_aba4:hover .dropdownIcon_e982 {\\n transition: none;\\n\\n color: var(--ring-main-color);\\n}}\\n\\n@keyframes progress_ed8f {\\n from {\\n transform: translateX(-64px);\\n }\\n\\n to {\\n transform: translateX(0);\\n }\\n}\\n\\n@keyframes text-loading_d1b4 {\\n 50% {\\n opacity: 0.5;\\n }\\n}\\n',\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/button/button.css\",\"\"],names:[],mappings:\"AAOA;EACE,0BAAoC;EACpC,sDAAsD;AACxD;;AAEA;EACE,0BAAsC;EACtC,8CAA8C;AAChD;;AAEA;EACE,0BAAoC;EACpC,8CAA8C;AAChD;;AAEA;EACE,kBAAkB;;EAElB,qBAAqB;;EAErB,sBAAsB;EACtB,iCAAc;EACd,SAAS;EACT,eAAyB;;EAEzB,eAAe;EACf,kGAAkG;EAClG,qBAAqB;;EAErB,6BAA6B;;EAE7B,SAAS;EACT,wCAAwC;EACxC,UAAU;EACV,sDAAsD;EACtD,qDAAmD;;EAEnD,oCAAoC;EACpC,uCAAuC;;EAEvC,sCAAmB;AA2DrB;;AC1GA,wGAAA;IAAA,iBAAA;;IAAA,2DAAA;GAAA,CAAA;;ADuDE;IACE,gBAAgB;;IAEhB,uDAAuD;IACvD,0DAAwD;EAC1D;;AAEA;IACE,gBAAgB;;IAEhB,oGAAkG;EACpG;;AAEA;IACE,gBAAgB;;IAEhB,oDAAoD;IACpD,kDAAgD;EAClD;;AAEA;IACE,4FAA4F;EAC9F;;AAEA;IACE,oBAAoB;;IAEpB,uDAAuD;IACvD,6DAA2D;EAC7D;;AAEA;IACE,gEAAgE;IAChE,sEAAoE;EACtE;;AAEA;;IAEE,iCAAiC;EACnC;;AAEA;IACE,sCAAsC;EACxC;;AAEA;IACE,UAAU;;IAEV,SAAS;IACT,UAAU;EACZ;;AAGF;EACE,kCAAkC;AACpC;;AAEA;EACE,mCAAmC;EACnC,wCAAwC;EACxC,gBAAgB;AAqDlB;;ACxKA,wGAAA;IAAA,iBAAA;;IAAA,+CAAA;IAAA,iBAAA;GAAA,CAAA;;AD4HE;;;IAGE,oCAAoC;EACtC;;AAEA;;;IAGE,6DAA6D;EAC/D;;AAEA;;IAEE,mEAAiE;EACnE;;AAEA;IACE,uDAAuD;IACvD,6DAA2D;EAC7D;;AAEA;IACE,mCAAmC;EACrC;;AAEA;IACE,MAAM;IACN,QAAQ;IACR,SAAS;IACT,OAAO;;IAEP,wCAAwC;EAW1C;;AATE;MACE;;;;;;SAMG;IACL;;ACtKJ,wGAAA;IAAA,iBAAA;GAAA,CAAA;;AAAA,wGAAA;IAAA,kEAAA;GAAA,CAAA;;AD2KE;;;;;;;IAOE,8BAA8B;EAChC;;AAEA;;IAEE,wDAAwD;EAC1D;;AAEA;;;IAIE,iEAA+D;EACjE;;AAEA;IAEE,gBAAgB;EAClB;;AAGF;;EAEE,6BAA6B;EAC7B,gBAAgB;AAelB;;ACzNA,wGAAA;IAAA,iBAAA;GAAA,CAAA;;ADgNE;;;;IAEE,6BAA6B;IAC7B,gBAAgB;EAClB;;AAEA;IACE,0DAA0D;EAC5D;;AAGF;EACE,iCAA4B;EAC5B,0BAA0B;EAC1B,mCAAmC;AACrC;;AC/NA,wGAAA;EAAA,8BAAA;EAAA,iBAAA;CAAA,CAAA;;AAAA,wGAAA;EAAA,8BAAA;EAAA,iBAAA;CAAA,CAAA;;AD2OA;EACE,oCAAoC;AACtC;;AAEA;EACE,qBAAqB;;EAErB,SAAS;EACT,UAAU;;EAEV,gCAAgC;AAClC;;AAEA;EACE,cAAe;AACjB;;AAGE;;IAEE,mCAAmC;EACrC;;AAIA;;IAEE,oCAAoC;EACtC;;ACvQF,wGAAA;EAAA,oCAAA;CAAA,CAAA;;AAAA,wGAAA;EAAA,oCAAA;CAAA,CAAA;;ADkRA;EACE,cAAc;;EAEd,mBAAmB;AAKrB;;AAHE;IACE,iBAA8B;EAChC;;AAGF;EACE,kCAAkC;;EAElC,6BAA6B;AAC/B;;AAEA;;EAEE,6BAA6B;AAO/B;;AALE;IACE,gBAAgB;;IAEhB,cAAc;EAChB;;AC1SF,wGAAA;;EAAA,iBAAA;;EAAA,eAAA;CAAA,CAAA;;ADoTA;;EAEE,mCAAmC;AACrC;;AAEA;EACE,kBAAkB;EAClB,UAAU;;EAEV,oBAAoB;;EAEpB,6BAA6B;AAC/B;;AAEA;EACE,kBAAkB;EAClB,WAAW;EACX,QAAQ;EACR,UAAU;EACV,WAAW;EACX,SAAS;;EAET,gBAAgB;;EAEhB,8CAA8C;AAsBhD;;AApBE;IACE,cAAc;;IAEd,wBAA+B;IAC/B,YAAY;;IAEZ,WAAW;IACX,2CAAsC;;IAEtC;;;;;;OAMG;;IAEH,yBAAyB;IACzB,qBAA4B;EAC9B;;AAGF;EACE,YAAY;AACd;;AAEA;EACE,WAAqB;EACrB,UAAU;AACZ;;AAEA;EACE,kBAAkB;;EAElB,gBAAgB;;EAEhB,kCAAkC;;EAElC,uCAAuC;;EAEvC,mBAAmB;AACrB;;ACvXA,wGAAA;EAAA,iBAAA;;EAAA,8BAAA;CAAA,CAAA;;AD+XA;EACE;IACE,4BAA4C;EAC9C;;EAEA;IACE,wBAAwB;EAC1B;AACF;;AAEA;EACE;IACE,YAAY;EACd;AACF\",sourcesContent:['@import \"../global/variables.css\";\\n\\n@value unit from \"../global/global.css\";\\n@value button-shadow: inset 0 0 0 1px;\\n@value height: var(--ring-button-height);\\n@value loaderWidth: calc(unit * 8);\\n\\n.heightS {\\n --ring-button-height: calc(unit * 3);\\n --ring-button-font-size: var(--ring-font-size-smaller);\\n}\\n\\n.heightM {\\n --ring-button-height: calc(unit * 3.5);\\n --ring-button-font-size: var(--ring-font-size);\\n}\\n\\n.heightL {\\n --ring-button-height: calc(unit * 4);\\n --ring-button-font-size: var(--ring-font-size);\\n}\\n\\n.button {\\n position: relative;\\n\\n display: inline-block;\\n\\n box-sizing: border-box;\\n height: height;\\n margin: 0;\\n padding: 0 calc(unit * 2);\\n\\n cursor: pointer;\\n transition: color var(--ring-ease), background-color var(--ring-ease), box-shadow var(--ring-ease);\\n text-decoration: none;\\n\\n color: var(--ring-text-color);\\n\\n border: 0;\\n border-radius: var(--ring-border-radius);\\n outline: 0;\\n background-color: var(--ring-content-background-color);\\n box-shadow: button-shadow var(--ring-borders-color);\\n\\n font-family: var(--ring-font-family);\\n font-size: var(--ring-button-font-size);\\n\\n line-height: height;\\n\\n &:hover {\\n transition: none;\\n\\n box-shadow: button-shadow var(--ring-border-hover-color);\\n }\\n\\n &:active {\\n transition: none;\\n\\n background-color: var(--ring-selected-background-color);\\n box-shadow: button-shadow var(--ring-border-hover-color);\\n }\\n\\n &:focus-visible {\\n transition: none;\\n\\n box-shadow: button-shadow var(--ring-border-hover-color), 0 0 0 1px var(--ring-border-hover-color);\\n }\\n\\n &.active {\\n transition: none;\\n\\n background-color: var(--ring-hover-background-color);\\n box-shadow: button-shadow var(--ring-main-color);\\n }\\n\\n &:focus-visible.active {\\n box-shadow: inset 0 0 0 2px var(--ring-main-color), 0 0 0 1px var(--ring-border-hover-color);\\n }\\n\\n &[disabled] {\\n pointer-events: none;\\n\\n background-color: var(--ring-disabled-background-color);\\n box-shadow: button-shadow var(--ring-border-disabled-color);\\n }\\n\\n &[disabled].active {\\n background-color: var(--ring-disabled-selected-background-color);\\n box-shadow: button-shadow var(--ring-border-selected-disabled-color);\\n }\\n\\n &[disabled],\\n &[disabled].withIcon {\\n color: var(--ring-disabled-color);\\n }\\n\\n &[disabled] .icon {\\n color: var(--ring-icon-disabled-color);\\n }\\n\\n &::-moz-focus-inner {\\n padding: 0;\\n\\n border: 0;\\n outline: 0;\\n }\\n}\\n\\n.withIcon {\\n color: var(--ring-secondary-color);\\n}\\n\\n.primary {\\n color: var(--ring-white-text-color);\\n background-color: var(--ring-main-color);\\n box-shadow: none;\\n\\n &:hover {\\n transition: none;\\n\\n background-color: var(--ring-main-hover-color);\\n box-shadow: none;\\n }\\n\\n &.withIcon,\\n &.withIcon:active,\\n &.withIcon.active {\\n color: var(--ring-action-link-color);\\n }\\n\\n &:focus-visible,\\n &:active,\\n &.active {\\n background-color: var(--ring-button-primary-background-color);\\n }\\n\\n &:active,\\n &.active {\\n box-shadow: button-shadow var(--ring-button-primary-border-color);\\n }\\n\\n &[disabled] {\\n background-color: var(--ring-disabled-background-color);\\n box-shadow: button-shadow var(--ring-border-disabled-color);\\n }\\n\\n &[disabled].loader {\\n color: var(--ring-white-text-color);\\n }\\n\\n & .loaderBackground {\\n top: 0;\\n right: 0;\\n bottom: 0;\\n left: 0;\\n\\n border-radius: var(--ring-border-radius);\\n\\n &::before {\\n background-image:\\n linear-gradient(\\n to right,\\n var(--ring-main-color),\\n var(--ring-button-loader-background) 40%,\\n var(--ring-main-color) 80%\\n );\\n }\\n }\\n}\\n\\n.danger {\\n &,\\n &.withIcon,\\n &.withIcon:active,\\n &.withIcon.active,\\n &.text,\\n &.text:active,\\n &.text.active {\\n color: var(--ring-error-color);\\n }\\n\\n &:active,\\n &.active {\\n background-color: var(--ring-button-danger-active-color);\\n }\\n\\n &:active,\\n &.active,\\n &:focus-visible,\\n &:hover {\\n box-shadow: button-shadow var(--ring-button-danger-hover-color);\\n }\\n\\n &:focus-visible,\\n &:hover {\\n transition: none;\\n }\\n}\\n\\n.text.text,\\n.withIcon.withIcon {\\n background-color: transparent;\\n box-shadow: none;\\n\\n &:hover {\\n transition: none;\\n }\\n\\n &:active,\\n &.active {\\n background-color: transparent;\\n box-shadow: none;\\n }\\n\\n &:focus-visible {\\n box-shadow: inset 0 0 0 2px var(--ring-border-hover-color);\\n }\\n}\\n\\n.loader.text > .content {\\n animation-name: text-loading;\\n animation-duration: 1200ms;\\n animation-iteration-count: infinite;\\n}\\n\\n.text.text:hover {\\n background-color: transparent;\\n box-shadow: none;\\n}\\n\\n.withIcon:hover:not(:focus-visible) {\\n background-color: transparent;\\n box-shadow: none;\\n}\\n\\n.text {\\n color: var(--ring-action-link-color);\\n}\\n\\n.inline {\\n display: inline-block;\\n\\n margin: 0;\\n padding: 0;\\n\\n font-size: var(--ring-font-size);\\n}\\n\\n.withIcon {\\n padding: 0 unit;\\n}\\n\\n.text {\\n &:active,\\n &.active {\\n color: var(--ring-link-hover-color);\\n }\\n}\\n\\n.withIcon {\\n &:active,\\n &.active {\\n color: var(--ring-action-link-color);\\n }\\n}\\n\\n.withIcon:hover {\\n color: var(--ring-link-hover-color);\\n}\\n\\n.text:hover {\\n color: var(--ring-link-hover-color);\\n}\\n\\n.icon {\\n color: inherit;\\n\\n line-height: normal;\\n\\n &:not(:last-child) {\\n margin-right: calc(unit * 0.5);\\n }\\n}\\n\\n.withNormalIcon .icon {\\n transition: color var(--ring-ease);\\n\\n color: var(--ring-icon-color);\\n}\\n\\n.withNormalIcon:active,\\n.withNormalIcon.active {\\n color: var(--ring-main-color);\\n\\n & .icon {\\n transition: none;\\n\\n color: inherit;\\n }\\n}\\n\\n.withNormalIcon:hover .icon,\\n.withDangerIcon:hover .icon {\\n transition: none;\\n\\n color: inherit;\\n}\\n\\n.withDangerIcon .icon,\\n.withDangerIcon:active .icon {\\n color: var(--ring-icon-error-color);\\n}\\n\\n.loader {\\n position: relative;\\n z-index: 0;\\n\\n pointer-events: none;\\n\\n background-color: transparent;\\n}\\n\\n.loaderBackground {\\n position: absolute;\\n z-index: -1;\\n top: 1px;\\n right: 1px;\\n bottom: 1px;\\n left: 1px;\\n\\n overflow: hidden;\\n\\n border-radius: var(--ring-border-radius-small);\\n\\n &::before {\\n display: block;\\n\\n width: calc(100% + loaderWidth);\\n height: 100%;\\n\\n content: \"\";\\n animation: progress 1s linear infinite;\\n\\n background-image:\\n linear-gradient(\\n to right,\\n var(--ring-content-background-color),\\n var(--ring-selected-background-color) 40%,\\n var(--ring-content-background-color) 80%\\n );\\n\\n background-repeat: repeat;\\n background-size: loaderWidth;\\n }\\n}\\n\\n.delayed .content::after {\\n content: \"…\";\\n}\\n\\n.short {\\n width: calc(unit * 4);\\n padding: 0;\\n}\\n\\n.dropdownIcon {\\n margin-right: -2px;\\n\\n margin-left: 2px;\\n\\n transition: color var(--ring-ease);\\n\\n color: var(--ring-icon-secondary-color);\\n\\n line-height: normal;\\n}\\n\\n.button:hover .dropdownIcon {\\n transition: none;\\n\\n color: var(--ring-main-color);\\n}\\n\\n@keyframes progress {\\n from {\\n transform: translateX(calc(0 - loaderWidth));\\n }\\n\\n to {\\n transform: translateX(0);\\n }\\n}\\n\\n@keyframes text-loading {\\n 50% {\\n opacity: 0.5;\\n }\\n}\\n',null],sourceRoot:\"\"}]),u.locals={unit:`${l.default.locals.unit}`,\"button-shadow\":\"inset 0 0 0 1px\",height:\"var(--ring-button-height)\",loaderWidth:\"64px\",heightS:\"heightS_b28d\",heightM:\"heightM_dfd3\",heightL:\"heightL_a4d3\",button:\"button_aba4\",active:\"active_bbe6\",withIcon:\"withIcon_ef77\",icon:\"icon_e878\",primary:\"primary_ddae\",loader:\"loader_cbfc\",loaderBackground:\"loaderBackground_d9f5\",danger:\"danger_bcea\",text:\"text_fc2a\",content:\"content_b2b8\",\"text-loading\":\"text-loading_d1b4\",inline:\"inline_b4a2\",withNormalIcon:\"withNormalIcon_aaca\",withDangerIcon:\"withDangerIcon_e3ca\",progress:\"progress_ed8f\",delayed:\"delayed_d562\",short:\"short_a07a\",dropdownIcon:\"dropdownIcon_e982\"};const s=u},1866:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>s});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(9106),c=t(5280),u=a()(o());u.i(c.A),u.i(l.default,\"\",!0),u.push([e.id,\".checkbox_dccf {\\n position: relative;\\n\\n display: inline-block;\\n\\n text-align: left;\\n\\n color: var(--ring-text-color);\\n outline: none;\\n}\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.checkbox_dccf:hover .cell_edda {\\n transition: background-color var(--ring-ease);\\n\\n border-color: var(--ring-border-hover-color);\\n }}\\n\\n.cell_edda {\\n position: relative;\\n top: -2px;\\n\\n display: inline-block;\\n\\n box-sizing: border-box;\\n width: 14px;\\n height: 14px;\\n\\n -webkit-user-select: none;\\n\\n -moz-user-select: none;\\n\\n user-select: none;\\n transition: border-color var(--ring-ease), background-color var(--ring-ease), box-shadow var(--ring-ease);\\n vertical-align: middle;\\n pointer-events: none;\\n\\n border: 1px solid var(--ring-borders-color);\\n border-radius: var(--ring-border-radius-small);\\n background-color: var(--ring-content-background-color);\\n}\\n\\n.icon_b476.icon_b476 {\\n position: absolute;\\n\\n top: -1px;\\n left: -1px;\\n\\n width: 16px;\\n height: 16px;\\n\\n opacity: 0;\\n color: var(--ring-white-text-color);\\n}\\n\\n.icon_b476.icon_b476 svg {\\n position: absolute;\\n top: 0;\\n left: 0;\\n }\\n\\n.check_a219 {\\n}\\n\\n.minus_de65 {\\n}\\n\\n.input_a330 {\\n position: absolute;\\n top: 0;\\n left: 0;\\n\\n width: 100%;\\n height: 100%;\\n margin: 0;\\n\\n cursor: pointer;\\n\\n opacity: 0;\\n\\n /* stylelint-disable-next-line selector-max-specificity */\\n}\\n\\n.input_a330:checked + .cell_edda,\\n .input_a330:indeterminate + .cell_edda {\\n border-color: transparent;\\n background-color: var(--ring-main-color);\\n }\\n\\n/* stylelint-disable-next-line selector-max-specificity */\\n\\n.input_a330:checked + .cell_edda .check_a219 {\\n opacity: 1;\\n }\\n\\n.input_a330:focus-visible + .cell_edda,\\n .input_a330.focus_eaa3 + .cell_edda {\\n transition: background-color var(--ring-ease);\\n\\n border-color: var(--ring-border-hover-color);\\n box-shadow: 0 0 0 1px var(--ring-border-hover-color);\\n }\\n\\n/* stylelint-disable-next-line selector-max-specificity */\\n\\n.input_a330:indeterminate + .cell_edda .minus_de65 {\\n opacity: 1;\\n }\\n\\n.input_a330[disabled] {\\n pointer-events: none;\\n }\\n\\n/* stylelint-disable-next-line selector-max-specificity */\\n\\n.input_a330[disabled][disabled] + .cell_edda {\\n border-color: var(--ring-border-disabled-color);\\n background-color: var(--ring-disabled-background-color);\\n }\\n\\n/* stylelint-disable-next-line selector-max-specificity */\\n\\n.input_a330[disabled]:checked + .cell_edda,\\n .input_a330[disabled]:indeterminate + .cell_edda {\\n border-color: var(--ring-border-selected-disabled-color);\\n }\\n\\n/* stylelint-disable-next-line selector-max-specificity */\\n\\n.input_a330[disabled]:checked + .cell_edda .check_a219,\\n .input_a330[disabled]:indeterminate + .cell_edda .minus_de65 {\\n color: var(--ring-icon-disabled-color);\\n }\\n\\n/* stylelint-disable-next-line selector-max-specificity */\\n\\n.input_a330:indeterminate:indeterminate + .cell_edda .check_a219 {\\n transition: none;\\n\\n opacity: 0;\\n }\\n\\n.input_a330[disabled] ~ .label_dcc7 {\\n color: var(--ring-disabled-color);\\n }\\n\\n.label_dcc7 {\\n margin-left: 8px;\\n\\n line-height: normal;\\n}\\n\",\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/checkbox/checkbox.css\",\"\"],names:[],mappings:\"AAKA;EACE,kBAAkB;;EAElB,qBAAqB;;EAErB,gBAAgB;;EAEhB,6BAA6B;EAC7B,aAAa;AAOf;;ACpBA,wGAAA;IAAA,8CAAA;;IAAA,6CAAA;GAAA,CAAA;;ADsBA;EACE,kBAAkB;EAClB,SAAS;;EAET,qBAAqB;;EAErB,sBAAsB;EACtB,WAAmB;EACnB,YAAoB;;EAEpB,yBAAiB;;KAAjB,sBAAiB;;UAAjB,iBAAiB;EACjB,yGAAyG;EACzG,sBAAsB;EACtB,oBAAoB;;EAEpB,2CAA2C;EAC3C,8CAA8C;EAC9C,sDAAsD;AACxD;;AAEA;EACE,kBAAkB;;EAElB,SAAS;EACT,UAAU;;EAEV,WAAqB;EACrB,YAAsB;;EAEtB,UAAU;EACV,mCAAmC;AAOrC;;AALE;IACE,kBAAkB;IAClB,MAAM;IACN,OAAO;EACT;;AAGF;AAEA;;AAEA;AAEA;;AAEA;EACE,kBAAkB;EAClB,MAAM;EACN,OAAO;;EAEP,WAAW;EACX,YAAY;EACZ,SAAS;;EAET,eAAe;;EAEf,UAAU;;EAEV,yDAAyD;AAyD3D;;AAxDE;;IAEE,yBAAyB;IACzB,wCAAwC;EAC1C;;AAEA,yDAAyD;;AACzD;IACE,UAAU;EACZ;;AAEA;;IAEE,6CAA6C;;IAE7C,4CAA4C;IAC5C,oDAAoD;EACtD;;AAEA,yDAAyD;;AACzD;IACE,UAAU;EACZ;;AAEA;IACE,oBAAoB;EACtB;;AAEA,yDAAyD;;AACzD;IACE,+CAA+C;IAC/C,uDAAuD;EACzD;;AAEA,yDAAyD;;AACzD;;IAEE,wDAAwD;EAC1D;;AAEA,yDAAyD;;AACzD;;IAEE,sCAAsC;EACxC;;AAEA,yDAAyD;;AACzD;IACE,gBAAgB;;IAEhB,UAAU;EACZ;;AAEA;IACE,iCAAiC;EACnC;;AAGF;EACE,gBAAiB;;EAEjB,mBAAmB;AACrB\",sourcesContent:['@import \"../global/variables.css\";\\n\\n@value unit from \"../global/global.css\";\\n@value checkboxSize: 14px;\\n\\n.checkbox {\\n position: relative;\\n\\n display: inline-block;\\n\\n text-align: left;\\n\\n color: var(--ring-text-color);\\n outline: none;\\n\\n &:hover .cell {\\n transition: background-color var(--ring-ease);\\n\\n border-color: var(--ring-border-hover-color);\\n }\\n}\\n\\n.cell {\\n position: relative;\\n top: -2px;\\n\\n display: inline-block;\\n\\n box-sizing: border-box;\\n width: checkboxSize;\\n height: checkboxSize;\\n\\n user-select: none;\\n transition: border-color var(--ring-ease), background-color var(--ring-ease), box-shadow var(--ring-ease);\\n vertical-align: middle;\\n pointer-events: none;\\n\\n border: 1px solid var(--ring-borders-color);\\n border-radius: var(--ring-border-radius-small);\\n background-color: var(--ring-content-background-color);\\n}\\n\\n.icon.icon {\\n position: absolute;\\n\\n top: -1px;\\n left: -1px;\\n\\n width: calc(unit * 2);\\n height: calc(unit * 2);\\n\\n opacity: 0;\\n color: var(--ring-white-text-color);\\n\\n & svg {\\n position: absolute;\\n top: 0;\\n left: 0;\\n }\\n}\\n\\n.check {\\n composes: icon;\\n}\\n\\n.minus {\\n composes: icon;\\n}\\n\\n.input {\\n position: absolute;\\n top: 0;\\n left: 0;\\n\\n width: 100%;\\n height: 100%;\\n margin: 0;\\n\\n cursor: pointer;\\n\\n opacity: 0;\\n\\n /* stylelint-disable-next-line selector-max-specificity */\\n &:checked + .cell,\\n &:indeterminate + .cell {\\n border-color: transparent;\\n background-color: var(--ring-main-color);\\n }\\n\\n /* stylelint-disable-next-line selector-max-specificity */\\n &:checked + .cell .check {\\n opacity: 1;\\n }\\n\\n &:focus-visible + .cell,\\n &.focus + .cell {\\n transition: background-color var(--ring-ease);\\n\\n border-color: var(--ring-border-hover-color);\\n box-shadow: 0 0 0 1px var(--ring-border-hover-color);\\n }\\n\\n /* stylelint-disable-next-line selector-max-specificity */\\n &:indeterminate + .cell .minus {\\n opacity: 1;\\n }\\n\\n &[disabled] {\\n pointer-events: none;\\n }\\n\\n /* stylelint-disable-next-line selector-max-specificity */\\n &[disabled][disabled] + .cell {\\n border-color: var(--ring-border-disabled-color);\\n background-color: var(--ring-disabled-background-color);\\n }\\n\\n /* stylelint-disable-next-line selector-max-specificity */\\n &[disabled]:checked + .cell,\\n &[disabled]:indeterminate + .cell {\\n border-color: var(--ring-border-selected-disabled-color);\\n }\\n\\n /* stylelint-disable-next-line selector-max-specificity */\\n &[disabled]:checked + .cell .check,\\n &[disabled]:indeterminate + .cell .minus {\\n color: var(--ring-icon-disabled-color);\\n }\\n\\n /* stylelint-disable-next-line selector-max-specificity */\\n &:indeterminate:indeterminate + .cell .check {\\n transition: none;\\n\\n opacity: 0;\\n }\\n\\n &[disabled] ~ .label {\\n color: var(--ring-disabled-color);\\n }\\n}\\n\\n.label {\\n margin-left: unit;\\n\\n line-height: normal;\\n}\\n',null],sourceRoot:\"\"}]),u.locals={unit:`${l.default.locals.unit}`,checkboxSize:\"14px\",checkbox:\"checkbox_dccf\",cell:\"cell_edda\",icon:\"icon_b476\",check:\"check_a219 icon_b476\",minus:\"minus_de65 icon_b476\",input:\"input_a330\",focus:\"focus_eaa3\",label:\"label_dcc7\"};const s=u},5486:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>l});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i)()(o());a.push([e.id,\".label_bed7 {\\n display: block;\\n\\n margin-bottom: calc(var(--ring-unit)*0.5);\\n}\\n\\n.formLabel_f9ba {\\n color: var(--ring-text-color);\\n\\n font-size: var(--ring-font-size);\\n line-height: var(--ring-line-height);\\n}\\n\\n.secondaryLabel_e8a1 {\\n color: var(--ring-secondary-color);\\n\\n font-size: var(--ring-font-size-smaller);\\n line-height: var(--ring-line-height-lowest);\\n}\\n\\n.disabledLabel_e4c1 {\\n color: var(--ring-disabled-color);\\n}\\n\",\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/control-label/control-label.css\"],names:[],mappings:\"AAAA;EACE,cAAc;;EAEd,yCAA2C;AAC7C;;AAEA;EACE,6BAA6B;;EAE7B,gCAAgC;EAChC,oCAAoC;AACtC;;AAEA;EACE,kCAAkC;;EAElC,wCAAwC;EACxC,2CAA2C;AAC7C;;AAEA;EACE,iCAAiC;AACnC\",sourcesContent:[\".label {\\n display: block;\\n\\n margin-bottom: calc(var(--ring-unit) * 0.5);\\n}\\n\\n.formLabel {\\n color: var(--ring-text-color);\\n\\n font-size: var(--ring-font-size);\\n line-height: var(--ring-line-height);\\n}\\n\\n.secondaryLabel {\\n color: var(--ring-secondary-color);\\n\\n font-size: var(--ring-font-size-smaller);\\n line-height: var(--ring-line-height-lowest);\\n}\\n\\n.disabledLabel {\\n color: var(--ring-disabled-color);\\n}\\n\"],sourceRoot:\"\"}]),a.locals={label:\"label_bed7\",formLabel:\"formLabel_f9ba\",secondaryLabel:\"secondaryLabel_e8a1\",disabledLabel:\"disabledLabel_e4c1\"};const l=a},6506:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>u});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(5280),c=a()(o());c.i(l.A),c.push([e.id,\".dropdown_a1de {\\n display: inline-block;\\n}\\n\\n.anchor_fdbe.anchor_fdbe {\\n margin: 0 -3px;\\n padding: 0 3px;\\n\\n font: inherit;\\n}\\n\\n.chevron_ffc6 {\\n margin-left: 2px;\\n\\n line-height: normal;\\n}\\n\",\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/dropdown/dropdown.css\"],names:[],mappings:\"AAEA;EACE,qBAAqB;AACvB;;AAEA;EACE,cAAc;EACd,cAAc;;EAEd,aAAa;AACf;;AAEA;EACE,gBAAgB;;EAEhB,mBAAmB;AACrB\",sourcesContent:['@import \"../global/variables.css\";\\n\\n.dropdown {\\n display: inline-block;\\n}\\n\\n.anchor.anchor {\\n margin: 0 -3px;\\n padding: 0 3px;\\n\\n font: inherit;\\n}\\n\\n.chevron {\\n margin-left: 2px;\\n\\n line-height: normal;\\n}\\n'],sourceRoot:\"\"}]),c.locals={dropdown:\"dropdown_a1de\",anchor:\"anchor_fdbe\",chevron:\"chevron_ffc6\"};const u=c},9106:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>l});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i)()(o());a.push([e.id,'/* https://readymag.com/artemtiunov/RingUILanguage/colours/ */\\n\\n/*\\nUnit shouldn\\'t be CSS custom property because it is not intended to change\\nAlso it won\\'t form in FF47 https://bugzilla.mozilla.org/show_bug.cgi?id=594933\\n*/\\n\\n.clearfix_c694::after {\\n display: block;\\n clear: both;\\n\\n content: \"\";\\n }\\n\\n.font_a1f6 {\\n font-family: var(--ring-font-family);\\n font-size: var(--ring-font-size);\\n line-height: var(--ring-line-height);\\n}\\n\\n.font-lower_c3c9 {\\n\\n line-height: var(--ring-line-height-lower);\\n}\\n\\n.font-smaller_d963 {\\n\\n font-size: var(--ring-font-size-smaller);\\n}\\n\\n.font-smaller-lower_ff5f {\\n\\n line-height: var(--ring-line-height-lowest);\\n}\\n\\n.font-larger-lower_b336 {\\n\\n font-size: var(--ring-font-size-larger);\\n}\\n\\n.font-larger_f035 {\\n\\n line-height: var(--ring-line-height-taller);\\n}\\n\\n/* To be used at large sizes */\\n/* As close as possible to Helvetica Neue Thin (to replace Gotham) */\\n.thin-font_de5b {\\n font-family: \"Segoe UI\", \"Helvetica Neue\", Helvetica, Arial, sans-serif;\\n font-size: var(--ring-font-size);\\n font-weight: 100; /* Renders Helvetica Neue UltraLight on OS X */\\n}\\n\\n.monospace-font_ac33 {\\n font-family: var(--ring-font-family-monospace);\\n font-size: var(--ring-font-size-smaller);\\n}\\n\\n.ellipsis_e43b {\\n overflow: hidden;\\n\\n white-space: nowrap;\\n text-overflow: ellipsis;\\n}\\n\\n.resetButton_ddd2 {\\n overflow: visible;\\n\\n padding: 0;\\n\\n text-align: left;\\n\\n color: inherit;\\n border: 0;\\n\\n background-color: transparent;\\n\\n font: inherit;\\n}\\n\\n.resetButton_ddd2::-moz-focus-inner {\\n padding: 0;\\n\\n border: 0;\\n }\\n\\n/* Note: footer also has top margin which isn\\'t taken into account here */\\n\\n/* Media breakpoints (minimal values) */\\n\\n/* Media queries */\\n',\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/global/global.css\"],names:[],mappings:\"AAAA,6DAA6D;;AAE7D;;;CAGC;;AAIC;IACE,cAAc;IACd,WAAW;;IAEX,WAAW;EACb;;AAGF;EACE,oCAAoC;EACpC,gCAAgC;EAChC,oCAAoC;AACtC;;AAEA;;EAGE,0CAA0C;AAC5C;;AAEA;;EAGE,wCAAwC;AAC1C;;AAEA;;EAGE,2CAA2C;AAC7C;;AAEA;;EAGE,uCAAuC;AACzC;;AAEA;;EAGE,2CAA2C;AAC7C;;AAEA,8BAA8B;AAC9B,oEAAoE;AACpE;EACE,uEAAuE;EACvE,gCAAgC;EAChC,gBAAgB,EAAE,+CAA+C;AACnE;;AAEA;EACE,8CAA8C;EAC9C,wCAAwC;AAC1C;;AAEA;EACE,gBAAgB;;EAEhB,mBAAmB;EACnB,uBAAuB;AACzB;;AAEA;EACE,iBAAiB;;EAEjB,UAAU;;EAEV,gBAAgB;;EAEhB,cAAc;EACd,SAAS;;EAET,6BAA6B;;EAE7B,aAAa;AAOf;;AALE;IACE,UAAU;;IAEV,SAAS;EACX;;AAGF,yEAAyE;;AAGzE,uCAAuC;;AAKvC,kBAAkB\",sourcesContent:['/* https://readymag.com/artemtiunov/RingUILanguage/colours/ */\\n\\n/*\\nUnit shouldn\\'t be CSS custom property because it is not intended to change\\nAlso it won\\'t form in FF47 https://bugzilla.mozilla.org/show_bug.cgi?id=594933\\n*/\\n@value unit: 8px;\\n\\n.clearfix {\\n &::after {\\n display: block;\\n clear: both;\\n\\n content: \"\";\\n }\\n}\\n\\n.font {\\n font-family: var(--ring-font-family);\\n font-size: var(--ring-font-size);\\n line-height: var(--ring-line-height);\\n}\\n\\n.font-lower {\\n composes: font;\\n\\n line-height: var(--ring-line-height-lower);\\n}\\n\\n.font-smaller {\\n composes: font-lower;\\n\\n font-size: var(--ring-font-size-smaller);\\n}\\n\\n.font-smaller-lower {\\n composes: font-smaller;\\n\\n line-height: var(--ring-line-height-lowest);\\n}\\n\\n.font-larger-lower {\\n composes: font-lower;\\n\\n font-size: var(--ring-font-size-larger);\\n}\\n\\n.font-larger {\\n composes: font-larger-lower;\\n\\n line-height: var(--ring-line-height-taller);\\n}\\n\\n/* To be used at large sizes */\\n/* As close as possible to Helvetica Neue Thin (to replace Gotham) */\\n.thin-font {\\n font-family: \"Segoe UI\", \"Helvetica Neue\", Helvetica, Arial, sans-serif;\\n font-size: var(--ring-font-size);\\n font-weight: 100; /* Renders Helvetica Neue UltraLight on OS X */\\n}\\n\\n.monospace-font {\\n font-family: var(--ring-font-family-monospace);\\n font-size: var(--ring-font-size-smaller);\\n}\\n\\n.ellipsis {\\n overflow: hidden;\\n\\n white-space: nowrap;\\n text-overflow: ellipsis;\\n}\\n\\n.resetButton {\\n overflow: visible;\\n\\n padding: 0;\\n\\n text-align: left;\\n\\n color: inherit;\\n border: 0;\\n\\n background-color: transparent;\\n\\n font: inherit;\\n\\n &::-moz-focus-inner {\\n padding: 0;\\n\\n border: 0;\\n }\\n}\\n\\n/* Note: footer also has top margin which isn\\'t taken into account here */\\n@value footer-height: calc(unit * 8);\\n\\n/* Media breakpoints (minimal values) */\\n@value breakpoint-small: 640px;\\n@value breakpoint-middle: 960px;\\n@value breakpoint-large: 1200px;\\n\\n/* Media queries */\\n@value extra-small-screen-media: (max-width: calc(breakpoint-small - 1px));\\n@value small-screen-media: (min-width: breakpoint-small) and (max-width: calc(breakpoint-middle - 1px));\\n@value middle-screen-media: (min-width: breakpoint-middle) and (max-width: calc(breakpoint-large - 1px));\\n@value large-screen-media: (min-width: breakpoint-large);\\n'],sourceRoot:\"\"}]),a.locals={unit:\"8px\",\"footer-height\":\"64px\",\"breakpoint-small\":\"640px\",\"breakpoint-middle\":\"960px\",\"breakpoint-large\":\"1200px\",\"extra-small-screen-media\":\"(max-width: 639px)\",\"small-screen-media\":\"(min-width: 640px) and (max-width: 959px)\",\"middle-screen-media\":\"(min-width: 960px) and (max-width: 1199px)\",\"large-screen-media\":\"(min-width: 1200px)\",clearfix:\"clearfix_c694\",font:\"font_a1f6\",\"font-lower\":\"font-lower_c3c9 font_a1f6\",\"font-smaller\":\"font-smaller_d963 font-lower_c3c9 font_a1f6\",\"font-smaller-lower\":\"font-smaller-lower_ff5f font-smaller_d963 font-lower_c3c9 font_a1f6\",\"font-larger-lower\":\"font-larger-lower_b336 font-lower_c3c9 font_a1f6\",\"font-larger\":\"font-larger_f035 font-larger-lower_b336 font-lower_c3c9 font_a1f6\",\"thin-font\":\"thin-font_de5b\",\"monospace-font\":\"monospace-font_ac33\",ellipsis:\"ellipsis_e43b\",resetButton:\"resetButton_ddd2\"};const l=a},5280:(e,n,t)=>{\"use strict\";t.d(n,{A:()=>l});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i)()(o());a.push([e.id,'/* stylelint-disable color-no-hex */\\n\\n.light_f331,\\n:root {\\n --ring-unit: 8px;\\n\\n /* Element */\\n --ring-line-components: 223, 229, 235;\\n --ring-line-color: rgb(var(--ring-line-components)); /* #dfe5eb */\\n --ring-borders-components: 197, 209, 219;\\n --ring-borders-color: rgb(var(--ring-borders-components)); /* #c5d1db */\\n --ring-icon-components: 184, 209, 229;\\n --ring-icon-color: rgb(var(--ring-icon-components)); /* #b8d1e5 */\\n --ring-icon-secondary-components: 153, 153, 153;\\n --ring-icon-secondary-color: rgb(var(--ring-icon-secondary-components)); /* #999 */\\n --ring-border-disabled-components: 232, 232, 232;\\n --ring-border-disabled-color: rgb(var(--ring-border-disabled-components)); /* #e8e8e8 */\\n --ring-border-selected-disabled-components: 212, 212, 212;\\n --ring-border-selected-disabled-color: rgb(var(--ring-border-selected-disabled-components)); /* #d4d4d4 */\\n --ring-border-unselected-disabled-components: 232, 232, 232;\\n --ring-border-unselected-disabled-color: rgb(var(--ring-border-unselected-disabled-components)); /* #e8e8e8 */ /* TODO remove in 6.0 */\\n --ring-icon-disabled-components: 212, 212, 212;\\n --ring-icon-disabled-color: rgb(var(--ring-icon-disabled-components)); /* #d4d4d4 */\\n --ring-border-hover-components: 128, 198, 255;\\n --ring-border-hover-color: rgb(var(--ring-border-hover-components)); /* #80c6ff */\\n --ring-icon-hover-components: var(--ring-link-hover-color);\\n --ring-icon-hover-color: var(--ring-link-hover-color);\\n --ring-main-components: 0, 128, 229;\\n --ring-main-color: rgb(var(--ring-main-components)); /* #0080e5 */\\n --ring-action-link-components: var(--ring-main-components);\\n --ring-action-link-color: rgb(var(--ring-main-components)); /* #0080e5 */\\n --ring-main-hover-components: 0, 112, 204;\\n --ring-main-hover-color: rgb(var(--ring-main-hover-components)); /* #0070cc */\\n --ring-icon-error-components: 219, 88, 96;\\n --ring-icon-error-color: rgb(var(--ring-icon-error-components)); /* #db5860 */\\n --ring-icon-warning-components: 237, 162, 0;\\n --ring-icon-warning-color: rgb(var(--ring-icon-warning-components)); /* #eda200 */\\n --ring-icon-success-components: 89, 168, 105;\\n --ring-icon-success-color: rgb(var(--ring-icon-success-components)); /* #59a869 */\\n --ring-pale-control-components: 207, 219, 229;\\n --ring-pale-control-color: rgb(var(--ring-pale-control-components)); /* #cfdbe5 */\\n --ring-popup-border-components: 0, 28, 54;\\n --ring-popup-border-color: var(--ring-line-color);\\n --ring-popup-shadow-components: rgba(var(--ring-popup-border-components), 0.1);\\n --ring-popup-shadow-color: rgba(var(--ring-popup-border-components), 0.1);\\n --ring-popup-secondary-shadow-color: rgba(var(--ring-popup-border-components), 0.04);\\n --ring-message-shadow-color: rgba(var(--ring-popup-border-components), 0.3);\\n --ring-pinned-shadow-components: 115, 117, 119;\\n --ring-pinned-shadow-color: rgb(var(--ring-pinned-shadow-components)); /* #737577 */\\n --ring-button-danger-hover-components: var(--ring-icon-error-color);\\n --ring-button-danger-hover-color: var(--ring-icon-error-color);\\n --ring-button-primary-border-components: 0, 98, 178;\\n --ring-button-primary-border-color: rgb(var(--ring-button-primary-border-components)); /* #0062b2 */\\n --ring-popup-shadow: 0 2px 8px var(--ring-popup-shadow-color), 0 1px 2px var(--ring-popup-secondary-shadow-color);\\n --ring-dialog-shadow: 0 4px 24px var(--ring-popup-shadow-color), 0 2px 6px var(--ring-popup-secondary-shadow-color);\\n\\n /* Text */\\n --ring-search-components: 102, 158, 204;\\n --ring-search-color: rgb(var(--ring-search-components)); /* #669ecc */\\n --ring-hint-components: 64, 99, 128;\\n --ring-hint-color: rgb(var(--ring-hint-components)); /* #406380 */\\n --ring-link-components: 15, 91, 153;\\n --ring-link-color: rgb(var(--ring-link-components)); /* #0f5b99 */\\n --ring-link-hover-components: 255, 0, 140;\\n --ring-link-hover-color: rgb(var(--ring-link-hover-components)); /* #ff008c */\\n --ring-error-components: 169, 15, 26;\\n --ring-error-color: rgb(var(--ring-error-components)); /* #a90f1a */\\n --ring-warning-components: 178, 92, 0;\\n --ring-warning-color: rgb(var(--ring-warning-components)); /* #b25c00 */\\n --ring-success-components: 12, 117, 35;\\n --ring-success-color: rgb(var(--ring-success-components)); /* #0c7523 */\\n --ring-text-components: 31, 35, 38;\\n --ring-text-color: rgb(var(--ring-text-components)); /* #1f2326 */\\n --ring-active-text-color: var(--ring-text-color);\\n --ring-white-text-components: 255, 255, 255;\\n --ring-white-text-color: rgb(var(--ring-white-text-components)); /* #fff */\\n --ring-heading-color: var(--ring-text-color);\\n --ring-secondary-components: 115, 117, 119;\\n --ring-secondary-color: rgb(var(--ring-secondary-components)); /* #737577 */\\n --ring-disabled-components: 153, 153, 153;\\n --ring-disabled-color: rgb(var(--ring-disabled-components)); /* #999 */\\n\\n /* Background */\\n --ring-content-background-components: 255, 255, 255;\\n --ring-content-background-color: rgb(var(--ring-content-background-components)); /* #fff */\\n --ring-popup-background-components: 255, 255, 255;\\n --ring-popup-background-color: rgb(var(--ring-popup-background-components)); /* #fff */\\n --ring-sidebar-background-components: 247, 249, 250;\\n --ring-sidebar-background-color: rgb(var(--ring-sidebar-background-components)); /* #f7f9fa */\\n --ring-selected-background-components: 212, 237, 255;\\n --ring-selected-background-color: rgb(var(--ring-selected-background-components)); /* #d4edff */\\n --ring-hover-background-components: 235, 246, 255;\\n --ring-hover-background-color: rgb(var(--ring-hover-background-components)); /* #ebf6ff */\\n --ring-navigation-background-components: 255, 255, 255;\\n --ring-navigation-background-color: rgb(var(--ring-navigation-background-components)); /* #fff */\\n --ring-tag-background-components: 230, 236, 242;\\n --ring-tag-background-color: rgb(var(--ring-tag-background-components)); /* #e6ecf2 */\\n --ring-tag-hover-background-components: 211, 218, 224;\\n --ring-tag-hover-background-color: rgb(var(--ring-tag-hover-background-components)); /* #d3dae0 */\\n --ring-removed-background-components: 255, 213, 203;\\n --ring-removed-background-color: rgb(var(--ring-removed-background-components)); /* #ffd5cb */\\n --ring-warning-background-components: 250, 236, 205;\\n --ring-warning-background-color: rgb(var(--ring-warning-background-components)); /* #faeccd */\\n --ring-added-background-components: 216, 240, 216;\\n --ring-added-background-color: rgb(var(--ring-added-background-components)); /* #d8f0d8 */\\n --ring-disabled-background-components: 245, 245, 245;\\n --ring-disabled-background-color: rgb(var(--ring-disabled-background-components)); /* #f5f5f5 */\\n --ring-disabled-selected-background-components: 232, 232, 232;\\n --ring-disabled-selected-background-color: rgb(var(--ring-disabled-selected-background-components)); /* #e8e8e8 */\\n --ring-button-danger-active-components: 255, 231, 232;\\n --ring-button-danger-active-color: rgb(var(--ring-button-danger-active-components)); /* #ffe7e8 */\\n --ring-button-loader-background-components: 51, 163, 255;\\n --ring-button-loader-background: rgb(var(--ring-button-loader-background-components)); /* #33a3ff */\\n --ring-button-primary-background-components: 26, 152, 255;\\n --ring-button-primary-background-color: rgb(var(--ring-button-primary-background-components)); /* #1a98ff */\\n --ring-table-loader-background-color: rgba(var(--ring-content-background-components), 0.5); /* #ffffff80 */\\n\\n /* Code */\\n --ring-code-background-color: var(--ring-content-background-color);\\n --ring-code-components: 0, 0, 0;\\n --ring-code-color: rgb(var(--ring-code-components)); /* #000 */\\n --ring-code-comment-components: 112, 112, 112;\\n --ring-code-comment-color: rgb(var(--ring-code-comment-components)); /* #707070 */\\n --ring-code-meta-components: 112, 112, 112;\\n --ring-code-meta-color: rgb(var(--ring-code-meta-components)); /* #707070 */\\n --ring-code-keyword-components: 0, 0, 128;\\n --ring-code-keyword-color: rgb(var(--ring-code-keyword-components)); /* #000080 */\\n --ring-code-tag-background-components: 239, 239, 239;\\n --ring-code-tag-background-color: rgb(var(--ring-code-tag-background-components)); /* #efefef */\\n --ring-code-tag-color: var(--ring-code-keyword-color);\\n --ring-code-tag-font-weight: bold;\\n --ring-code-field-components: 102, 14, 122;\\n --ring-code-field-color: rgb(var(--ring-code-field-components)); /* #660e7a */\\n --ring-code-attribute-components: 0, 0, 255;\\n --ring-code-attribute-color: rgb(var(--ring-code-attribute-components)); /* #00f */\\n --ring-code-number-color: var(--ring-code-attribute-color);\\n --ring-code-string-components: 0, 122, 0;\\n --ring-code-string-color: rgb(var(--ring-code-string-components)); /* #007a00 */\\n --ring-code-addition-components: 170, 222, 170;\\n --ring-code-addition-color: rgb(var(--ring-code-addition-components)); /* #aadeaa */\\n --ring-code-deletion-components: 200, 200, 200;\\n --ring-code-deletion-color: rgb(var(--ring-code-deletion-components)); /* #c8c8c8 */\\n\\n /* Metrics */\\n --ring-border-radius: 4px;\\n --ring-border-radius-small: 2px;\\n --ring-font-size-larger: 15px;\\n --ring-font-size: 14px;\\n --ring-font-size-smaller: 12px;\\n --ring-line-height-taller: 21px;\\n --ring-line-height: 20px;\\n --ring-line-height-lower: 18px;\\n --ring-line-height-lowest: 16px;\\n --ring-ease: 0.3s ease-out;\\n --ring-fast-ease: 0.15s ease-out;\\n --ring-font-family: system-ui, -apple-system, Segoe UI, Roboto, Noto Sans, Ubuntu, Cantarell, Helvetica Neue, Arial, sans-serif;\\n --ring-font-family-monospace:\\n Menlo,\\n \"Bitstream Vera Sans Mono\",\\n \"Ubuntu Mono\",\\n Consolas,\\n \"Courier New\",\\n Courier,\\n monospace;\\n\\n /* Common z-index-values */\\n\\n /* Invisible element is an absolutely positioned element which should be below */\\n /* all other elements on the page */\\n --ring-invisible-element-z-index: -1;\\n\\n /* z-index for position: fixed elements */\\n --ring-fixed-z-index: 1;\\n\\n /* Elements that should overlay all other elements on the page */\\n --ring-overlay-z-index: 5;\\n\\n /* Alerts should de displayed above overlays */\\n --ring-alert-z-index: 6;\\n}\\n',\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/global/variables.css\"],names:[],mappings:\"AAAA,mCAAmC;;AAEnC;;EAEE,gBAAgB;;EAEhB,YAAY;EACZ,qCAAqC;EACrC,mDAAmD,EAAE,YAAY;EACjE,wCAAwC;EACxC,yDAAyD,EAAE,YAAY;EACvE,qCAAqC;EACrC,mDAAmD,EAAE,YAAY;EACjE,+CAA+C;EAC/C,uEAAuE,EAAE,SAAS;EAClF,gDAAgD;EAChD,yEAAyE,EAAE,YAAY;EACvF,yDAAyD;EACzD,2FAA2F,EAAE,YAAY;EACzG,2DAA2D;EAC3D,+FAA+F,EAAE,YAAY,EAAE,uBAAuB;EACtI,8CAA8C;EAC9C,qEAAqE,EAAE,YAAY;EACnF,6CAA6C;EAC7C,mEAAmE,EAAE,YAAY;EACjF,0DAA0D;EAC1D,qDAAqD;EACrD,mCAAmC;EACnC,mDAAmD,EAAE,YAAY;EACjE,0DAA0D;EAC1D,0DAA0D,EAAE,YAAY;EACxE,yCAAyC;EACzC,+DAA+D,EAAE,YAAY;EAC7E,yCAAyC;EACzC,+DAA+D,EAAE,YAAY;EAC7E,2CAA2C;EAC3C,mEAAmE,EAAE,YAAY;EACjF,4CAA4C;EAC5C,mEAAmE,EAAE,YAAY;EACjF,6CAA6C;EAC7C,mEAAmE,EAAE,YAAY;EACjF,yCAAyC;EACzC,iDAAiD;EACjD,8EAA8E;EAC9E,yEAAyE;EACzE,oFAAoF;EACpF,2EAA2E;EAC3E,8CAA8C;EAC9C,qEAAqE,EAAE,YAAY;EACnF,mEAAmE;EACnE,8DAA8D;EAC9D,mDAAmD;EACnD,qFAAqF,EAAE,YAAY;EACnG,iHAAiH;EACjH,mHAAmH;;EAEnH,SAAS;EACT,uCAAuC;EACvC,uDAAuD,EAAE,YAAY;EACrE,mCAAmC;EACnC,mDAAmD,EAAE,YAAY;EACjE,mCAAmC;EACnC,mDAAmD,EAAE,YAAY;EACjE,yCAAyC;EACzC,+DAA+D,EAAE,YAAY;EAC7E,oCAAoC;EACpC,qDAAqD,EAAE,YAAY;EACnE,qCAAqC;EACrC,yDAAyD,EAAE,YAAY;EACvE,sCAAsC;EACtC,yDAAyD,EAAE,YAAY;EACvE,kCAAkC;EAClC,mDAAmD,EAAE,YAAY;EACjE,gDAAgD;EAChD,2CAA2C;EAC3C,+DAA+D,EAAE,SAAS;EAC1E,4CAA4C;EAC5C,0CAA0C;EAC1C,6DAA6D,EAAE,YAAY;EAC3E,yCAAyC;EACzC,2DAA2D,EAAE,SAAS;;EAEtE,eAAe;EACf,mDAAmD;EACnD,+EAA+E,EAAE,SAAS;EAC1F,iDAAiD;EACjD,2EAA2E,EAAE,SAAS;EACtF,mDAAmD;EACnD,+EAA+E,EAAE,YAAY;EAC7F,oDAAoD;EACpD,iFAAiF,EAAE,YAAY;EAC/F,iDAAiD;EACjD,2EAA2E,EAAE,YAAY;EACzF,sDAAsD;EACtD,qFAAqF,EAAE,SAAS;EAChG,+CAA+C;EAC/C,uEAAuE,EAAE,YAAY;EACrF,qDAAqD;EACrD,mFAAmF,EAAE,YAAY;EACjG,mDAAmD;EACnD,+EAA+E,EAAE,YAAY;EAC7F,mDAAmD;EACnD,+EAA+E,EAAE,YAAY;EAC7F,iDAAiD;EACjD,2EAA2E,EAAE,YAAY;EACzF,oDAAoD;EACpD,iFAAiF,EAAE,YAAY;EAC/F,6DAA6D;EAC7D,mGAAmG,EAAE,YAAY;EACjH,qDAAqD;EACrD,mFAAmF,EAAE,YAAY;EACjG,wDAAwD;EACxD,qFAAqF,EAAE,YAAY;EACnG,yDAAyD;EACzD,6FAA6F,EAAE,YAAY;EAC3G,0FAA0F,EAAE,cAAc;;EAE1G,SAAS;EACT,kEAAkE;EAClE,+BAA+B;EAC/B,mDAAmD,EAAE,SAAS;EAC9D,6CAA6C;EAC7C,mEAAmE,EAAE,YAAY;EACjF,0CAA0C;EAC1C,6DAA6D,EAAE,YAAY;EAC3E,yCAAyC;EACzC,mEAAmE,EAAE,YAAY;EACjF,oDAAoD;EACpD,iFAAiF,EAAE,YAAY;EAC/F,qDAAqD;EACrD,iCAAiC;EACjC,0CAA0C;EAC1C,+DAA+D,EAAE,YAAY;EAC7E,2CAA2C;EAC3C,uEAAuE,EAAE,SAAS;EAClF,0DAA0D;EAC1D,wCAAwC;EACxC,iEAAiE,EAAE,YAAY;EAC/E,8CAA8C;EAC9C,qEAAqE,EAAE,YAAY;EACnF,8CAA8C;EAC9C,qEAAqE,EAAE,YAAY;;EAEnF,YAAY;EACZ,yBAAyB;EACzB,+BAA+B;EAC/B,6BAA6B;EAC7B,sBAAsB;EACtB,8BAA8B;EAC9B,+BAA+B;EAC/B,wBAAwB;EACxB,8BAA8B;EAC9B,+BAA+B;EAC/B,0BAA0B;EAC1B,gCAAgC;EAChC,+HAAgD;EAChD;;;;;;;aAOW;;EAEX,0BAA0B;;EAE1B,gFAAgF;EAChF,mCAAmC;EACnC,oCAAoC;;EAEpC,yCAAyC;EACzC,uBAAuB;;EAEvB,gEAAgE;EAChE,yBAAyB;;EAEzB,8CAA8C;EAC9C,uBAAuB;AACzB\",sourcesContent:['/* stylelint-disable color-no-hex */\\n\\n.light,\\n:root {\\n --ring-unit: 8px;\\n\\n /* Element */\\n --ring-line-components: 223, 229, 235;\\n --ring-line-color: rgb(var(--ring-line-components)); /* #dfe5eb */\\n --ring-borders-components: 197, 209, 219;\\n --ring-borders-color: rgb(var(--ring-borders-components)); /* #c5d1db */\\n --ring-icon-components: 184, 209, 229;\\n --ring-icon-color: rgb(var(--ring-icon-components)); /* #b8d1e5 */\\n --ring-icon-secondary-components: 153, 153, 153;\\n --ring-icon-secondary-color: rgb(var(--ring-icon-secondary-components)); /* #999 */\\n --ring-border-disabled-components: 232, 232, 232;\\n --ring-border-disabled-color: rgb(var(--ring-border-disabled-components)); /* #e8e8e8 */\\n --ring-border-selected-disabled-components: 212, 212, 212;\\n --ring-border-selected-disabled-color: rgb(var(--ring-border-selected-disabled-components)); /* #d4d4d4 */\\n --ring-border-unselected-disabled-components: 232, 232, 232;\\n --ring-border-unselected-disabled-color: rgb(var(--ring-border-unselected-disabled-components)); /* #e8e8e8 */ /* TODO remove in 6.0 */\\n --ring-icon-disabled-components: 212, 212, 212;\\n --ring-icon-disabled-color: rgb(var(--ring-icon-disabled-components)); /* #d4d4d4 */\\n --ring-border-hover-components: 128, 198, 255;\\n --ring-border-hover-color: rgb(var(--ring-border-hover-components)); /* #80c6ff */\\n --ring-icon-hover-components: var(--ring-link-hover-color);\\n --ring-icon-hover-color: var(--ring-link-hover-color);\\n --ring-main-components: 0, 128, 229;\\n --ring-main-color: rgb(var(--ring-main-components)); /* #0080e5 */\\n --ring-action-link-components: var(--ring-main-components);\\n --ring-action-link-color: rgb(var(--ring-main-components)); /* #0080e5 */\\n --ring-main-hover-components: 0, 112, 204;\\n --ring-main-hover-color: rgb(var(--ring-main-hover-components)); /* #0070cc */\\n --ring-icon-error-components: 219, 88, 96;\\n --ring-icon-error-color: rgb(var(--ring-icon-error-components)); /* #db5860 */\\n --ring-icon-warning-components: 237, 162, 0;\\n --ring-icon-warning-color: rgb(var(--ring-icon-warning-components)); /* #eda200 */\\n --ring-icon-success-components: 89, 168, 105;\\n --ring-icon-success-color: rgb(var(--ring-icon-success-components)); /* #59a869 */\\n --ring-pale-control-components: 207, 219, 229;\\n --ring-pale-control-color: rgb(var(--ring-pale-control-components)); /* #cfdbe5 */\\n --ring-popup-border-components: 0, 28, 54;\\n --ring-popup-border-color: var(--ring-line-color);\\n --ring-popup-shadow-components: rgba(var(--ring-popup-border-components), 0.1);\\n --ring-popup-shadow-color: rgba(var(--ring-popup-border-components), 0.1);\\n --ring-popup-secondary-shadow-color: rgba(var(--ring-popup-border-components), 0.04);\\n --ring-message-shadow-color: rgba(var(--ring-popup-border-components), 0.3);\\n --ring-pinned-shadow-components: 115, 117, 119;\\n --ring-pinned-shadow-color: rgb(var(--ring-pinned-shadow-components)); /* #737577 */\\n --ring-button-danger-hover-components: var(--ring-icon-error-color);\\n --ring-button-danger-hover-color: var(--ring-icon-error-color);\\n --ring-button-primary-border-components: 0, 98, 178;\\n --ring-button-primary-border-color: rgb(var(--ring-button-primary-border-components)); /* #0062b2 */\\n --ring-popup-shadow: 0 2px 8px var(--ring-popup-shadow-color), 0 1px 2px var(--ring-popup-secondary-shadow-color);\\n --ring-dialog-shadow: 0 4px 24px var(--ring-popup-shadow-color), 0 2px 6px var(--ring-popup-secondary-shadow-color);\\n\\n /* Text */\\n --ring-search-components: 102, 158, 204;\\n --ring-search-color: rgb(var(--ring-search-components)); /* #669ecc */\\n --ring-hint-components: 64, 99, 128;\\n --ring-hint-color: rgb(var(--ring-hint-components)); /* #406380 */\\n --ring-link-components: 15, 91, 153;\\n --ring-link-color: rgb(var(--ring-link-components)); /* #0f5b99 */\\n --ring-link-hover-components: 255, 0, 140;\\n --ring-link-hover-color: rgb(var(--ring-link-hover-components)); /* #ff008c */\\n --ring-error-components: 169, 15, 26;\\n --ring-error-color: rgb(var(--ring-error-components)); /* #a90f1a */\\n --ring-warning-components: 178, 92, 0;\\n --ring-warning-color: rgb(var(--ring-warning-components)); /* #b25c00 */\\n --ring-success-components: 12, 117, 35;\\n --ring-success-color: rgb(var(--ring-success-components)); /* #0c7523 */\\n --ring-text-components: 31, 35, 38;\\n --ring-text-color: rgb(var(--ring-text-components)); /* #1f2326 */\\n --ring-active-text-color: var(--ring-text-color);\\n --ring-white-text-components: 255, 255, 255;\\n --ring-white-text-color: rgb(var(--ring-white-text-components)); /* #fff */\\n --ring-heading-color: var(--ring-text-color);\\n --ring-secondary-components: 115, 117, 119;\\n --ring-secondary-color: rgb(var(--ring-secondary-components)); /* #737577 */\\n --ring-disabled-components: 153, 153, 153;\\n --ring-disabled-color: rgb(var(--ring-disabled-components)); /* #999 */\\n\\n /* Background */\\n --ring-content-background-components: 255, 255, 255;\\n --ring-content-background-color: rgb(var(--ring-content-background-components)); /* #fff */\\n --ring-popup-background-components: 255, 255, 255;\\n --ring-popup-background-color: rgb(var(--ring-popup-background-components)); /* #fff */\\n --ring-sidebar-background-components: 247, 249, 250;\\n --ring-sidebar-background-color: rgb(var(--ring-sidebar-background-components)); /* #f7f9fa */\\n --ring-selected-background-components: 212, 237, 255;\\n --ring-selected-background-color: rgb(var(--ring-selected-background-components)); /* #d4edff */\\n --ring-hover-background-components: 235, 246, 255;\\n --ring-hover-background-color: rgb(var(--ring-hover-background-components)); /* #ebf6ff */\\n --ring-navigation-background-components: 255, 255, 255;\\n --ring-navigation-background-color: rgb(var(--ring-navigation-background-components)); /* #fff */\\n --ring-tag-background-components: 230, 236, 242;\\n --ring-tag-background-color: rgb(var(--ring-tag-background-components)); /* #e6ecf2 */\\n --ring-tag-hover-background-components: 211, 218, 224;\\n --ring-tag-hover-background-color: rgb(var(--ring-tag-hover-background-components)); /* #d3dae0 */\\n --ring-removed-background-components: 255, 213, 203;\\n --ring-removed-background-color: rgb(var(--ring-removed-background-components)); /* #ffd5cb */\\n --ring-warning-background-components: 250, 236, 205;\\n --ring-warning-background-color: rgb(var(--ring-warning-background-components)); /* #faeccd */\\n --ring-added-background-components: 216, 240, 216;\\n --ring-added-background-color: rgb(var(--ring-added-background-components)); /* #d8f0d8 */\\n --ring-disabled-background-components: 245, 245, 245;\\n --ring-disabled-background-color: rgb(var(--ring-disabled-background-components)); /* #f5f5f5 */\\n --ring-disabled-selected-background-components: 232, 232, 232;\\n --ring-disabled-selected-background-color: rgb(var(--ring-disabled-selected-background-components)); /* #e8e8e8 */\\n --ring-button-danger-active-components: 255, 231, 232;\\n --ring-button-danger-active-color: rgb(var(--ring-button-danger-active-components)); /* #ffe7e8 */\\n --ring-button-loader-background-components: 51, 163, 255;\\n --ring-button-loader-background: rgb(var(--ring-button-loader-background-components)); /* #33a3ff */\\n --ring-button-primary-background-components: 26, 152, 255;\\n --ring-button-primary-background-color: rgb(var(--ring-button-primary-background-components)); /* #1a98ff */\\n --ring-table-loader-background-color: rgba(var(--ring-content-background-components), 0.5); /* #ffffff80 */\\n\\n /* Code */\\n --ring-code-background-color: var(--ring-content-background-color);\\n --ring-code-components: 0, 0, 0;\\n --ring-code-color: rgb(var(--ring-code-components)); /* #000 */\\n --ring-code-comment-components: 112, 112, 112;\\n --ring-code-comment-color: rgb(var(--ring-code-comment-components)); /* #707070 */\\n --ring-code-meta-components: 112, 112, 112;\\n --ring-code-meta-color: rgb(var(--ring-code-meta-components)); /* #707070 */\\n --ring-code-keyword-components: 0, 0, 128;\\n --ring-code-keyword-color: rgb(var(--ring-code-keyword-components)); /* #000080 */\\n --ring-code-tag-background-components: 239, 239, 239;\\n --ring-code-tag-background-color: rgb(var(--ring-code-tag-background-components)); /* #efefef */\\n --ring-code-tag-color: var(--ring-code-keyword-color);\\n --ring-code-tag-font-weight: bold;\\n --ring-code-field-components: 102, 14, 122;\\n --ring-code-field-color: rgb(var(--ring-code-field-components)); /* #660e7a */\\n --ring-code-attribute-components: 0, 0, 255;\\n --ring-code-attribute-color: rgb(var(--ring-code-attribute-components)); /* #00f */\\n --ring-code-number-color: var(--ring-code-attribute-color);\\n --ring-code-string-components: 0, 122, 0;\\n --ring-code-string-color: rgb(var(--ring-code-string-components)); /* #007a00 */\\n --ring-code-addition-components: 170, 222, 170;\\n --ring-code-addition-color: rgb(var(--ring-code-addition-components)); /* #aadeaa */\\n --ring-code-deletion-components: 200, 200, 200;\\n --ring-code-deletion-color: rgb(var(--ring-code-deletion-components)); /* #c8c8c8 */\\n\\n /* Metrics */\\n --ring-border-radius: 4px;\\n --ring-border-radius-small: 2px;\\n --ring-font-size-larger: 15px;\\n --ring-font-size: 14px;\\n --ring-font-size-smaller: 12px;\\n --ring-line-height-taller: 21px;\\n --ring-line-height: 20px;\\n --ring-line-height-lower: 18px;\\n --ring-line-height-lowest: 16px;\\n --ring-ease: 0.3s ease-out;\\n --ring-fast-ease: 0.15s ease-out;\\n --ring-font-family: system-ui, Arial, sans-serif;\\n --ring-font-family-monospace:\\n Menlo,\\n \"Bitstream Vera Sans Mono\",\\n \"Ubuntu Mono\",\\n Consolas,\\n \"Courier New\",\\n Courier,\\n monospace;\\n\\n /* Common z-index-values */\\n\\n /* Invisible element is an absolutely positioned element which should be below */\\n /* all other elements on the page */\\n --ring-invisible-element-z-index: -1;\\n\\n /* z-index for position: fixed elements */\\n --ring-fixed-z-index: 1;\\n\\n /* Elements that should overlay all other elements on the page */\\n --ring-overlay-z-index: 5;\\n\\n /* Alerts should de displayed above overlays */\\n --ring-alert-z-index: 6;\\n}\\n'],sourceRoot:\"\"}]),a.locals={light:\"light_f331\"};const l=a},9173:(e,n,t)=>{\"use strict\";t.d(n,{A:()=>l});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i)()(o());a.push([e.id,\"/* stylelint-disable color-no-hex */\\n\\n.ring-ui-theme-dark,\\n.dark_d4a9,\\n:root.dark_d4a9 {\\n --ring-line-components: 71, 81, 89;\\n --ring-line-color: rgb(var(--ring-line-components)); /* #475159 */\\n --ring-borders-components: 64, 99, 128;\\n --ring-borders-color: rgb(var(--ring-borders-components)); /* #406380 */\\n --ring-icon-components: 128, 146, 157;\\n --ring-icon-color: rgb(var(--ring-icon-components)); /* #80929d */\\n --ring-icon-secondary-components: 128, 146, 157;\\n --ring-icon-secondary-color: rgb(var(--ring-icon-secondary-components)); /* #80929d */\\n --ring-border-disabled-components: 54, 54, 54;\\n --ring-border-disabled-color: rgb(var(--ring-border-disabled-components)); /* #363636 */\\n --ring-border-selected-disabled-components: 54, 54, 54;\\n --ring-border-selected-disabled-color: rgb(var(--ring-border-selected-disabled-components)); /* #363636 */\\n --ring-border-unselected-disabled-components: 54, 54, 54;\\n --ring-border-unselected-disabled-color: rgb(var(--ring-border-unselected-disabled-components)); /* #363636 */ /* TODO remove in 6.0 */\\n --ring-icon-disabled-components: 80, 82, 83;\\n --ring-icon-disabled-color: rgb(var(--ring-icon-disabled-components)); /* #505253 */\\n --ring-border-hover-components: 112, 177, 230;\\n --ring-border-hover-color: rgb(var(--ring-border-hover-components)); /* #70b1e6 */\\n --ring-main-components: 0, 142, 255;\\n --ring-main-color: rgb(var(--ring-main-components)); /* #008eff */\\n --ring-action-link-components: var(--ring-main-components);\\n --ring-action-link-color: rgb(var(--ring-main-components)); /* #008eff */\\n --ring-main-hover-components: 0, 126, 229;\\n --ring-main-hover-color: rgb(var(--ring-main-hover-components)); /* #007ee5 */\\n --ring-icon-error-components: 219, 88, 96;\\n --ring-icon-error-color: rgb(var(--ring-icon-error-components)); /* #db5860 */\\n --ring-icon-warning-components: 237, 162, 0;\\n --ring-icon-warning-color: rgb(var(--ring-icon-warning-components)); /* #eda200 */\\n --ring-icon-success-components: 71, 212, 100;\\n --ring-icon-success-color: rgb(var(--ring-icon-success-components)); /* #47d464 */\\n --ring-popup-border-components: 0, 42, 76;\\n --ring-popup-border-color: rgba(var(--ring-popup-border-components), 0.1);\\n --ring-popup-shadow-color: rgba(var(--ring-popup-border-components), 0.15);\\n --ring-message-shadow-color: rgba(var(--ring-popup-border-components), 0.3);\\n --ring-pinned-shadow-components: 0, 0, 0;\\n --ring-pinned-shadow-color: rgb(var(--ring-pinned-shadow-components)); /* #000 */\\n --ring-button-danger-hover-color: var(--ring-error-color);\\n --ring-button-primary-border-components: 128, 198, 255;\\n --ring-button-primary-border-color: rgb(var(--ring-button-primary-border-components)); /* #80c6ff */\\n\\n /* Text */\\n --ring-hint-components: 128, 146, 157;\\n --ring-hint-color: rgb(var(--ring-hint-components)); /* #80929d */\\n --ring-link-components: 112, 177, 230;\\n --ring-link-color: rgb(var(--ring-link-components)); /* #70b1e6 */\\n --ring-error-components: 219, 88, 96;\\n --ring-error-color: rgb(var(--ring-error-components)); /* #db5860 */\\n --ring-warning-components: 237, 162, 0;\\n --ring-warning-color: rgb(var(--ring-warning-components)); /* #eda200 */\\n --ring-success-components: 71, 212, 100;\\n --ring-success-color: rgb(var(--ring-success-components)); /* #47d464 */\\n --ring-text-components: 187, 187, 187;\\n --ring-text-color: rgb(var(--ring-text-components)); /* #bbb */\\n --ring-active-text-components: 255, 255, 255;\\n --ring-active-text-color: rgb(var(--ring-active-text-components)); /* #fff */\\n --ring-heading-color: var(--ring-text-color);\\n --ring-secondary-components: 128, 146, 157;\\n --ring-secondary-color: rgb(var(--ring-secondary-components)); /* #80929d */\\n --ring-disabled-components: 81, 95, 104;\\n --ring-disabled-color: rgb(var(--ring-disabled-components)); /* #515F68 */\\n\\n /* Background */\\n --ring-content-background-components: 35, 39, 43;\\n --ring-content-background-color: rgb(var(--ring-content-background-components)); /* #23272b */\\n --ring-popup-background-components: 17, 19, 20;\\n --ring-popup-background-color: rgb(var(--ring-popup-background-components)); /* #111314 */\\n --ring-sidebar-background-components: 40, 52, 61;\\n --ring-sidebar-background-color: rgb(var(--ring-sidebar-background-components)); /* #28343d */\\n --ring-selected-background-components: 6, 38, 64;\\n --ring-selected-background-color: rgb(var(--ring-selected-background-components)); /* #062640 */\\n --ring-hover-background-components: 11, 26, 38;\\n --ring-hover-background-color: rgb(var(--ring-hover-background-components)); /* #0b1a26 */\\n --ring-navigation-background-components: 17, 19, 20;\\n --ring-navigation-background-color: rgb(var(--ring-navigation-background-components)); /* #111314 */\\n --ring-tag-background-components: 62, 77, 89;\\n --ring-tag-background-color: rgb(var(--ring-tag-background-components)); /* #3e4d59 */\\n --ring-tag-hover-background-components: 51, 62, 71;\\n --ring-tag-hover-background-color: rgb(var(--ring-tag-hover-background-components)); /* #333e47 */\\n --ring-removed-background-components: 143, 82, 71;\\n --ring-removed-background-color: rgb(var(--ring-removed-background-components)); /* #8f5247 */\\n --ring-warning-background-components: 89, 61, 1;\\n --ring-warning-background-color: rgb(var(--ring-warning-background-components)); /* #593d01 */\\n --ring-added-background-components: 54, 89, 71;\\n --ring-added-background-color: rgb(var(--ring-added-background-components)); /* #365947 */\\n --ring-disabled-background-components: 44, 47, 51;\\n --ring-disabled-background-color: rgb(var(--ring-disabled-background-components)); /* #2C2F33 */\\n --ring-disabled-selected-background-components: 44, 47, 51;\\n --ring-disabled-selected-background-color: rgb(var(--ring-disabled-selected-background-components)); /* #2C2F33 */\\n --ring-button-danger-active-components: 38, 8, 10;\\n --ring-button-danger-active-color: rgb(var(--ring-button-danger-active-components)); /* #26080a */\\n --ring-button-primary-background-components: 0, 126, 229;\\n --ring-button-primary-background-color: rgb(var(--ring-button-primary-background-components)); /* #007ee5 */\\n --ring-table-loader-background-color: rgba(var(--ring-content-background-components), 0.5); /* #23272b80 */\\n\\n /* Code */\\n --ring-code-background-components: 43, 43, 43;\\n --ring-code-background-color: rgb(var(--ring-code-background-components)); /* #2b2b2b */\\n --ring-code-components: 169, 183, 198;\\n --ring-code-color: rgb(var(--ring-code-components)); /* #a9b7c6 */\\n --ring-code-meta-components: 187, 181, 41;\\n --ring-code-meta-color: rgb(var(--ring-code-meta-components)); /* #bbb529 */\\n --ring-code-keyword-components: 204, 120, 50;\\n --ring-code-keyword-color: rgb(var(--ring-code-keyword-components)); /* #cc7832 */\\n --ring-code-tag-background-components: 43, 43, 43;\\n --ring-code-tag-background-color: rgb(var(--ring-code-tag-background-components)); /* #2b2b2b */\\n --ring-code-tag-components: 232, 191, 106;\\n --ring-code-tag-color: rgb(var(--ring-code-tag-components)); /* #e8bf6a */\\n --ring-code-tag-font-weight: normal;\\n --ring-code-field-components: 152, 118, 170;\\n --ring-code-field-color: rgb(var(--ring-code-tag-font-weight)); /* #9876aa */\\n --ring-code-attribute-components: 186, 186, 186;\\n --ring-code-attribute-color: rgb(var(--ring-code-attribute-components)); /* #bababa */\\n --ring-code-number-components: 104, 151, 187;\\n --ring-code-number-color: rgb(var(--ring-code-number-components)); /* #6897bb */\\n --ring-code-string-components: 106, 135, 89;\\n --ring-code-string-color: rgb(var(--ring-code-string-components)); /* #6a8759 */\\n --ring-code-addition-components: 68, 113, 82;\\n --ring-code-addition-color: rgb(var(--ring-code-addition-components)); /* #447152 */\\n --ring-code-deletion-components: 101, 110, 118;\\n --ring-code-deletion-color: rgb(var(--ring-code-deletion-components)); /* #656e76 */\\n\\n color-scheme: dark;\\n}\\n\",\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/global/variables_dark.css\"],names:[],mappings:\"AAAA,mCAAmC;;AAEnC;;;EAGE,kCAAkC;EAClC,mDAAmD,EAAE,YAAY;EACjE,sCAAsC;EACtC,yDAAyD,EAAE,YAAY;EACvE,qCAAqC;EACrC,mDAAmD,EAAE,YAAY;EACjE,+CAA+C;EAC/C,uEAAuE,EAAE,YAAY;EACrF,6CAA6C;EAC7C,yEAAyE,EAAE,YAAY;EACvF,sDAAsD;EACtD,2FAA2F,EAAE,YAAY;EACzG,wDAAwD;EACxD,+FAA+F,EAAE,YAAY,EAAE,uBAAuB;EACtI,2CAA2C;EAC3C,qEAAqE,EAAE,YAAY;EACnF,6CAA6C;EAC7C,mEAAmE,EAAE,YAAY;EACjF,mCAAmC;EACnC,mDAAmD,EAAE,YAAY;EACjE,0DAA0D;EAC1D,0DAA0D,EAAE,YAAY;EACxE,yCAAyC;EACzC,+DAA+D,EAAE,YAAY;EAC7E,yCAAyC;EACzC,+DAA+D,EAAE,YAAY;EAC7E,2CAA2C;EAC3C,mEAAmE,EAAE,YAAY;EACjF,4CAA4C;EAC5C,mEAAmE,EAAE,YAAY;EACjF,yCAAyC;EACzC,yEAAyE;EACzE,0EAA0E;EAC1E,2EAA2E;EAC3E,wCAAwC;EACxC,qEAAqE,EAAE,SAAS;EAChF,yDAAyD;EACzD,sDAAsD;EACtD,qFAAqF,EAAE,YAAY;;EAEnG,SAAS;EACT,qCAAqC;EACrC,mDAAmD,EAAE,YAAY;EACjE,qCAAqC;EACrC,mDAAmD,EAAE,YAAY;EACjE,oCAAoC;EACpC,qDAAqD,EAAE,YAAY;EACnE,sCAAsC;EACtC,yDAAyD,EAAE,YAAY;EACvE,uCAAuC;EACvC,yDAAyD,EAAE,YAAY;EACvE,qCAAqC;EACrC,mDAAmD,EAAE,SAAS;EAC9D,4CAA4C;EAC5C,iEAAiE,EAAE,SAAS;EAC5E,4CAA4C;EAC5C,0CAA0C;EAC1C,6DAA6D,EAAE,YAAY;EAC3E,uCAAuC;EACvC,2DAA2D,EAAE,YAAY;;EAEzE,eAAe;EACf,gDAAgD;EAChD,+EAA+E,EAAE,YAAY;EAC7F,8CAA8C;EAC9C,2EAA2E,EAAE,YAAY;EACzF,gDAAgD;EAChD,+EAA+E,EAAE,YAAY;EAC7F,gDAAgD;EAChD,iFAAiF,EAAE,YAAY;EAC/F,8CAA8C;EAC9C,2EAA2E,EAAE,YAAY;EACzF,mDAAmD;EACnD,qFAAqF,EAAE,YAAY;EACnG,4CAA4C;EAC5C,uEAAuE,EAAE,YAAY;EACrF,kDAAkD;EAClD,mFAAmF,EAAE,YAAY;EACjG,iDAAiD;EACjD,+EAA+E,EAAE,YAAY;EAC7F,+CAA+C;EAC/C,+EAA+E,EAAE,YAAY;EAC7F,8CAA8C;EAC9C,2EAA2E,EAAE,YAAY;EACzF,iDAAiD;EACjD,iFAAiF,EAAE,YAAY;EAC/F,0DAA0D;EAC1D,mGAAmG,EAAE,YAAY;EACjH,iDAAiD;EACjD,mFAAmF,EAAE,YAAY;EACjG,wDAAwD;EACxD,6FAA6F,EAAE,YAAY;EAC3G,0FAA0F,EAAE,cAAc;;EAE1G,SAAS;EACT,6CAA6C;EAC7C,yEAAyE,EAAE,YAAY;EACvF,qCAAqC;EACrC,mDAAmD,EAAE,YAAY;EACjE,yCAAyC;EACzC,6DAA6D,EAAE,YAAY;EAC3E,4CAA4C;EAC5C,mEAAmE,EAAE,YAAY;EACjF,iDAAiD;EACjD,iFAAiF,EAAE,YAAY;EAC/F,yCAAyC;EACzC,2DAA2D,EAAE,YAAY;EACzE,mCAAmC;EACnC,2CAA2C;EAC3C,8DAA8D,EAAE,YAAY;EAC5E,+CAA+C;EAC/C,uEAAuE,EAAE,YAAY;EACrF,4CAA4C;EAC5C,iEAAiE,EAAE,YAAY;EAC/E,2CAA2C;EAC3C,iEAAiE,EAAE,YAAY;EAC/E,4CAA4C;EAC5C,qEAAqE,EAAE,YAAY;EACnF,8CAA8C;EAC9C,qEAAqE,EAAE,YAAY;;EAEnF,kBAAkB;AACpB\",sourcesContent:[\"/* stylelint-disable color-no-hex */\\n\\n:global(.ring-ui-theme-dark),\\n.dark,\\n:root.dark {\\n --ring-line-components: 71, 81, 89;\\n --ring-line-color: rgb(var(--ring-line-components)); /* #475159 */\\n --ring-borders-components: 64, 99, 128;\\n --ring-borders-color: rgb(var(--ring-borders-components)); /* #406380 */\\n --ring-icon-components: 128, 146, 157;\\n --ring-icon-color: rgb(var(--ring-icon-components)); /* #80929d */\\n --ring-icon-secondary-components: 128, 146, 157;\\n --ring-icon-secondary-color: rgb(var(--ring-icon-secondary-components)); /* #80929d */\\n --ring-border-disabled-components: 54, 54, 54;\\n --ring-border-disabled-color: rgb(var(--ring-border-disabled-components)); /* #363636 */\\n --ring-border-selected-disabled-components: 54, 54, 54;\\n --ring-border-selected-disabled-color: rgb(var(--ring-border-selected-disabled-components)); /* #363636 */\\n --ring-border-unselected-disabled-components: 54, 54, 54;\\n --ring-border-unselected-disabled-color: rgb(var(--ring-border-unselected-disabled-components)); /* #363636 */ /* TODO remove in 6.0 */\\n --ring-icon-disabled-components: 80, 82, 83;\\n --ring-icon-disabled-color: rgb(var(--ring-icon-disabled-components)); /* #505253 */\\n --ring-border-hover-components: 112, 177, 230;\\n --ring-border-hover-color: rgb(var(--ring-border-hover-components)); /* #70b1e6 */\\n --ring-main-components: 0, 142, 255;\\n --ring-main-color: rgb(var(--ring-main-components)); /* #008eff */\\n --ring-action-link-components: var(--ring-main-components);\\n --ring-action-link-color: rgb(var(--ring-main-components)); /* #008eff */\\n --ring-main-hover-components: 0, 126, 229;\\n --ring-main-hover-color: rgb(var(--ring-main-hover-components)); /* #007ee5 */\\n --ring-icon-error-components: 219, 88, 96;\\n --ring-icon-error-color: rgb(var(--ring-icon-error-components)); /* #db5860 */\\n --ring-icon-warning-components: 237, 162, 0;\\n --ring-icon-warning-color: rgb(var(--ring-icon-warning-components)); /* #eda200 */\\n --ring-icon-success-components: 71, 212, 100;\\n --ring-icon-success-color: rgb(var(--ring-icon-success-components)); /* #47d464 */\\n --ring-popup-border-components: 0, 42, 76;\\n --ring-popup-border-color: rgba(var(--ring-popup-border-components), 0.1);\\n --ring-popup-shadow-color: rgba(var(--ring-popup-border-components), 0.15);\\n --ring-message-shadow-color: rgba(var(--ring-popup-border-components), 0.3);\\n --ring-pinned-shadow-components: 0, 0, 0;\\n --ring-pinned-shadow-color: rgb(var(--ring-pinned-shadow-components)); /* #000 */\\n --ring-button-danger-hover-color: var(--ring-error-color);\\n --ring-button-primary-border-components: 128, 198, 255;\\n --ring-button-primary-border-color: rgb(var(--ring-button-primary-border-components)); /* #80c6ff */\\n\\n /* Text */\\n --ring-hint-components: 128, 146, 157;\\n --ring-hint-color: rgb(var(--ring-hint-components)); /* #80929d */\\n --ring-link-components: 112, 177, 230;\\n --ring-link-color: rgb(var(--ring-link-components)); /* #70b1e6 */\\n --ring-error-components: 219, 88, 96;\\n --ring-error-color: rgb(var(--ring-error-components)); /* #db5860 */\\n --ring-warning-components: 237, 162, 0;\\n --ring-warning-color: rgb(var(--ring-warning-components)); /* #eda200 */\\n --ring-success-components: 71, 212, 100;\\n --ring-success-color: rgb(var(--ring-success-components)); /* #47d464 */\\n --ring-text-components: 187, 187, 187;\\n --ring-text-color: rgb(var(--ring-text-components)); /* #bbb */\\n --ring-active-text-components: 255, 255, 255;\\n --ring-active-text-color: rgb(var(--ring-active-text-components)); /* #fff */\\n --ring-heading-color: var(--ring-text-color);\\n --ring-secondary-components: 128, 146, 157;\\n --ring-secondary-color: rgb(var(--ring-secondary-components)); /* #80929d */\\n --ring-disabled-components: 81, 95, 104;\\n --ring-disabled-color: rgb(var(--ring-disabled-components)); /* #515F68 */\\n\\n /* Background */\\n --ring-content-background-components: 35, 39, 43;\\n --ring-content-background-color: rgb(var(--ring-content-background-components)); /* #23272b */\\n --ring-popup-background-components: 17, 19, 20;\\n --ring-popup-background-color: rgb(var(--ring-popup-background-components)); /* #111314 */\\n --ring-sidebar-background-components: 40, 52, 61;\\n --ring-sidebar-background-color: rgb(var(--ring-sidebar-background-components)); /* #28343d */\\n --ring-selected-background-components: 6, 38, 64;\\n --ring-selected-background-color: rgb(var(--ring-selected-background-components)); /* #062640 */\\n --ring-hover-background-components: 11, 26, 38;\\n --ring-hover-background-color: rgb(var(--ring-hover-background-components)); /* #0b1a26 */\\n --ring-navigation-background-components: 17, 19, 20;\\n --ring-navigation-background-color: rgb(var(--ring-navigation-background-components)); /* #111314 */\\n --ring-tag-background-components: 62, 77, 89;\\n --ring-tag-background-color: rgb(var(--ring-tag-background-components)); /* #3e4d59 */\\n --ring-tag-hover-background-components: 51, 62, 71;\\n --ring-tag-hover-background-color: rgb(var(--ring-tag-hover-background-components)); /* #333e47 */\\n --ring-removed-background-components: 143, 82, 71;\\n --ring-removed-background-color: rgb(var(--ring-removed-background-components)); /* #8f5247 */\\n --ring-warning-background-components: 89, 61, 1;\\n --ring-warning-background-color: rgb(var(--ring-warning-background-components)); /* #593d01 */\\n --ring-added-background-components: 54, 89, 71;\\n --ring-added-background-color: rgb(var(--ring-added-background-components)); /* #365947 */\\n --ring-disabled-background-components: 44, 47, 51;\\n --ring-disabled-background-color: rgb(var(--ring-disabled-background-components)); /* #2C2F33 */\\n --ring-disabled-selected-background-components: 44, 47, 51;\\n --ring-disabled-selected-background-color: rgb(var(--ring-disabled-selected-background-components)); /* #2C2F33 */\\n --ring-button-danger-active-components: 38, 8, 10;\\n --ring-button-danger-active-color: rgb(var(--ring-button-danger-active-components)); /* #26080a */\\n --ring-button-primary-background-components: 0, 126, 229;\\n --ring-button-primary-background-color: rgb(var(--ring-button-primary-background-components)); /* #007ee5 */\\n --ring-table-loader-background-color: rgba(var(--ring-content-background-components), 0.5); /* #23272b80 */\\n\\n /* Code */\\n --ring-code-background-components: 43, 43, 43;\\n --ring-code-background-color: rgb(var(--ring-code-background-components)); /* #2b2b2b */\\n --ring-code-components: 169, 183, 198;\\n --ring-code-color: rgb(var(--ring-code-components)); /* #a9b7c6 */\\n --ring-code-meta-components: 187, 181, 41;\\n --ring-code-meta-color: rgb(var(--ring-code-meta-components)); /* #bbb529 */\\n --ring-code-keyword-components: 204, 120, 50;\\n --ring-code-keyword-color: rgb(var(--ring-code-keyword-components)); /* #cc7832 */\\n --ring-code-tag-background-components: 43, 43, 43;\\n --ring-code-tag-background-color: rgb(var(--ring-code-tag-background-components)); /* #2b2b2b */\\n --ring-code-tag-components: 232, 191, 106;\\n --ring-code-tag-color: rgb(var(--ring-code-tag-components)); /* #e8bf6a */\\n --ring-code-tag-font-weight: normal;\\n --ring-code-field-components: 152, 118, 170;\\n --ring-code-field-color: rgb(var(--ring-code-tag-font-weight)); /* #9876aa */\\n --ring-code-attribute-components: 186, 186, 186;\\n --ring-code-attribute-color: rgb(var(--ring-code-attribute-components)); /* #bababa */\\n --ring-code-number-components: 104, 151, 187;\\n --ring-code-number-color: rgb(var(--ring-code-number-components)); /* #6897bb */\\n --ring-code-string-components: 106, 135, 89;\\n --ring-code-string-color: rgb(var(--ring-code-string-components)); /* #6a8759 */\\n --ring-code-addition-components: 68, 113, 82;\\n --ring-code-addition-color: rgb(var(--ring-code-addition-components)); /* #447152 */\\n --ring-code-deletion-components: 101, 110, 118;\\n --ring-code-deletion-color: rgb(var(--ring-code-deletion-components)); /* #656e76 */\\n\\n color-scheme: dark;\\n}\\n\"],sourceRoot:\"\"}]),a.locals={dark:\"dark_d4a9\"};const l=a},5066:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>s});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(9106),c=t(5280),u=a()(o());u.i(c.A),u.i(l.default,\"\",!0),u.push([e.id,'.icon_aaa7 {\\n display: inline-block;\\n\\n fill: currentColor;\\n}\\n\\n.glyph_f986 {\\n display: inline-flex;\\n\\n margin-right: -1px;\\n margin-left: -1px;\\n\\n pointer-events: none;\\n}\\n\\n.glyph_f986[width=\"10\"] {\\n vertical-align: -1px;\\n }\\n\\n.glyph_f986[width=\"14\"] {\\n margin-right: -2px;\\n margin-left: 0;\\n\\n vertical-align: -3px;\\n }\\n\\n.glyph_f986[width=\"16\"] {\\n vertical-align: -3px;\\n }\\n\\n.glyph_f986[width=\"20\"] {\\n vertical-align: -2px;\\n }\\n\\n.glyph_f986.compatibilityMode_d631 {\\n width: 16px;\\n height: 16px;\\n margin-right: 0;\\n margin-left: 0;\\n }\\n\\n/* HACK: This media query hack makes styles applied for WebKit browsers only */\\n/* stylelint-disable-next-line media-feature-name-no-vendor-prefix */\\n@media screen and (-webkit-min-device-pixel-ratio: 0) {\\n .glyph_f986 {\\n width: auto; /* Safari size bug workaround, see https://youtrack.jetbrains.com/issue/RG-1983 */\\n }\\n}\\n\\n.gray_f6a8 {\\n color: var(--ring-icon-secondary-color);\\n}\\n\\n.hover_fc27 {\\n color: var(--ring-icon-hover-color);\\n}\\n\\n.green_bfb1 {\\n color: var(--ring-icon-success-color);\\n}\\n\\n.magenta_b045 {\\n color: var(--ring-link-hover-color);\\n}\\n\\n.red_a7ec {\\n color: var(--ring-icon-error-color);\\n}\\n\\n.blue_ec1e {\\n color: var(--ring-main-color);\\n}\\n\\n.white_c896 {\\n color: var(--ring-white-text-color);\\n}\\n\\n.loading_c5e2 {\\n animation-name: icon-loading_fe22;\\n animation-duration: 1200ms;\\n animation-iteration-count: infinite;\\n}\\n\\n@keyframes icon-loading_fe22 {\\n 0% {\\n transform: scale(1);\\n }\\n\\n 50% {\\n transform: scale(0.9);\\n\\n opacity: 0.5;\\n }\\n\\n 100% {\\n transform: scale(1);\\n }\\n}\\n',\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/icon/icon.css\"],names:[],mappings:\"AAIA;EACE,qBAAqB;;EAErB,kBAAkB;AACpB;;AAEA;EACE,oBAAoB;;EAEpB,kBAAkB;EAClB,iBAAiB;;EAEjB,oBAAoB;AA2BtB;;AAzBE;IACE,oBAAoB;EACtB;;AAEA;IACE,kBAAkB;IAClB,cAAc;;IAEd,oBAAoB;EACtB;;AAEA;IACE,oBAAoB;EACtB;;AAEA;IACE,oBAAoB;EACtB;;AAEA;IACE,WAAqB;IACrB,YAAsB;IACtB,eAAe;IACf,cAAc;EAChB;;AAGF,8EAA8E;AAC9E,oEAAoE;AACpE;EACE;IACE,WAAW,EAAE,iFAAiF;EAChG;AACF;;AAEA;EACE,uCAAuC;AACzC;;AAEA;EACE,mCAAmC;AACrC;;AAEA;EACE,qCAAqC;AACvC;;AAEA;EACE,mCAAmC;AACrC;;AAEA;EACE,mCAAmC;AACrC;;AAEA;EACE,6BAA6B;AAC/B;;AAEA;EACE,mCAAmC;AACrC;;AAEA;EACE,iCAA4B;EAC5B,0BAA0B;EAC1B,mCAAmC;AACrC;;AAEA;EACE;IACE,mBAAmB;EACrB;;EAEA;IACE,qBAAqB;;IAErB,YAAY;EACd;;EAEA;IACE,mBAAmB;EACrB;AACF\",sourcesContent:['@import \"../global/variables.css\";\\n\\n@value unit from \"../global/global.css\";\\n\\n.icon {\\n display: inline-block;\\n\\n fill: currentColor;\\n}\\n\\n.glyph {\\n display: inline-flex;\\n\\n margin-right: -1px;\\n margin-left: -1px;\\n\\n pointer-events: none;\\n\\n &[width=\"10\"] {\\n vertical-align: -1px;\\n }\\n\\n &[width=\"14\"] {\\n margin-right: -2px;\\n margin-left: 0;\\n\\n vertical-align: -3px;\\n }\\n\\n &[width=\"16\"] {\\n vertical-align: -3px;\\n }\\n\\n &[width=\"20\"] {\\n vertical-align: -2px;\\n }\\n\\n &.compatibilityMode {\\n width: calc(unit * 2);\\n height: calc(unit * 2);\\n margin-right: 0;\\n margin-left: 0;\\n }\\n}\\n\\n/* HACK: This media query hack makes styles applied for WebKit browsers only */\\n/* stylelint-disable-next-line media-feature-name-no-vendor-prefix */\\n@media screen and (-webkit-min-device-pixel-ratio: 0) {\\n .glyph {\\n width: auto; /* Safari size bug workaround, see https://youtrack.jetbrains.com/issue/RG-1983 */\\n }\\n}\\n\\n.gray {\\n color: var(--ring-icon-secondary-color);\\n}\\n\\n.hover {\\n color: var(--ring-icon-hover-color);\\n}\\n\\n.green {\\n color: var(--ring-icon-success-color);\\n}\\n\\n.magenta {\\n color: var(--ring-link-hover-color);\\n}\\n\\n.red {\\n color: var(--ring-icon-error-color);\\n}\\n\\n.blue {\\n color: var(--ring-main-color);\\n}\\n\\n.white {\\n color: var(--ring-white-text-color);\\n}\\n\\n.loading {\\n animation-name: icon-loading;\\n animation-duration: 1200ms;\\n animation-iteration-count: infinite;\\n}\\n\\n@keyframes icon-loading {\\n 0% {\\n transform: scale(1);\\n }\\n\\n 50% {\\n transform: scale(0.9);\\n\\n opacity: 0.5;\\n }\\n\\n 100% {\\n transform: scale(1);\\n }\\n}\\n'],sourceRoot:\"\"}]),u.locals={unit:`${l.default.locals.unit}`,icon:\"icon_aaa7\",glyph:\"glyph_f986\",compatibilityMode:\"compatibilityMode_d631\",gray:\"gray_f6a8\",hover:\"hover_fc27\",green:\"green_bfb1\",magenta:\"magenta_b045\",red:\"red_a7ec\",blue:\"blue_ec1e\",white:\"white_c896\",loading:\"loading_c5e2\",\"icon-loading\":\"icon-loading_fe22\"};const s=u},8976:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>s});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(9106),c=t(5280),u=a()(o());u.i(c.A),u.i(l.default,\"\",!0),u.push([e.id,\":root {\\n --ring-input-xs: 96px;\\n --ring-input-s: 96px;\\n --ring-input-m: 240px;\\n --ring-input-l: 400px;\\n}\\n\\n/**\\n * @name Input Sizes\\n */\\n\\n/* XS */\\n\\n.ring-input-size_xs.ring-input-size_xs {\\n display: inline-block;\\n\\n width: 96px;\\n\\n width: var(--ring-input-xs);\\n}\\n\\n.ring-input-size_xs.ring-input-size_xs ~ .ring-error-bubble {\\n left: 98px;\\n left: calc(var(--ring-input-xs) + 2px);\\n}\\n\\n/* S */\\n\\n.ring-input-size_s.ring-input-size_s {\\n display: inline-block;\\n\\n width: 96px;\\n\\n width: var(--ring-input-s);\\n}\\n\\n.ring-input-size_s.ring-input-size_s ~ .ring-error-bubble {\\n left: 98px;\\n left: calc(var(--ring-input-s) + 2px);\\n}\\n\\n/* M */\\n\\n.ring-input-size_m.ring-input-size_m {\\n display: inline-block;\\n\\n width: 240px;\\n\\n width: var(--ring-input-m);\\n}\\n\\n.ring-input-size_m.ring-input-size_m ~ .ring-error-bubble {\\n left: 242px;\\n left: calc(var(--ring-input-m) + 2px);\\n}\\n\\n.ring-input-size_md.ring-input-size_md {\\n display: inline-block;\\n\\n width: 240px;\\n\\n width: var(--ring-input-m);\\n}\\n\\n.ring-input-size_md.ring-input-size_md ~ .ring-error-bubble {\\n left: 242px;\\n left: calc(var(--ring-input-m) + 2px);\\n}\\n\\n/* L */\\n\\n.ring-input-size_l.ring-input-size_l {\\n display: inline-block;\\n\\n width: 400px;\\n\\n width: var(--ring-input-l);\\n}\\n\\n.ring-input-size_l.ring-input-size_l ~ .ring-error-bubble {\\n left: 402px;\\n left: calc(var(--ring-input-l) + 2px);\\n}\\n\\n.ring-input-height_s.ring-input-height_s {\\n --ring-input-padding-block: 1px;\\n}\\n\\n.ring-input-height_m.ring-input-height_m {\\n --ring-input-padding-block: 3px;\\n}\\n\\n.ring-input-height_l.ring-input-height_l {\\n --ring-input-padding-block: 5px;\\n}\\n\",\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/input-size/input-size.css\"],names:[],mappings:\"AAIA;EACE,qBAAgC;EAChC,oBAA+B;EAC/B,qBAA+B;EAC/B,qBAA+B;AACjC;;AAEA;;EAEE;;AAEF,OAAO;;AAEP;EACE,qBAAqB;;EAErB,WAA2B;;EAA3B,2BAA2B;AAC7B;;AAEA;EACE,UAAsC;EAAtC,sCAAsC;AACxC;;AAEA,MAAM;;AAEN;EACE,qBAAqB;;EAErB,WAA0B;;EAA1B,0BAA0B;AAC5B;;AAEA;EACE,UAAqC;EAArC,qCAAqC;AACvC;;AAEA,MAAM;;AAEN;EACE,qBAAqB;;EAErB,YAA0B;;EAA1B,0BAA0B;AAC5B;;AAEA;EACE,WAAqC;EAArC,qCAAqC;AACvC;;AAEA;EACE,qBAAqB;;EAErB,YAA0B;;EAA1B,0BAA0B;AAC5B;;AAEA;EACE,WAAqC;EAArC,qCAAqC;AACvC;;AAEA,MAAM;;AAEN;EACE,qBAAqB;;EAErB,YAA0B;;EAA1B,0BAA0B;AAC5B;;AAEA;EACE,WAAqC;EAArC,qCAAqC;AACvC;;AAEA;EACE,+BAA+B;AACjC;;AAEA;EACE,+BAA+B;AACjC;;AAEA;EACE,+BAA+B;AACjC\",sourcesContent:['@import \"../global/variables.css\";\\n\\n@value unit from \"../global/global.css\";\\n\\n:root {\\n --ring-input-xs: calc(unit * 12);\\n --ring-input-s: calc(unit * 12);\\n --ring-input-m: calc(unit * 30);\\n --ring-input-l: calc(unit * 50);\\n}\\n\\n/**\\n * @name Input Sizes\\n */\\n\\n/* XS */\\n\\n:global(.ring-input-size_xs.ring-input-size_xs) {\\n display: inline-block;\\n\\n width: var(--ring-input-xs);\\n}\\n\\n:global(.ring-input-size_xs.ring-input-size_xs ~ .ring-error-bubble) {\\n left: calc(var(--ring-input-xs) + 2px);\\n}\\n\\n/* S */\\n\\n:global(.ring-input-size_s.ring-input-size_s) {\\n display: inline-block;\\n\\n width: var(--ring-input-s);\\n}\\n\\n:global(.ring-input-size_s.ring-input-size_s ~ .ring-error-bubble) {\\n left: calc(var(--ring-input-s) + 2px);\\n}\\n\\n/* M */\\n\\n:global(.ring-input-size_m.ring-input-size_m) {\\n display: inline-block;\\n\\n width: var(--ring-input-m);\\n}\\n\\n:global(.ring-input-size_m.ring-input-size_m ~ .ring-error-bubble) {\\n left: calc(var(--ring-input-m) + 2px);\\n}\\n\\n:global(.ring-input-size_md.ring-input-size_md) {\\n display: inline-block;\\n\\n width: var(--ring-input-m);\\n}\\n\\n:global(.ring-input-size_md.ring-input-size_md ~ .ring-error-bubble) {\\n left: calc(var(--ring-input-m) + 2px);\\n}\\n\\n/* L */\\n\\n:global(.ring-input-size_l.ring-input-size_l) {\\n display: inline-block;\\n\\n width: var(--ring-input-l);\\n}\\n\\n:global(.ring-input-size_l.ring-input-size_l ~ .ring-error-bubble) {\\n left: calc(var(--ring-input-l) + 2px);\\n}\\n\\n:global(.ring-input-height_s.ring-input-height_s) {\\n --ring-input-padding-block: 1px;\\n}\\n\\n:global(.ring-input-height_m.ring-input-height_m) {\\n --ring-input-padding-block: 3px;\\n}\\n\\n:global(.ring-input-height_l.ring-input-height_l) {\\n --ring-input-padding-block: 5px;\\n}\\n'],sourceRoot:\"\"}]),u.locals={unit:`${l.default.locals.unit}`};const s=u},8266:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>f});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(9106),c=t(5280),u=t(9892),s=a()(o());s.i(c.A),s.i(u.default),s.i(l.default,\"\",!0),s.push([e.id,'.outerContainer_cb70 {\\n --ring-input-icon-offset: 20px;\\n --ring-input-padding-inline: 8px;\\n --ring-input-background-color: var(--ring-content-background-color);\\n}\\n\\n.borderless_f79b {\\n /* stylelint-disable-next-line length-zero-no-unit */\\n --ring-input-padding-inline: 0px;\\n}\\n\\n.container_ee33 {\\n position: relative;\\n\\n box-sizing: border-box;\\n\\n font-size: var(--ring-font-size);\\n line-height: var(--ring-line-height);\\n}\\n\\n.container_ee33 * {\\n box-sizing: border-box;\\n }\\n\\n.input_f220 {\\n --ring-input-padding-start: var(--ring-input-padding-inline);\\n --ring-input-padding-end: var(--ring-input-padding-inline);\\n\\n width: 100%;\\n\\n margin: 0;\\n padding-top: var(--ring-input-padding-block);\\n padding-right: var(--ring-input-padding-end);\\n padding-bottom: var(--ring-input-padding-block);\\n padding-left: var(--ring-input-padding-start);\\n\\n transition: border-color var(--ring-ease);\\n\\n color: var(--ring-text-color);\\n border: 1px solid var(--ring-borders-color);\\n border-radius: var(--ring-border-radius);\\n outline: none;\\n background-color: var(--ring-input-background-color);\\n\\n font: inherit;\\n\\n caret-color: var(--ring-main-color);\\n}\\n\\n[dir=\"rtl\"] .input_f220 {\\n padding-right: var(--ring-input-padding-start);\\n padding-left: var(--ring-input-padding-end);\\n }\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.input_f220:hover {\\n transition: none;\\n\\n border-color: var(--ring-border-hover-color);\\n }}\\n\\n.error_ff90 .input_f220 {\\n border-color: var(--ring-icon-error-color);\\n }\\n\\n.input_f220:focus {\\n transition: none;\\n\\n border-color: var(--ring-main-color);\\n }\\n\\n.input_f220[disabled] {\\n color: var(--ring-disabled-color);\\n border-color: var(--ring-border-disabled-color);\\n background-color: var(--ring-disabled-background-color);\\n\\n -webkit-text-fill-color: var(--ring-disabled-color); /* Required for Safari, see RG-2063 for details */\\n }\\n\\n/*\\n Kill yellow/blue webkit autocomplete\\n https://css-tricks.com/snippets/css/change-autocomplete-styles-webkit-browsers/\\n */\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.input_f220:-webkit-autofill:hover {\\n -webkit-transition: background-color 50000s ease-in-out 0s;\\n transition: background-color 50000s ease-in-out 0s;\\n }}\\n\\n.input_f220:-webkit-autofill,\\n .input_f220:-webkit-autofill:focus {\\n -webkit-transition: background-color 50000s ease-in-out 0s;\\n transition: background-color 50000s ease-in-out 0s;\\n }\\n\\n.borderless_f79b .input_f220 {\\n border-color: transparent;\\n background-color: transparent;\\n}\\n\\n.withIcon_f066 .input_f220 {\\n --ring-input-padding-start: calc(var(--ring-input-padding-inline) + var(--ring-input-icon-offset));\\n}\\n\\n.clearable_fd1e .input_f220 {\\n --ring-input-padding-end: calc(var(--ring-input-padding-inline) + var(--ring-input-icon-offset));\\n}\\n\\n.icon_e49c {\\n position: absolute;\\n top: calc(var(--ring-input-padding-block) + 1px);\\n left: var(--ring-input-padding-inline);\\n\\n pointer-events: none;\\n\\n color: var(--ring-icon-secondary-color);\\n}\\n\\n[dir=\"rtl\"] .icon_e49c {\\n right: 8px;\\n left: auto;\\n }\\n\\n.clear_ffc3 {\\n position: absolute;\\n top: calc(var(--ring-input-padding-block) + 2px);\\n right: var(--ring-input-padding-inline);\\n\\n height: auto;\\n\\n padding-right: 0;\\n\\n line-height: inherit;\\n}\\n\\n.empty_cc0d .clear_ffc3 {\\n display: none;\\n }\\n\\n[dir=\"rtl\"] .clear_ffc3 {\\n right: auto;\\n left: 8px;\\n }\\n\\ntextarea.input_f220 {\\n overflow: hidden;\\n\\n box-sizing: border-box;\\n\\n resize: none;\\n}\\n\\n.input_f220::-moz-placeholder {\\n color: var(--ring-disabled-color);\\n}\\n\\n.input_f220::placeholder {\\n color: var(--ring-disabled-color);\\n}\\n\\n.input_f220::-webkit-search-cancel-button {\\n -webkit-appearance: none;\\n}\\n\\n.errorText_e447 {\\n margin-top: 4px;\\n\\n color: var(--ring-error-color);\\n\\n font-size: var(--ring-font-size-smaller);\\n line-height: var(--ring-line-height-lowest);\\n}\\n\\n.sizeS_c560 {\\n width: 96px;\\n}\\n\\n.sizeM_aee6 {\\n width: 240px;\\n}\\n\\n.sizeL_b0ca {\\n width: 400px;\\n}\\n\\n.sizeFULL_f4f9 {\\n width: 100%;\\n}\\n\\n.heightS_a68d {\\n --ring-input-padding-block: 1px;\\n}\\n\\n.heightM_bc35 {\\n --ring-input-padding-block: 3px;\\n}\\n\\n.heightL_f82d {\\n --ring-input-padding-block: 5px;\\n}\\n',\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/input/input.css\",\"\"],names:[],mappings:\"AAKA;EACE,8BAA0C;EAC1C,gCAAiC;EACjC,mEAAmE;AACrE;;AAEA;EACE,oDAAoD;EACpD,gCAAgC;AAClC;;AAEA;EACE,kBAAkB;;EAElB,sBAAsB;;EAEtB,gCAAgC;EAChC,oCAAoC;AAKtC;;AAHE;IACE,sBAAsB;EACxB;;AAGF;EACE,4DAA4D;EAC5D,0DAA0D;;EAE1D,WAAW;;EAEX,SAAS;EACT,4CAA4C;EAC5C,4CAA4C;EAC5C,+CAA+C;EAC/C,6CAA6C;;EAE7C,yCAAyC;;EAEzC,6BAA6B;EAC7B,2CAA2C;EAC3C,wCAAwC;EACxC,aAAa;EACb,oDAAoD;;EAEpD,aAAa;;EAEb,mCAAmC;AA0CrC;;AAxCE;IACE,8CAA8C;IAC9C,2CAA2C;EAC7C;;ACxDF,wGAAA;IAAA,iBAAA;;IAAA,6CAAA;GAAA,CAAA;;ADgEE;IACE,0CAA0C;EAC5C;;AAEA;IACE,gBAAgB;;IAEhB,oCAAoC;EACtC;;AAEA;IACE,iCAAiC;IACjC,+CAA+C;IAC/C,uDAAuD;;IAEvD,mDAAmD,EAAE,iDAAiD;EACxG;;AAEA;;;GAGC;;ACrFH,wGAAA;MAAA,2DAAA;MAAA,mDAAA;KAAA,CAAA;;ADuFI;;MAGE,0DAAkD;MAAlD,kDAAkD;IACpD;;AAIJ;EACE,yBAAyB;EACzB,6BAA6B;AAC/B;;AAEA;EACE,kGAAkG;AACpG;;AAEA;EACE,gGAAgG;AAClG;;AAEA;EACE,kBAAkB;EAClB,gDAAgD;EAChD,sCAAsC;;EAEtC,oBAAoB;;EAEpB,uCAAuC;AAMzC;;AAJE;IACE,UAAW;IACX,UAAU;EACZ;;AAGF;EACE,kBAAkB;EAClB,gDAAgD;EAChD,uCAAuC;;EAEvC,YAAY;;EAEZ,gBAAgB;;EAEhB,oBAAoB;AAUtB;;AARE;IACE,aAAa;EACf;;AAEA;IACE,WAAW;IACX,SAAU;EACZ;;AAGF;EACE,gBAAgB;;EAEhB,sBAAsB;;EAEtB,YAAY;AACd;;AAEA;EACE,iCAAiC;AACnC;;AAFA;EACE,iCAAiC;AACnC;;AAEA;EACE,wBAAwB;AAC1B;;AAEA;EACE,eAA0B;;EAE1B,8BAA8B;;EAE9B,wCAAwC;EACxC,2CAA2C;AAC7C;;AAEA;EACE,WAAsB;AACxB;;AAEA;EACE,YAAsB;AACxB;;AAEA;EACE,YAAsB;AACxB;;AAEA;EACE,WAAW;AACb;;AAEA;EACE,+BAA+B;AACjC;;AAEA;EACE,+BAA+B;AACjC;;AAEA;EACE,+BAA+B;AACjC\",sourcesContent:['@import \"../global/variables.css\";\\n@import \"../button/button.css\";\\n\\n@value unit from \"../global/global.css\";\\n\\n.outerContainer {\\n --ring-input-icon-offset: calc(unit * 2.5);\\n --ring-input-padding-inline: unit;\\n --ring-input-background-color: var(--ring-content-background-color);\\n}\\n\\n.borderless {\\n /* stylelint-disable-next-line length-zero-no-unit */\\n --ring-input-padding-inline: 0px;\\n}\\n\\n.container {\\n position: relative;\\n\\n box-sizing: border-box;\\n\\n font-size: var(--ring-font-size);\\n line-height: var(--ring-line-height);\\n\\n & * {\\n box-sizing: border-box;\\n }\\n}\\n\\n.input {\\n --ring-input-padding-start: var(--ring-input-padding-inline);\\n --ring-input-padding-end: var(--ring-input-padding-inline);\\n\\n width: 100%;\\n\\n margin: 0;\\n padding-top: var(--ring-input-padding-block);\\n padding-right: var(--ring-input-padding-end);\\n padding-bottom: var(--ring-input-padding-block);\\n padding-left: var(--ring-input-padding-start);\\n\\n transition: border-color var(--ring-ease);\\n\\n color: var(--ring-text-color);\\n border: 1px solid var(--ring-borders-color);\\n border-radius: var(--ring-border-radius);\\n outline: none;\\n background-color: var(--ring-input-background-color);\\n\\n font: inherit;\\n\\n caret-color: var(--ring-main-color);\\n\\n [dir=\"rtl\"] & {\\n padding-right: var(--ring-input-padding-start);\\n padding-left: var(--ring-input-padding-end);\\n }\\n\\n &:hover {\\n transition: none;\\n\\n border-color: var(--ring-border-hover-color);\\n }\\n\\n .error & {\\n border-color: var(--ring-icon-error-color);\\n }\\n\\n &:focus {\\n transition: none;\\n\\n border-color: var(--ring-main-color);\\n }\\n\\n &[disabled] {\\n color: var(--ring-disabled-color);\\n border-color: var(--ring-border-disabled-color);\\n background-color: var(--ring-disabled-background-color);\\n\\n -webkit-text-fill-color: var(--ring-disabled-color); /* Required for Safari, see RG-2063 for details */\\n }\\n\\n /*\\n Kill yellow/blue webkit autocomplete\\n https://css-tricks.com/snippets/css/change-autocomplete-styles-webkit-browsers/\\n */\\n &:-webkit-autofill {\\n &,\\n &:hover,\\n &:focus {\\n transition: background-color 50000s ease-in-out 0s;\\n }\\n }\\n}\\n\\n.borderless .input {\\n border-color: transparent;\\n background-color: transparent;\\n}\\n\\n.withIcon .input {\\n --ring-input-padding-start: calc(var(--ring-input-padding-inline) + var(--ring-input-icon-offset));\\n}\\n\\n.clearable .input {\\n --ring-input-padding-end: calc(var(--ring-input-padding-inline) + var(--ring-input-icon-offset));\\n}\\n\\n.icon {\\n position: absolute;\\n top: calc(var(--ring-input-padding-block) + 1px);\\n left: var(--ring-input-padding-inline);\\n\\n pointer-events: none;\\n\\n color: var(--ring-icon-secondary-color);\\n\\n [dir=\"rtl\"] & {\\n right: unit;\\n left: auto;\\n }\\n}\\n\\n.clear {\\n position: absolute;\\n top: calc(var(--ring-input-padding-block) + 2px);\\n right: var(--ring-input-padding-inline);\\n\\n height: auto;\\n\\n padding-right: 0;\\n\\n line-height: inherit;\\n\\n .empty & {\\n display: none;\\n }\\n\\n [dir=\"rtl\"] & {\\n right: auto;\\n left: unit;\\n }\\n}\\n\\ntextarea.input {\\n overflow: hidden;\\n\\n box-sizing: border-box;\\n\\n resize: none;\\n}\\n\\n.input::placeholder {\\n color: var(--ring-disabled-color);\\n}\\n\\n.input::-webkit-search-cancel-button {\\n -webkit-appearance: none;\\n}\\n\\n.errorText {\\n margin-top: calc(unit / 2);\\n\\n color: var(--ring-error-color);\\n\\n font-size: var(--ring-font-size-smaller);\\n line-height: var(--ring-line-height-lowest);\\n}\\n\\n.sizeS {\\n width: calc(unit * 12);\\n}\\n\\n.sizeM {\\n width: calc(unit * 30);\\n}\\n\\n.sizeL {\\n width: calc(unit * 50);\\n}\\n\\n.sizeFULL {\\n width: 100%;\\n}\\n\\n.heightS {\\n --ring-input-padding-block: 1px;\\n}\\n\\n.heightM {\\n --ring-input-padding-block: 3px;\\n}\\n\\n.heightL {\\n --ring-input-padding-block: 5px;\\n}\\n',null],sourceRoot:\"\"}]),s.locals={unit:`${l.default.locals.unit}`,outerContainer:\"outerContainer_cb70\",borderless:\"borderless_f79b\",container:\"container_ee33\",input:\"input_f220\",error:\"error_ff90\",withIcon:\"withIcon_f066\",clearable:\"clearable_fd1e\",icon:\"icon_e49c\",clear:\"clear_ffc3\",empty:\"empty_cc0d\",errorText:\"errorText_e447\",sizeS:\"sizeS_c560\",sizeM:\"sizeM_aee6\",sizeL:\"sizeL_b0ca\",sizeFULL:\"sizeFULL_f4f9\",heightS:\"heightS_a68d\",heightM:\"heightM_bc35\",heightL:\"heightL_f82d\"};const f=s},6960:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>u});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(5280),c=a()(o());c.i(l.A),c.push([e.id,\".link_e6e5 {\\n cursor: pointer;\\n transition: color var(--ring-fast-ease);\\n\\n color: var(--ring-link-color);\\n\\n outline: none;\\n}\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.link_e6e5:hover {\\n transition: none;\\n\\n color: var(--ring-link-hover-color);\\n }}\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.link_e6e5:hover {\\n text-decoration: none;\\n }}\\n\\n.link_e6e5 {\\n text-decoration: none;\\n }\\n\\n.link_e6e5.hover_bed7 {\\n transition: none;\\n\\n color: var(--ring-link-hover-color);\\n }\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.link_e6e5:hover .inner_e3ba {\\n border-width: 0;\\n border-bottom: 2px solid;\\n border-image-source: linear-gradient(currentcolor 50%, transparent 50%);\\n border-image-slice: 0 0 100% 0;\\n }}\\n\\n.link_e6e5.active_f804 {\\n color: inherit;\\n }\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.link_e6e5.compatibilityUnderlineMode_e7a0:hover {\\n text-decoration: underline;\\n\\n /* stylelint-disable-next-line selector-max-specificity */\\n }\\n .link_e6e5.compatibilityUnderlineMode_e7a0:hover .inner_e3ba {\\n border: none;\\n }}\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.link_e6e5.pseudo_d9ae:hover {\\n text-decoration: none;\\n\\n /* stylelint-disable-next-line selector-max-specificity */\\n }\\n .link_e6e5.pseudo_d9ae:hover .inner_e3ba {\\n border: none;\\n }}\\n\\n.link_e6e5:focus-visible {\\n box-shadow: 0 0 0 2px var(--ring-border-hover-color);\\n }\\n\\n@media (-webkit-min-device-pixel-ratio: 2), (min-resolution: 2dppx) {@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.link_e6e5:hover .inner_e3ba {\\n border-bottom-width: 1px;\\n }}\\n}\\n\\n.text_e98a {\\n border-radius: var(--ring-border-radius);\\n}\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.inherit_d267:not(:hover) {\\n color: inherit;\\n}}\\n\\n.pseudo_d9ae {\\n margin: 0;\\n padding: 0;\\n\\n text-align: left;\\n\\n border: 0;\\n\\n background: transparent;\\n\\n font: inherit;\\n}\\n\\n.pseudo_d9ae::-moz-focus-inner {\\n padding: 0;\\n\\n border: 0;\\n }\\n\",\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/link/link.css\",\"\"],names:[],mappings:\"AAEA;EACE,eAAe;EACf,uCAAuC;;EAEvC,6BAA6B;;EA2C7B,aAAa;AAKf;;ACtDA,wGAAA;IAAA,iBAAA;;IAAA,oCAAA;GAAA,CAAA;;AAAA,wGAAA;IAAA,sBAAA;GAAA,CAAA;;ADQE;IAEE,qBAAqB;EACvB;;AAEA;IAEE,gBAAgB;;IAEhB,mCAAmC;EACrC;;AClBF,wGAAA;IAAA,gBAAA;IAAA,yBAAA;IAAA,wEAAA;IAAA,+BAAA;GAAA,CAAA;;AD2BE;IACE,cAAc;EAChB;;AC7BF,wGAAA;IAAA,2BAAA;;IAAA,0DAAA;GAAA;IAAA;MAAA,aAAA;KAAA,CAAA;;AAAA,wGAAA;IAAA,sBAAA;;IAAA,0DAAA;GAAA;IAAA;MAAA,aAAA;KAAA,CAAA;;ADmDE;IACE,oDAAoD;EACtD;;AAGF,qECxDA,wGAAA;IAAA,yBAAA;GAAA,CAAA;AD4DA;;AAEA;EACE,wCAAwC;AAC1C;;AChEA,wGAAA;EAAA,eAAA;CAAA,CAAA;;ADsEA;EACE,SAAS;EACT,UAAU;;EAEV,gBAAgB;;EAEhB,SAAS;;EAET,uBAAuB;;EAEvB,aAAa;AAOf;;AALE;IACE,UAAU;;IAEV,SAAS;EACX\",sourcesContent:['@import \"../global/variables.css\";\\n\\n.link {\\n cursor: pointer;\\n transition: color var(--ring-fast-ease);\\n\\n color: var(--ring-link-color);\\n\\n &,\\n &:hover {\\n text-decoration: none;\\n }\\n\\n &:hover,\\n &.hover {\\n transition: none;\\n\\n color: var(--ring-link-hover-color);\\n }\\n\\n &:hover .inner {\\n border-width: 0;\\n border-bottom: 2px solid;\\n border-image-source: linear-gradient(currentcolor 50%, transparent 50%);\\n border-image-slice: 0 0 100% 0;\\n }\\n\\n &.active {\\n color: inherit;\\n }\\n\\n &.compatibilityUnderlineMode:hover {\\n text-decoration: underline;\\n\\n /* stylelint-disable-next-line selector-max-specificity */\\n & .inner {\\n border: none;\\n }\\n }\\n\\n &.pseudo:hover {\\n text-decoration: none;\\n\\n /* stylelint-disable-next-line selector-max-specificity */\\n & .inner {\\n border: none;\\n }\\n }\\n\\n outline: none;\\n\\n &:focus-visible {\\n box-shadow: 0 0 0 2px var(--ring-border-hover-color);\\n }\\n}\\n\\n@media (min-resolution: 2dppx) {\\n .link:hover .inner {\\n border-bottom-width: 1px;\\n }\\n}\\n\\n.text {\\n border-radius: var(--ring-border-radius);\\n}\\n\\n.inherit:not(:hover) {\\n color: inherit;\\n}\\n\\n.pseudo {\\n margin: 0;\\n padding: 0;\\n\\n text-align: left;\\n\\n border: 0;\\n\\n background: transparent;\\n\\n font: inherit;\\n\\n &::-moz-focus-inner {\\n padding: 0;\\n\\n border: 0;\\n }\\n}\\n',null],sourceRoot:\"\"}]),c.locals={link:\"link_e6e5\",hover:\"hover_bed7\",inner:\"inner_e3ba\",active:\"active_f804\",compatibilityUnderlineMode:\"compatibilityUnderlineMode_e7a0\",pseudo:\"pseudo_d9ae\",text:\"text_e98a\",inherit:\"inherit_d267\"};const u=c},480:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>s});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(9106),c=t(5280),u=a()(o());u.i(c.A),u.i(l.default,\"\",!0),u.push([e.id,'.list_a01c {\\n position: relative;\\n\\n z-index: 1;\\n\\n border-radius: var(--ring-border-radius);\\n\\n line-height: normal;\\n}\\n\\n.simpleInner_a4f8 {\\n overflow: auto;\\n}\\n\\n.scrolling_a910 {\\n pointer-events: none;\\n}\\n\\n.separator_c26e {\\n display: block;\\n\\n min-height: 8px;\\n\\n margin-top: 8px;\\n padding: 0 16px 1px;\\n\\n text-align: right;\\n white-space: nowrap;\\n\\n color: var(--ring-secondary-color);\\n border-top: 1px solid var(--ring-line-color);\\n\\n font-size: var(--ring-font-size-smaller);\\n line-height: var(--ring-line-height-lower);\\n}\\n\\n.separator_first_ec9e {\\n margin-top: 0;\\n padding-top: 0;\\n\\n border: none;\\n}\\n\\n.item_eadd {\\n display: block;\\n\\n box-sizing: border-box;\\n\\n width: 100%;\\n\\n text-align: left;\\n vertical-align: bottom;\\n white-space: nowrap;\\n text-decoration: none;\\n\\n outline: none;\\n\\n font-size: var(--ring-font-size);\\n}\\n\\n.item_eadd.item_eadd {\\n padding: 3px 16px 5px;\\n\\n line-height: 24px;\\n}\\n\\n.itemContainer_f365 {\\n position: relative;\\n}\\n\\n.compact_efa8 {\\n line-height: 16px;\\n}\\n\\n.error_aa15 {\\n cursor: default;\\n}\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.error_aa15:hover {\\n color: var(--ring-error-color);\\n }}\\n\\n/* Override ring-link */\\n\\n.error_aa15,\\n .error_aa15:focus,\\n .error_aa15:visited {\\n color: var(--ring-error-color);\\n }\\n\\n.add_a8da {\\n padding: 8px 16px;\\n\\n line-height: 32px;\\n}\\n\\n.top_c4d5 {\\n display: flex;\\n align-items: baseline;\\n flex-direction: row;\\n}\\n\\n.left_ea6b {\\n align-self: center;\\n flex-shrink: 0;\\n}\\n\\n.label_dac9 {\\n overflow: hidden;\\n flex-grow: 1;\\n flex-shrink: 1;\\n\\n text-align: left;\\n white-space: nowrap;\\n text-overflow: ellipsis;\\n}\\n\\n[dir=\"rtl\"] .label_dac9 {\\n text-align: right;\\n direction: ltr;\\n }\\n\\n.description_efcc {\\n overflow: hidden;\\n flex-shrink: 100;\\n\\n padding-left: 8px;\\n\\n text-align: right;\\n white-space: nowrap;\\n text-overflow: ellipsis;\\n\\n color: var(--ring-secondary-color);\\n\\n font-size: var(--ring-font-size-smaller);\\n font-weight: 400;\\n line-height: var(--ring-line-height-lowest);\\n}\\n\\n.right_df77 {\\n display: flex;\\n align-items: center;\\n align-self: center;\\n flex-direction: row;\\n flex-shrink: 0;\\n}\\n\\n.details_a2b7 {\\n margin-bottom: 6px;\\n\\n white-space: normal;\\n\\n color: var(--ring-secondary-color);\\n\\n font-size: var(--ring-font-size-smaller);\\n line-height: var(--ring-line-height-lowest);\\n}\\n\\n.padded_a74d {\\n margin-left: 20px;\\n}\\n\\n/* Override :last-child */\\n.hint_d29d.hint_d29d {\\n margin-bottom: 0;\\n\\n border-top: 1px solid var(--ring-line-color);\\n background-color: var(--ring-sidebar-background-color);\\n\\n font-size: var(--ring-font-size-smaller);\\n}\\n\\n.action_d10e {\\n cursor: pointer;\\n\\n color: var(--ring-text-color);\\n}\\n\\n/* override link */\\n.actionLink_a4c7.actionLink_a4c7 {\\n transition: none;\\n}\\n\\n.hover_a4cd:not(.error_aa15) {\\n background-color: var(--ring-selected-background-color);\\n}\\n\\n.icon_f1f3 {\\n display: inline-block;\\n\\n width: 20px;\\n height: 20px;\\n margin-left: 16px;\\n\\n background-repeat: no-repeat;\\n background-position: center;\\n\\n background-size: contain;\\n}\\n\\n.highlight_e4dd {\\n color: var(--ring-link-hover-color);\\n}\\n\\n.service_a4fc {\\n color: var(--ring-secondary-color);\\n}\\n\\n.glyph_dfd5 {\\n float: left;\\n\\n width: 20px;\\n\\n margin-right: 8px;\\n\\n color: var(--ring-icon-secondary-color);\\n}\\n\\n.avatar_f258 {\\n\\n top: 0;\\n\\n height: 20px;\\n\\n -o-object-fit: cover;\\n\\n object-fit: cover;\\n -o-object-position: center;\\n object-position: center;\\n}\\n\\n.rightGlyph_fb77 {\\n\\n float: right;\\n\\n margin-right: 0;\\n margin-left: 16px;\\n}\\n\\n.checkboxContainer_c949 {\\n position: absolute;\\n top: 7px;\\n left: 19px;\\n\\n width: 20px;\\n height: 20px;\\n margin-right: 8px;\\n}\\n\\n.compact_efa8 .checkboxContainer_c949 {\\n top: 0;\\n\\n width: 16px;\\n height: 16px;\\n}\\n\\n.title_e1bf {\\n display: block;\\n\\n margin-top: 10px;\\n margin-bottom: 6px;\\n padding: 8px 16px 0;\\n\\n text-align: left;\\n}\\n\\n[dir=\"rtl\"] .title_e1bf {\\n text-align: right;\\n direction: ltr;\\n }\\n\\n.title_first_ac55 {\\n margin-top: 0;\\n}\\n\\n.text_fe0e {\\n letter-spacing: 1.5px;\\n text-transform: uppercase;\\n\\n color: var(--ring-secondary-color);\\n\\n font-size: var(--ring-font-size-smaller);\\n}\\n\\n.fade_d35c {\\n position: absolute;\\n bottom: 0;\\n\\n width: 100%;\\n height: 24px;\\n\\n pointer-events: none;\\n\\n background: linear-gradient(to bottom, rgba(255, 255, 255, 0), var(--ring-content-background-color));\\n}\\n\\n.disabled_c3d8 {\\n pointer-events: none;\\n\\n color: var(--ring-disabled-color);\\n}\\n',\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/list/list.css\",\"\"],names:[],mappings:\"AAKA;EACE,kBAAkB;;EAElB,UAAU;;EAEV,wCAAwC;;EAExC,mBAAmB;AACrB;;AAEA;EACE,cAAc;AAChB;;AAEA;EACE,oBAAoB;AACtB;;AAEA;EACE,cAAc;;EAEd,eAAuB;;EAEvB,eAAuB;EACvB,mBAA6B;;EAE7B,iBAAiB;EACjB,mBAAmB;;EAEnB,kCAAkC;EAClC,4CAA4C;;EAE5C,wCAAwC;EACxC,0CAA0C;AAC5C;;AAEA;EACE,aAAa;EACb,cAAc;;EAEd,YAAY;AACd;;AAEA;EACE,cAAc;;EAEd,sBAAsB;;EAEtB,WAAW;;EAEX,gBAAgB;EAChB,sBAAsB;EACtB,mBAAmB;EACnB,qBAAqB;;EAErB,aAAa;;EAEb,gCAAgC;AAClC;;AAEA;EACE,qBAA+B;;EAE/B,iBAA2B;AAC7B;;AAEA;EACE,kBAAkB;AACpB;;AAEA;EACE,iBAA2B;AAC7B;;AAEA;EACE,eAAe;AASjB;;ACzFA,wGAAA;IAAA,+BAAA;GAAA,CAAA;;ADkFE,uBAAuB;;AACvB;;;IAIE,8BAA8B;EAChC;;AAGF;EACE,iBAA4B;;EAE5B,iBAA2B;AAC7B;;AAEA;EACE,aAAa;EACb,qBAAqB;EACrB,mBAAmB;AACrB;;AAEA;EACE,kBAAkB;EAClB,cAAc;AAChB;;AAEA;EACE,gBAAgB;EAChB,YAAY;EACZ,cAAc;;EAEd,gBAAgB;EAChB,mBAAmB;EACnB,uBAAuB;AAMzB;;AAJE;IACE,iBAAiB;IACjB,cAAc;EAChB;;AAGF;EACE,gBAAgB;EAChB,gBAAgB;;EAEhB,iBAAkB;;EAElB,iBAAiB;EACjB,mBAAmB;EACnB,uBAAuB;;EAEvB,kCAAkC;;EAElC,wCAAwC;EACxC,gBAAgB;EAChB,2CAA2C;AAC7C;;AAEA;EACE,aAAa;EACb,mBAAmB;EACnB,kBAAkB;EAClB,mBAAmB;EACnB,cAAc;AAChB;;AAEA;EACE,kBAAkB;;EAElB,mBAAmB;;EAEnB,kCAAkC;;EAElC,wCAAwC;EACxC,2CAA2C;AAC7C;;AAEA;EACE,iBAAiB;AACnB;;AAEA,yBAAyB;AACzB;EACE,gBAAgB;;EAEhB,4CAA4C;EAC5C,sDAAsD;;EAEtD,wCAAwC;AAC1C;;AAEA;EACE,eAAe;;EAEf,6BAA6B;AAC/B;;AAEA,kBAAkB;AAClB;EACE,gBAAgB;AAClB;;AAEA;EACE,uDAAuD;AACzD;;AAEA;EACE,qBAAqB;;EAErB,WAAW;EACX,YAAY;EACZ,iBAA2B;;EAE3B,4BAA4B;EAC5B,2BAA2B;;EAE3B,wBAAwB;AAC1B;;AAEA;EACE,mCAAmC;AACrC;;AAEA;EACE,kCAAkC;AACpC;;AAEA;EACE,WAAW;;EAEX,WAAW;;EAEX,iBAAkB;;EAElB,uCAAuC;AACzC;;AAEA;;EAGE,MAAM;;EAEN,YAAY;;EAEZ,oBAAiB;;KAAjB,iBAAiB;EACjB,0BAAuB;KAAvB,uBAAuB;AACzB;;AAEA;;EAGE,YAAY;;EAEZ,eAAe;EACf,iBAA2B;AAC7B;;AAEA;EACE,kBAAkB;EAClB,QAAQ;EACR,UAAU;;EAEV,WAAW;EACX,YAAY;EACZ,iBAAkB;AACpB;;AAEA;EACE,MAAM;;EAEN,WAAqB;EACrB,YAAsB;AACxB;;AAEA;EACE,cAAc;;EAEd,gBAAgB;EAChB,kBAAkB;EAClB,mBAAqC;;EAErC,gBAAgB;AAMlB;;AAJE;IACE,iBAAiB;IACjB,cAAc;EAChB;;AAGF;EACE,aAAa;AACf;;AAEA;EACE,qBAAqB;EACrB,yBAAyB;;EAEzB,kCAAkC;;EAElC,wCAAwC;AAC1C;;AAEA;EACE,kBAAkB;EAClB,SAAS;;EAET,WAAW;EACX,YAAsB;;EAEtB,oBAAoB;;EAEpB,oGAAoG;AACtG;;AAEA;EACE,oBAAoB;;EAEpB,iCAAiC;AACnC\",sourcesContent:['@import \"../global/variables.css\";\\n\\n@value unit from \"../global/global.css\";\\n@value listSpacing: unit;\\n\\n.list {\\n position: relative;\\n\\n z-index: 1;\\n\\n border-radius: var(--ring-border-radius);\\n\\n line-height: normal;\\n}\\n\\n.simpleInner {\\n overflow: auto;\\n}\\n\\n.scrolling {\\n pointer-events: none;\\n}\\n\\n.separator {\\n display: block;\\n\\n min-height: listSpacing;\\n\\n margin-top: listSpacing;\\n padding: 0 calc(unit * 2) 1px;\\n\\n text-align: right;\\n white-space: nowrap;\\n\\n color: var(--ring-secondary-color);\\n border-top: 1px solid var(--ring-line-color);\\n\\n font-size: var(--ring-font-size-smaller);\\n line-height: var(--ring-line-height-lower);\\n}\\n\\n.separator_first {\\n margin-top: 0;\\n padding-top: 0;\\n\\n border: none;\\n}\\n\\n.item {\\n display: block;\\n\\n box-sizing: border-box;\\n\\n width: 100%;\\n\\n text-align: left;\\n vertical-align: bottom;\\n white-space: nowrap;\\n text-decoration: none;\\n\\n outline: none;\\n\\n font-size: var(--ring-font-size);\\n}\\n\\n.item.item {\\n padding: 3px calc(unit * 2) 5px;\\n\\n line-height: calc(unit * 3);\\n}\\n\\n.itemContainer {\\n position: relative;\\n}\\n\\n.compact {\\n line-height: calc(unit * 2);\\n}\\n\\n.error {\\n cursor: default;\\n\\n /* Override ring-link */\\n &,\\n &:hover,\\n &:focus,\\n &:visited {\\n color: var(--ring-error-color);\\n }\\n}\\n\\n.add {\\n padding: unit calc(2 * unit);\\n\\n line-height: calc(4 * unit);\\n}\\n\\n.top {\\n display: flex;\\n align-items: baseline;\\n flex-direction: row;\\n}\\n\\n.left {\\n align-self: center;\\n flex-shrink: 0;\\n}\\n\\n.label {\\n overflow: hidden;\\n flex-grow: 1;\\n flex-shrink: 1;\\n\\n text-align: left;\\n white-space: nowrap;\\n text-overflow: ellipsis;\\n\\n [dir=\"rtl\"] & {\\n text-align: right;\\n direction: ltr;\\n }\\n}\\n\\n.description {\\n overflow: hidden;\\n flex-shrink: 100;\\n\\n padding-left: unit;\\n\\n text-align: right;\\n white-space: nowrap;\\n text-overflow: ellipsis;\\n\\n color: var(--ring-secondary-color);\\n\\n font-size: var(--ring-font-size-smaller);\\n font-weight: 400;\\n line-height: var(--ring-line-height-lowest);\\n}\\n\\n.right {\\n display: flex;\\n align-items: center;\\n align-self: center;\\n flex-direction: row;\\n flex-shrink: 0;\\n}\\n\\n.details {\\n margin-bottom: 6px;\\n\\n white-space: normal;\\n\\n color: var(--ring-secondary-color);\\n\\n font-size: var(--ring-font-size-smaller);\\n line-height: var(--ring-line-height-lowest);\\n}\\n\\n.padded {\\n margin-left: 20px;\\n}\\n\\n/* Override :last-child */\\n.hint.hint {\\n margin-bottom: 0;\\n\\n border-top: 1px solid var(--ring-line-color);\\n background-color: var(--ring-sidebar-background-color);\\n\\n font-size: var(--ring-font-size-smaller);\\n}\\n\\n.action {\\n cursor: pointer;\\n\\n color: var(--ring-text-color);\\n}\\n\\n/* override link */\\n.actionLink.actionLink {\\n transition: none;\\n}\\n\\n.hover:not(.error) {\\n background-color: var(--ring-selected-background-color);\\n}\\n\\n.icon {\\n display: inline-block;\\n\\n width: 20px;\\n height: 20px;\\n margin-left: calc(unit * 2);\\n\\n background-repeat: no-repeat;\\n background-position: center;\\n\\n background-size: contain;\\n}\\n\\n.highlight {\\n color: var(--ring-link-hover-color);\\n}\\n\\n.service {\\n color: var(--ring-secondary-color);\\n}\\n\\n.glyph {\\n float: left;\\n\\n width: 20px;\\n\\n margin-right: unit;\\n\\n color: var(--ring-icon-secondary-color);\\n}\\n\\n.avatar {\\n composes: glyph;\\n\\n top: 0;\\n\\n height: 20px;\\n\\n object-fit: cover;\\n object-position: center;\\n}\\n\\n.rightGlyph {\\n composes: glyph;\\n\\n float: right;\\n\\n margin-right: 0;\\n margin-left: calc(unit * 2);\\n}\\n\\n.checkboxContainer {\\n position: absolute;\\n top: 7px;\\n left: 19px;\\n\\n width: 20px;\\n height: 20px;\\n margin-right: unit;\\n}\\n\\n.compact .checkboxContainer {\\n top: 0;\\n\\n width: calc(unit * 2);\\n height: calc(unit * 2);\\n}\\n\\n.title {\\n display: block;\\n\\n margin-top: 10px;\\n margin-bottom: 6px;\\n padding: listSpacing calc(unit * 2) 0;\\n\\n text-align: left;\\n\\n [dir=\"rtl\"] & {\\n text-align: right;\\n direction: ltr;\\n }\\n}\\n\\n.title_first {\\n margin-top: 0;\\n}\\n\\n.text {\\n letter-spacing: 1.5px;\\n text-transform: uppercase;\\n\\n color: var(--ring-secondary-color);\\n\\n font-size: var(--ring-font-size-smaller);\\n}\\n\\n.fade {\\n position: absolute;\\n bottom: 0;\\n\\n width: 100%;\\n height: calc(unit * 3);\\n\\n pointer-events: none;\\n\\n background: linear-gradient(to bottom, rgba(255, 255, 255, 0), var(--ring-content-background-color));\\n}\\n\\n.disabled {\\n pointer-events: none;\\n\\n color: var(--ring-disabled-color);\\n}\\n',null],sourceRoot:\"\"}]),u.locals={unit:`${l.default.locals.unit}`,listSpacing:\"8px\",list:\"list_a01c\",simpleInner:\"simpleInner_a4f8\",scrolling:\"scrolling_a910\",separator:\"separator_c26e\",separator_first:\"separator_first_ec9e\",item:\"item_eadd\",itemContainer:\"itemContainer_f365\",compact:\"compact_efa8\",error:\"error_aa15\",add:\"add_a8da\",top:\"top_c4d5\",left:\"left_ea6b\",label:\"label_dac9\",description:\"description_efcc\",right:\"right_df77\",details:\"details_a2b7\",padded:\"padded_a74d\",hint:\"hint_d29d\",action:\"action_d10e\",actionLink:\"actionLink_a4c7\",hover:\"hover_a4cd\",icon:\"icon_f1f3\",highlight:\"highlight_e4dd\",service:\"service_a4fc\",glyph:\"glyph_dfd5\",avatar:\"avatar_f258 glyph_dfd5\",rightGlyph:\"rightGlyph_fb77 glyph_dfd5\",checkboxContainer:\"checkboxContainer_c949\",title:\"title_e1bf\",title_first:\"title_first_ac55\",text:\"text_fe0e\",fade:\"fade_d35c\",disabled:\"disabled_c3d8\"};const s=u},1586:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>f});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(9173),c=t(9106),u=t(5280),s=a()(o());s.i(u.A),s.i(l.A,\"\",!0),s.i(c.default,\"\",!0),s.push([e.id,`:root {\\n /* stylelint-disable-next-line color-no-hex */\\n --ring-loader-inline-stops: #ff00eb, #bd3bff, #008eff, #58ba00, #f48700, #ff00eb;\\n}\\n\\n.${l.A.locals.dark},\\n.ring-ui-theme-dark {\\n /* stylelint-disable-next-line color-no-hex */\\n --ring-loader-inline-stops: #ff2eef, #d178ff, #289fff, #88d444, #ffe000, #ff2eef;\\n}\\n\\n@keyframes spin_ad60 {\\n 0% {\\n transform: rotate(0);\\n }\\n\\n 100% {\\n transform: rotate(360deg);\\n }\\n}\\n\\n@keyframes pulse_c906 {\\n 0% {\\n transform: scale(1);\\n }\\n\\n 100% {\\n transform: scale(1.41667);\\n }\\n}\\n\\n.loader_d294,\\n.ring-loader-inline {\\n /* needed for better backward-compatibility */\\n\\n position: relative;\\n\\n display: inline-block;\\n\\n overflow: hidden;\\n\\n transform: rotate(0);\\n animation: spin_ad60 1s linear infinite;\\n vertical-align: -3px;\\n\\n border-radius: 8px;\\n}\\n\\n.loader_d294,\\n .ring-loader-inline,\\n .loader_d294::after,\\n .ring-loader-inline::after {\\n transform-origin: 50% 50%;\\n }\\n\\n.loader_d294::after, .ring-loader-inline::after {\\n display: block;\\n\\n width: 16px;\\n height: 16px;\\n\\n content: \"\";\\n animation: pulse_c906 0.85s cubic-bezier(0.68, 0, 0.74, 0.74) infinite alternate;\\n\\n background-image: conic-gradient(#ff00eb, #bd3bff, #008eff, #58ba00, #f48700, #ff00eb);\\n\\n background-image: conic-gradient(var(--ring-loader-inline-stops));\\n -webkit-mask-image: radial-gradient(8px, transparent 71.875%, var(--ring-content-background-color) 71.875%);\\n mask-image: radial-gradient(8px, transparent 71.875%, var(--ring-content-background-color) 71.875%);\\n }\\n\\n.children_ece6 {\\n margin-left: 4px;\\n}\\n`,\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/loader-inline/loader-inline.css\"],names:[],mappings:\"AAKA;EACE,6CAA6C;EAC7C,gFAAgF;AAClF;;AAEA;;EAEE,6CAA6C;EAC7C,gFAAgF;AAClF;;AAEA;EACE;IACE,oBAAoB;EACtB;;EAEA;IACE,yBAAyB;EAC3B;AACF;;AAEA;EACE;IACE,mBAAmB;EACrB;;EAEA;IACE,yBAA+B;EACjC;AACF;;AAEA;;EAEE,6CAA6C;;EAE7C,kBAAkB;;EAElB,qBAAqB;;EAErB,gBAAgB;;EAEhB,oBAAoB;EACpB,uCAAkC;EAClC,oBAAoB;;EAEpB,kBAAmB;AAmBrB;;AAjBE;;;;IAEE,yBAAyB;EAC3B;;AAEA;IACE,cAAc;;IAEd,WAAqB;IACrB,YAAsB;;IAEtB,WAAW;IACX,gFAA2E;;IAE3E,sFAAiE;;IAAjE,iEAAiE;IACjE,2GAAoG;YAApG,mGAAoG;EACtG;;AAGF;EACE,gBAA2B;AAC7B\",sourcesContent:['@import \"../global/variables.css\";\\n\\n@value dark from \"../global/variables_dark.css\";\\n@value unit from \"../global/global.css\";\\n\\n:root {\\n /* stylelint-disable-next-line color-no-hex */\\n --ring-loader-inline-stops: #ff00eb, #bd3bff, #008eff, #58ba00, #f48700, #ff00eb;\\n}\\n\\n.dark,\\n:global(.ring-ui-theme-dark) {\\n /* stylelint-disable-next-line color-no-hex */\\n --ring-loader-inline-stops: #ff2eef, #d178ff, #289fff, #88d444, #ffe000, #ff2eef;\\n}\\n\\n@keyframes spin {\\n 0% {\\n transform: rotate(0);\\n }\\n\\n 100% {\\n transform: rotate(360deg);\\n }\\n}\\n\\n@keyframes pulse {\\n 0% {\\n transform: scale(1);\\n }\\n\\n 100% {\\n transform: scale(calc(17 / 12));\\n }\\n}\\n\\n.loader,\\n:global(.ring-loader-inline) {\\n /* needed for better backward-compatibility */\\n\\n position: relative;\\n\\n display: inline-block;\\n\\n overflow: hidden;\\n\\n transform: rotate(0);\\n animation: spin 1s linear infinite;\\n vertical-align: -3px;\\n\\n border-radius: unit;\\n\\n &,\\n &::after {\\n transform-origin: 50% 50%;\\n }\\n\\n &::after {\\n display: block;\\n\\n width: calc(unit * 2);\\n height: calc(unit * 2);\\n\\n content: \"\";\\n animation: pulse 0.85s cubic-bezier(0.68, 0, 0.74, 0.74) infinite alternate;\\n\\n background-image: conic-gradient(var(--ring-loader-inline-stops));\\n mask-image: radial-gradient(unit, transparent 71.875%, var(--ring-content-background-color) 71.875%);\\n }\\n}\\n\\n.children {\\n margin-left: calc(unit / 2);\\n}\\n'],sourceRoot:\"\"}]),s.locals={dark:`${l.A.locals.dark}`,unit:`${c.default.locals.unit}`,loader:\"loader_d294\",spin:\"spin_ad60\",pulse:\"pulse_c906\",children:\"children_ece6\"};const f=s},8890:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>s});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(9106),c=t(5280),u=a()(o());u.i(c.A),u.i(l.default,\"\",!0),u.push([e.id,\".popup_f35e {\\n\\n position: fixed;\\n z-index: var(--ring-overlay-z-index);\\n top: -100vh;\\n left: -100vw;\\n\\n overflow-y: auto;\\n\\n box-sizing: border-box;\\n\\n border: 1px solid var(--ring-popup-border-color);\\n border-radius: var(--ring-border-radius);\\n\\n background-color: var(--ring-popup-background-color);\\n box-shadow: var(--ring-popup-shadow);\\n}\\n\\n.hidden_c587 {\\n display: none;\\n}\\n\\n.showing_b07a {\\n opacity: 0;\\n}\\n\\n.attached_ea95 {\\n border-top: 0;\\n border-top-left-radius: 0;\\n border-top-right-radius: 0;\\n}\\n\",\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/popup/popup.css\"],names:[],mappings:\"AAEA;;EAGE,eAAe;EACf,oCAAoC;EACpC,WAAW;EACX,YAAY;;EAEZ,gBAAgB;;EAEhB,sBAAsB;;EAEtB,gDAAgD;EAChD,wCAAwC;;EAExC,oDAAoD;EACpD,oCAAoC;AACtC;;AAEA;EACE,aAAa;AACf;;AAEA;EACE,UAAU;AACZ;;AAEA;EACE,aAAa;EACb,yBAAyB;EACzB,0BAA0B;AAC5B\",sourcesContent:['@import \"../global/variables.css\";\\n\\n.popup {\\n composes: font from \"../global/global.css\";\\n\\n position: fixed;\\n z-index: var(--ring-overlay-z-index);\\n top: -100vh;\\n left: -100vw;\\n\\n overflow-y: auto;\\n\\n box-sizing: border-box;\\n\\n border: 1px solid var(--ring-popup-border-color);\\n border-radius: var(--ring-border-radius);\\n\\n background-color: var(--ring-popup-background-color);\\n box-shadow: var(--ring-popup-shadow);\\n}\\n\\n.hidden {\\n display: none;\\n}\\n\\n.showing {\\n opacity: 0;\\n}\\n\\n.attached {\\n border-top: 0;\\n border-top-left-radius: 0;\\n border-top-right-radius: 0;\\n}\\n'],sourceRoot:\"\"}]),u.locals={popup:`popup_f35e ${l.default.locals.font}`,hidden:\"hidden_c587\",showing:\"showing_b07a\",attached:\"attached_ea95\"};const s=u},4481:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>s});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(9106),c=t(5280),u=a()(o());u.i(c.A),u.i(l.default,\"\",!0),u.push([e.id,'@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.filterWithTagsFocused_ffbf.filterWithTagsFocused_ffbf:hover {\\n border-color: var(--ring-main-color);\\n}}\\n\\n.filterWithTags_ff56 {\\n overflow: hidden;\\n\\n margin: 16px 8px 0;\\n padding: 3px;\\n\\n text-align: left;\\n\\n border: 1px solid var(--ring-borders-color);\\n border-radius: var(--ring-border-radius);\\n}\\n\\n.filterWithTags_ff56 .filterWrapper_dd63 {\\n padding-right: 0;\\n padding-left: 0;\\n\\n border-bottom: none;\\n }\\n\\n@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.filterWithTags_ff56:hover {\\n border-color: var(--ring-border-hover-color);\\n }}\\n\\n.filterWithTagsFocused_ffbf {\\n border-color: var(--ring-main-color);\\n}\\n\\n.filterWithTagsInput_ab94 {\\n padding: 0;\\n\\n border: none;\\n}\\n\\n.filter_deda {\\n flex-grow: 1;\\n\\n width: 0;\\n}\\n\\n.popup_f21d {\\n overscroll-behavior: contain;\\n}\\n\\n.filterWrapper_dd63 {\\n position: relative;\\n\\n display: flex;\\n\\n margin: 0;\\n padding-right: 8px;\\n padding-left: 44px;\\n\\n border-bottom: 1px solid var(--ring-borders-color);\\n}\\n\\n[dir=\"rtl\"] .filterWrapper_dd63 {\\n padding-right: 44px;\\n padding-left: 8px;\\n }\\n\\n.filterIcon_b648 {\\n position: absolute;\\n top: 7px;\\n left: 16px;\\n\\n color: var(--ring-icon-color);\\n}\\n\\n[dir=\"rtl\"] .filterIcon_b648 {\\n right: 16px;\\n left: auto;\\n }\\n\\n.bottomLine_c880 {\\n text-align: center;\\n}\\n\\n.bottomLine_c880.bottomLineOverItem_dfb4 {\\n position: relative;\\n\\n z-index: var(--ring-fixed-z-index);\\n\\n margin-top: -36px;\\n\\n background-color: var(--ring-content-background-color);\\n }\\n\\n.message_ccdf {\\n display: inline-block;\\n\\n margin: 8px 0;\\n padding: 0 16px;\\n}\\n\\n.selectAll_ff5e {\\n display: flex;\\n justify-content: space-between;\\n\\n padding: 8px 16px 0;\\n}\\n',\"\",{version:3,sources:[\"\",\"webpack://./node_modules/@jetbrains/ring-ui/components/select/select-popup.css\"],names:[],mappings:\"AAAA,wGAAA;EAAA,qCAAA;CAAA,CAAA;;ACIA;EACE,gBAAgB;;EAEhB,kBAA6B;EAC7B,YAAY;;EAEZ,gBAAgB;;EAEhB,2CAA2C;EAC3C,wCAAwC;AAY1C;;AAVE;IACE,gBAAgB;IAChB,eAAe;;IAEf,mBAAmB;EACrB;;ADpBF,wGAAA;IAAA,6CAAA;GAAA,CAAA;;AC2BA;EAEE,oCAAoC;AACtC;;AAEA;EACE,UAAU;;EAEV,YAAY;AACd;;AAEA;EACE,YAAY;;EAEZ,QAAQ;AACV;;AAEA;EACE,4BAA4B;AAC9B;;AAEA;EACE,kBAAkB;;EAElB,aAAa;;EAEb,SAAS;EACT,kBAAmB;EACnB,kBAA8B;;EAE9B,kDAAkD;AAMpD;;AAJE;IACE,mBAA+B;IAC/B,iBAAkB;EACpB;;AAGF;EACE,kBAAkB;EAClB,QAAQ;EACR,UAAoB;;EAEpB,6BAA6B;AAM/B;;AAJE;IACE,WAAqB;IACrB,UAAU;EACZ;;AAGF;EACE,kBAAkB;AAWpB;;AATE;IACE,kBAAkB;;IAElB,kCAAkC;;IAElC,iBAAiB;;IAEjB,sDAAsD;EACxD;;AAGF;EACE,qBAAqB;;EAErB,aAAc;EACd,eAAyB;AAC3B;;AAEA;EACE,aAAa;EACb,8BAA8B;;EAE9B,mBAAmB;AACrB\",sourcesContent:[null,'@import \"../global/variables.css\";\\n\\n@value unit from \"../global/global.css\";\\n\\n.filterWithTags {\\n overflow: hidden;\\n\\n margin: calc(unit * 2) unit 0;\\n padding: 3px;\\n\\n text-align: left;\\n\\n border: 1px solid var(--ring-borders-color);\\n border-radius: var(--ring-border-radius);\\n\\n & .filterWrapper {\\n padding-right: 0;\\n padding-left: 0;\\n\\n border-bottom: none;\\n }\\n\\n &:hover {\\n border-color: var(--ring-border-hover-color);\\n }\\n}\\n\\n.filterWithTagsFocused,\\n.filterWithTagsFocused.filterWithTagsFocused:hover {\\n border-color: var(--ring-main-color);\\n}\\n\\n.filterWithTagsInput {\\n padding: 0;\\n\\n border: none;\\n}\\n\\n.filter {\\n flex-grow: 1;\\n\\n width: 0;\\n}\\n\\n.popup {\\n overscroll-behavior: contain;\\n}\\n\\n.filterWrapper {\\n position: relative;\\n\\n display: flex;\\n\\n margin: 0;\\n padding-right: unit;\\n padding-left: calc(unit * 5.5);\\n\\n border-bottom: 1px solid var(--ring-borders-color);\\n\\n [dir=\"rtl\"] & {\\n padding-right: calc(unit * 5.5);\\n padding-left: unit;\\n }\\n}\\n\\n.filterIcon {\\n position: absolute;\\n top: 7px;\\n left: calc(unit * 2);\\n\\n color: var(--ring-icon-color);\\n\\n [dir=\"rtl\"] & {\\n right: calc(unit * 2);\\n left: auto;\\n }\\n}\\n\\n.bottomLine {\\n text-align: center;\\n\\n &.bottomLineOverItem {\\n position: relative;\\n\\n z-index: var(--ring-fixed-z-index);\\n\\n margin-top: -36px;\\n\\n background-color: var(--ring-content-background-color);\\n }\\n}\\n\\n.message {\\n display: inline-block;\\n\\n margin: unit 0;\\n padding: 0 calc(2 * unit);\\n}\\n\\n.selectAll {\\n display: flex;\\n justify-content: space-between;\\n\\n padding: 8px 16px 0;\\n}\\n'],sourceRoot:\"\"}]),u.locals={unit:`${l.default.locals.unit}`,filterWithTagsFocused:\"filterWithTagsFocused_ffbf\",filterWithTags:\"filterWithTags_ff56\",filterWrapper:\"filterWrapper_dd63\",filterWithTagsInput:\"filterWithTagsInput_ab94\",filter:\"filter_deda\",popup:\"popup_f21d\",filterIcon:\"filterIcon_b648\",bottomLine:\"bottomLine_c880\",bottomLineOverItem:\"bottomLineOverItem_dfb4\",message:\"message_ccdf\",selectAll:\"selectAll_ff5e\"};const s=u},2636:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>f});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(9106),c=t(9892),u=t(5280),s=a()(o());s.i(u.A),s.i(l.default,\"\",!0),s.i(c.default,\"\",!0),s.push([e.id,'@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.select_e2a5:hover .value_b3a3,\\n.select_e2a5:hover .icons_c4a9 {\\n transition: none;\\n\\n color: var(--ring-main-color);\\n}}\\n\\n.select_e2a5 {\\n position: relative;\\n\\n display: inline-block;\\n\\n white-space: nowrap;\\n\\n color: var(--ring-text-color);\\n}\\n\\n.toolbar_d3be {\\n border-top: 1px solid var(--ring-line-color);\\n}\\n\\n.button_ef00 {\\n width: 100%;\\n padding: 0;\\n\\n text-align: left;\\n}\\n\\n[dir=\"rtl\"] .button_ef00 {\\n text-align: right;\\n direction: ltr;\\n }\\n\\n.toolbar_d3be .button_ef00 {\\n height: 32px;\\n margin: 8px 0;\\n }\\n\\n.button_ef00.buttonSpaced_f316 {\\n padding: 0 16px;\\n }\\n\\n.icons_c4a9 {\\n position: absolute;\\n top: 0;\\n right: 5px;\\n bottom: 0;\\n\\n transition: color var(--ring-ease);\\n\\n color: var(--ring-icon-secondary-color);\\n\\n line-height: normal;\\n}\\n\\n.inputMode_a6f6 .icons_c4a9 {\\n font-size: var(--ring-font-size);\\n }\\n\\n.selectedIcon_a62c {\\n\\n position: relative;\\n top: 3px;\\n\\n display: inline-block;\\n\\n width: 16px;\\n height: 16px;\\n margin: 0 4px;\\n\\n background-repeat: no-repeat;\\n background-position: center;\\n\\n background-size: contain;\\n}\\n\\n.clearIcon_c750 {\\n padding: 0 3px;\\n\\n vertical-align: -2px;\\n}\\n\\n.sizeS_e8c3 {\\n width: 96px;\\n}\\n\\n.sizeM_ed34 {\\n width: 240px;\\n}\\n\\n.sizeL_c053 {\\n width: 400px;\\n}\\n\\n.sizeFULL_c585 {\\n width: 100%;\\n}\\n\\n.sizeAUTO_a07c {\\n max-width: 100%;\\n}\\n\\n.buttonMode_dd69 {\\n position: relative;\\n\\n cursor: pointer;\\n}\\n\\n.value_b3a3 {\\n\\n display: inline-block;\\n\\n box-sizing: border-box;\\n width: 100%;\\n height: 33px;\\n padding: 0 0 3px;\\n\\n cursor: pointer;\\n transition: color var(--ring-ease), border-color var(--ring-ease);\\n text-align: left;\\n vertical-align: top;\\n\\n color: var(--ring-text-color);\\n\\n border: none;\\n border-bottom: 1px solid var(--ring-borders-color);\\n outline: none;\\n background: transparent;\\n}\\n\\n.value_b3a3:focus {\\n border-color: var(--ring-main-color);\\n }\\n\\n.value_b3a3.open_f1b1,\\n .value_b3a3:active {\\n border-color: transparent;\\n }\\n\\n.value_b3a3::-moz-focus-inner {\\n padding: 0;\\n\\n border: 0;\\n outline: 0;\\n }\\n\\n.buttonContainer_b2b9 {\\n position: relative;\\n\\n font-size: var(--ring-font-size);\\n}\\n\\n.buttonValue_b4ad {\\n\\n display: block;\\n\\n width: 100%;\\n padding-left: 8px;\\n\\n text-align: left;\\n vertical-align: -8px;\\n}\\n\\n.buttonValue_b4ad:focus-visible {\\n box-shadow: inset 0 0 0 1px var(--ring-main-color);\\n}\\n\\n.buttonValueOpen_d9d3.buttonValueOpen_d9d3 {\\n box-shadow: inset 0 0 0 1px var(--ring-main-color);\\n}\\n\\n.buttonValueEmpty_e6b3.buttonValueEmpty_e6b3 {\\n color: var(--ring-disabled-color);\\n}\\n\\n.heightS_b721 .buttonValue_b4ad {\\n font-size: var(--ring-font-size);\\n}\\n\\n.label_e56f {\\n position: relative;\\n\\n color: var(--ring-secondary-color);\\n}\\n\\n:focus-visible + .icons_c4a9,\\n.value_b3a3:focus,\\n.value_b3a3:focus + .icons_c4a9,\\n.open_f1b1,\\n.open_f1b1 + .icons_c4a9,\\n.buttonValueOpen_d9d3 + .icons_c4a9 {\\n transition: none;\\n\\n color: var(--ring-main-color);\\n}\\n\\n.disabled_b89f {\\n pointer-events: none;\\n\\n color: var(--ring-disabled-color);\\n}\\n\\n.disabled_b89f .value_b3a3 {\\n color: var(--ring-disabled-color);\\n border-bottom-style: dashed;\\n }\\n\\n.avatar_f4dd {\\n margin-right: 4px;\\n\\n vertical-align: -5px;\\n}\\n\\n.popup_acec {\\n min-width: 240px;\\n max-width: 320px;\\n}\\n\\n.chevron_d51f.chevron_d51f {\\n padding: 0 3px;\\n\\n transition: none;\\n vertical-align: -1px;\\n\\n color: inherit;\\n}\\n\\n.chevronIcon_f6cf.chevronIcon_f6cf {\\n transition: none;\\n\\n color: inherit;\\n}\\n',\"\",{version:3,sources:[\"\",\"webpack://./node_modules/@jetbrains/ring-ui/components/select/select.css\"],names:[],mappings:\"AAAA,wGAAA;;EAAA,iBAAA;;EAAA,8BAAA;CAAA,CAAA;;ACKA;EACE,kBAAkB;;EAElB,qBAAqB;;EAErB,mBAAmB;;EAEnB,6BAA6B;AAC/B;;AAEA;EACE,4CAA4C;AAC9C;;AAEA;EACE,WAAW;EACX,UAAU;;EAEV,gBAAgB;AAelB;;AAbE;IACE,iBAAiB;IACjB,cAAc;EAChB;;AAEA;IACE,YAAsB;IACtB,aAAc;EAChB;;AAEA;IACE,eAAyB;EAC3B;;AAGF;EACE,kBAAkB;EAClB,MAAM;EACN,UAAU;EACV,SAAS;;EAET,kCAAkC;;EAElC,uCAAuC;;EAEvC,mBAAmB;AAKrB;;AAHE;IACE,gCAAgC;EAClC;;AAGF;;EAGE,kBAAkB;EAClB,QAAQ;;EAER,qBAAqB;;EAErB,WAAqB;EACrB,YAAsB;EACtB,aAAa;;EAEb,4BAA4B;EAC5B,2BAA2B;;EAE3B,wBAAwB;AAC1B;;AAEA;EACE,cAAc;;EAEd,oBAAoB;AACtB;;AAEA;EACE,WAAsB;AACxB;;AAEA;EACE,YAAsB;AACxB;;AAEA;EACE,YAAsB;AACxB;;AAEA;EACE,WAAW;AACb;;AAEA;EACE,eAAe;AACjB;;AAEA;EACE,kBAAkB;;EAElB,eAAe;AACjB;;AAEA;;EAIE,qBAAqB;;EAErB,sBAAsB;EACtB,WAAW;EACX,YAA4B;EAC5B,gBAAgB;;EAEhB,eAAe;EACf,iEAAiE;EACjE,gBAAgB;EAChB,mBAAmB;;EAEnB,6BAA6B;;EAE7B,YAAY;EACZ,kDAAkD;EAClD,aAAa;EACb,uBAAuB;AAiBzB;;AAfE;IACE,oCAAoC;EACtC;;AAEA;;IAEE,yBAAyB;EAC3B;;AAEA;IACE,UAAU;;IAEV,SAAS;IACT,UAAU;EACZ;;AAGF;EACE,kBAAkB;;EAElB,gCAAgC;AAClC;;AAEA;;EAGE,cAAc;;EAEd,WAAW;EACX,iBAAkB;;EAElB,gBAAgB;EAChB,oBAA8B;AAChC;;AAEA;EACE,kDAAgD;AAClD;;AAEA;EACE,kDAAgD;AAClD;;AAEA;EACE,iCAAiC;AACnC;;AAEA;EACE,gCAAgC;AAClC;;AAEA;EACE,kBAAkB;;EAElB,kCAAkC;AACpC;;AAEA;;;;;;EAQE,gBAAgB;;EAEhB,6BAA6B;AAC/B;;AAEA;EACE,oBAAoB;;EAEpB,iCAAiC;AAMnC;;AAJE;IACE,iCAAiC;IACjC,2BAA2B;EAC7B;;AAGF;EACE,iBAAiB;;EAEjB,oBAAoB;AACtB;;AAEA;EACE,gBAA0B;EAC1B,gBAA0B;AAC5B;;AAEA;EACE,cAAc;;EAEd,gBAAgB;EAChB,oBAAoB;;EAEpB,cAAc;AAChB;;AAEA;EACE,gBAAgB;;EAEhB,cAAc;AAChB\",sourcesContent:[null,'@import \"../global/variables.css\";\\n\\n@value unit from \"../global/global.css\";\\n@value button-shadow from \"../button/button.css\";\\n\\n.select {\\n position: relative;\\n\\n display: inline-block;\\n\\n white-space: nowrap;\\n\\n color: var(--ring-text-color);\\n}\\n\\n.toolbar {\\n border-top: 1px solid var(--ring-line-color);\\n}\\n\\n.button {\\n width: 100%;\\n padding: 0;\\n\\n text-align: left;\\n\\n [dir=\"rtl\"] & {\\n text-align: right;\\n direction: ltr;\\n }\\n\\n .toolbar & {\\n height: calc(4 * unit);\\n margin: unit 0;\\n }\\n\\n &.buttonSpaced {\\n padding: 0 calc(2 * unit);\\n }\\n}\\n\\n.icons {\\n position: absolute;\\n top: 0;\\n right: 5px;\\n bottom: 0;\\n\\n transition: color var(--ring-ease);\\n\\n color: var(--ring-icon-secondary-color);\\n\\n line-height: normal;\\n\\n .inputMode & {\\n font-size: var(--ring-font-size);\\n }\\n}\\n\\n.selectedIcon {\\n composes: resetButton from \"../global/global.css\";\\n\\n position: relative;\\n top: 3px;\\n\\n display: inline-block;\\n\\n width: calc(2 * unit);\\n height: calc(2 * unit);\\n margin: 0 4px;\\n\\n background-repeat: no-repeat;\\n background-position: center;\\n\\n background-size: contain;\\n}\\n\\n.clearIcon {\\n padding: 0 3px;\\n\\n vertical-align: -2px;\\n}\\n\\n.sizeS {\\n width: calc(unit * 12);\\n}\\n\\n.sizeM {\\n width: calc(unit * 30);\\n}\\n\\n.sizeL {\\n width: calc(unit * 50);\\n}\\n\\n.sizeFULL {\\n width: 100%;\\n}\\n\\n.sizeAUTO {\\n max-width: 100%;\\n}\\n\\n.buttonMode {\\n position: relative;\\n\\n cursor: pointer;\\n}\\n\\n.value {\\n composes: ellipsis from \"../global/global.css\";\\n composes: font from \"../global/global.css\";\\n\\n display: inline-block;\\n\\n box-sizing: border-box;\\n width: 100%;\\n height: calc(unit * 4 + 1px);\\n padding: 0 0 3px;\\n\\n cursor: pointer;\\n transition: color var(--ring-ease), border-color var(--ring-ease);\\n text-align: left;\\n vertical-align: top;\\n\\n color: var(--ring-text-color);\\n\\n border: none;\\n border-bottom: 1px solid var(--ring-borders-color);\\n outline: none;\\n background: transparent;\\n\\n &:focus {\\n border-color: var(--ring-main-color);\\n }\\n\\n &.open,\\n &:active {\\n border-color: transparent;\\n }\\n\\n &::-moz-focus-inner {\\n padding: 0;\\n\\n border: 0;\\n outline: 0;\\n }\\n}\\n\\n.buttonContainer {\\n position: relative;\\n\\n font-size: var(--ring-font-size);\\n}\\n\\n.buttonValue {\\n composes: ellipsis from \"../global/global.css\";\\n\\n display: block;\\n\\n width: 100%;\\n padding-left: unit;\\n\\n text-align: left;\\n vertical-align: calc(0 - unit);\\n}\\n\\n.buttonValue:focus-visible {\\n box-shadow: button-shadow var(--ring-main-color);\\n}\\n\\n.buttonValueOpen.buttonValueOpen {\\n box-shadow: button-shadow var(--ring-main-color);\\n}\\n\\n.buttonValueEmpty.buttonValueEmpty {\\n color: var(--ring-disabled-color);\\n}\\n\\n.heightS .buttonValue {\\n font-size: var(--ring-font-size);\\n}\\n\\n.label {\\n position: relative;\\n\\n color: var(--ring-secondary-color);\\n}\\n\\n.select:hover .value,\\n.select:hover .icons,\\n:focus-visible + .icons,\\n.value:focus,\\n.value:focus + .icons,\\n.open,\\n.open + .icons,\\n.buttonValueOpen + .icons {\\n transition: none;\\n\\n color: var(--ring-main-color);\\n}\\n\\n.disabled {\\n pointer-events: none;\\n\\n color: var(--ring-disabled-color);\\n\\n & .value {\\n color: var(--ring-disabled-color);\\n border-bottom-style: dashed;\\n }\\n}\\n\\n.avatar {\\n margin-right: 4px;\\n\\n vertical-align: -5px;\\n}\\n\\n.popup {\\n min-width: calc(unit * 30);\\n max-width: calc(unit * 40);\\n}\\n\\n.chevron.chevron {\\n padding: 0 3px;\\n\\n transition: none;\\n vertical-align: -1px;\\n\\n color: inherit;\\n}\\n\\n.chevronIcon.chevronIcon {\\n transition: none;\\n\\n color: inherit;\\n}\\n'],sourceRoot:\"\"}]),s.locals={unit:`${l.default.locals.unit}`,\"button-shadow\":`${c.default.locals[\"button-shadow\"]}`,select:\"select_e2a5\",value:`value_b3a3 ${l.default.locals.ellipsis} ${l.default.locals.font}`,icons:\"icons_c4a9\",toolbar:\"toolbar_d3be\",button:\"button_ef00\",buttonSpaced:\"buttonSpaced_f316\",inputMode:\"inputMode_a6f6\",selectedIcon:`selectedIcon_a62c ${l.default.locals.resetButton}`,clearIcon:\"clearIcon_c750\",sizeS:\"sizeS_e8c3\",sizeM:\"sizeM_ed34\",sizeL:\"sizeL_c053\",sizeFULL:\"sizeFULL_c585\",sizeAUTO:\"sizeAUTO_a07c\",buttonMode:\"buttonMode_dd69\",open:\"open_f1b1\",buttonContainer:\"buttonContainer_b2b9\",buttonValue:`buttonValue_b4ad ${l.default.locals.ellipsis}`,buttonValueOpen:\"buttonValueOpen_d9d3\",buttonValueEmpty:\"buttonValueEmpty_e6b3\",heightS:\"heightS_b721\",label:\"label_e56f\",disabled:\"disabled_b89f\",avatar:\"avatar_f4dd\",popup:\"popup_acec\",chevron:\"chevron_d51f\",chevronIcon:\"chevronIcon_f6cf\"};const f=s},8102:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>u});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(5280),c=a()(o());c.i(l.A),c.push([e.id,\".trapButton_c32e {\\n position: absolute;\\n left: -9999px;\\n}\\n\",\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/tab-trap/tab-trap.css\"],names:[],mappings:\"AAEA;EACE,kBAAkB;EAClB,aAAa;AACf\",sourcesContent:['@import \"../global/variables.css\";\\n\\n.trapButton {\\n position: absolute;\\n left: -9999px;\\n}\\n'],sourceRoot:\"\"}]),c.locals={trapButton:\"trapButton_c32e\"};const u=c},4561:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>s});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(9106),c=t(5280),u=a()(o());u.i(c.A),u.i(l.default,\"\",!0),u.push([e.id,'@media (hover: hover), (-moz-touch-enabled: 0), (-ms-high-contrast: none), (-ms-high-contrast: active) {.tag_b7aa:hover,\\n.tagAngled_c869:hover::before {\\n transition: none;\\n\\n background-color: var(--ring-tag-hover-background-color);\\n}}\\n\\n.tag_b7aa {\\n\\n position: relative;\\n z-index: 1;\\n\\n display: inline-flex;\\n\\n box-sizing: border-box;\\n max-width: 100%;\\n height: 20px;\\n\\n padding: 0 8px;\\n\\n cursor: pointer;\\n\\n vertical-align: top;\\n\\n color: var(--ring-text-color);\\n\\n border: none;\\n border-radius: var(--ring-border-radius);\\n\\n font-size: 12px;\\n line-height: var(--ring-line-height);\\n}\\n\\n.tag_b7aa,\\n.tagAngled_c869::before {\\n transition: background-color var(--ring-ease);\\n\\n background-color: var(--ring-tag-background-color);\\n}\\n\\n.withRemove_c0a5 {\\n padding-right: 22px;\\n}\\n\\n.container_cb34 {\\n position: relative;\\n\\n display: inline-block;\\n\\n max-width: calc(100% - 4px);\\n\\n margin-right: 4px;\\n\\n white-space: nowrap;\\n}\\n\\n.focused_fd92,\\n.tag_b7aa:focus-visible {\\n position: relative;\\n\\n outline: none;\\n box-shadow: 0 0 0 2px var(--ring-border-hover-color);\\n}\\n\\n.focused_fd92,\\n.focused_fd92.tagAngled_c869::before,\\n.tag_b7aa:focus-visible,\\n.tagAngled_c869:focus-visible::before {\\n transition: none;\\n\\n background-color: var(--ring-tag-hover-background-color);\\n}\\n\\n.tagAngled_c869 {\\n /* it needs to fix vertical alignment broken by \"overflow: hidden\". Remove this class, when IE11 will be deprecated */\\n\\n margin-bottom: -5px !important;\\n\\n margin-left: 8px;\\n padding-left: 4px;\\n\\n border-top-left-radius: 0;\\n border-bottom-left-radius: 0;\\n}\\n\\n.tagAngled_c869::before {\\n position: absolute;\\n z-index: -1;\\n top: 0;\\n left: 0;\\n\\n box-sizing: border-box;\\n width: 12px;\\n height: 12px;\\n\\n content: \"\";\\n transform: scaleY(1.177) rotate(45deg);\\n transform-origin: 0 0;\\n\\n border: none;\\n }\\n\\n.tagAngled_c869.focused_fd92,\\n .tagAngled_c869:focus {\\n box-shadow: 0 0 0 1px var(--ring-border-hover-color) inset, 0 0 0 1px var(--ring-border-hover-color);\\n }\\n\\n.tagAngled_c869:focus::before {\\n box-shadow:\\n 1px -1px var(--ring-border-hover-color) inset,\\n -0.8px 0.8px 0 0.5px var(--ring-border-hover-color);\\n }\\n\\n.content_a838 {\\n}\\n\\n.disabled_b740.tag_b7aa,\\n.disabled_b740.tagAngled_c869::before {\\n pointer-events: none;\\n\\n color: var(--ring-disabled-color);\\n background-color: var(--ring-disabled-background-color);\\n}\\n\\n.remove_eff8 {\\n position: absolute;\\n z-index: 1;\\n top: 2px;\\n right: 0;\\n\\n height: auto;\\n padding: 0 4px;\\n\\n line-height: 16px;\\n}\\n\\n.removeIcon_accf.removeIcon_accf {\\n color: var(--ring-icon-secondary-color);\\n}\\n\\n.icon_e877 {\\n margin-right: 6px;\\n\\n color: var(--ring-icon-secondary-color);\\n}\\n\\n.icon_e877 svg {\\n vertical-align: -3px;\\n }\\n\\n.avatarContainer_ee1b {\\n display: inline-block;\\n overflow: hidden;\\n\\n box-sizing: border-box;\\n width: 20px;\\n height: 20px;\\n margin-right: 4px;\\n margin-left: -8px;\\n\\n vertical-align: top;\\n\\n border-top-left-radius: var(--ring-border-radius);\\n border-bottom-left-radius: var(--ring-border-radius);\\n}\\n\\n.customIcon_ac93 {\\n max-width: 16px;\\n max-height: 16px;\\n\\n margin-right: 4px;\\n\\n vertical-align: bottom;\\n}\\n\\n.avatarIcon_a8ff {\\n width: 20px;\\n\\n margin-right: -4px;\\n\\n -o-object-fit: contain;\\n\\n object-fit: contain;\\n -o-object-position: center;\\n object-position: center;\\n}\\n',\"\",{version:3,sources:[\"\",\"webpack://./node_modules/@jetbrains/ring-ui/components/tag/tag.css\"],names:[],mappings:\"AAAA,wGAAA;;EAAA,iBAAA;;EAAA,yDAAA;CAAA,CAAA;;ACKA;;EAGE,kBAAkB;EAClB,UAAU;;EAEV,oBAAoB;;EAEpB,sBAAsB;EACtB,eAAe;EACf,YAAkB;;EAElB,cAAe;;EAEf,eAAe;;EAEf,mBAAmB;;EAEnB,6BAA6B;;EAE7B,YAAY;EACZ,wCAAwC;;EAExC,eAAe;EACf,oCAAoC;AACtC;;AAEA;;EAEE,6CAA6C;;EAE7C,kDAAkD;AACpD;;AAEA;EACE,mBAAmB;AACrB;;AAEA;EACE,kBAAkB;;EAElB,qBAAqB;;EAErB,2BAAgC;;EAEhC,iBAA4B;;EAE5B,mBAAmB;AACrB;;AAEA;;EAEE,kBAAkB;;EAElB,aAAa;EACb,oDAAoD;AACtD;;AAEA;;;;EAME,gBAAgB;;EAEhB,wDAAwD;AAC1D;;AAEA;EACE,qHAAqH;;EAErH,8BAA8B;;EAE9B,gBAAiB;EACjB,iBAA4B;;EAE5B,yBAAyB;EACzB,4BAA4B;AA6B9B;;AA3BE;IACE,kBAAkB;IAClB,WAAW;IACX,MAAM;IACN,OAAO;;IAEP,sBAAsB;IACtB,WAAW;IACX,YAAY;;IAEZ,WAAW;IACX,sCAAsC;IACtC,qBAAqB;;IAErB,YAAY;EACd;;AAEA;;IAEE,oGAAoG;EACtG;;AAEA;IACE;;yDAEqD;EACvD;;AAGF;AAEA;;AAEA;;EAEE,oBAAoB;;EAEpB,iCAAiC;EACjC,uDAAuD;AACzD;;AAEA;EACE,kBAAkB;EAClB,UAAU;EACV,QAAQ;EACR,QAAQ;;EAER,YAAY;EACZ,cAAyB;;EAEzB,iBAA2B;AAC7B;;AAEA;EACE,uCAAuC;AACzC;;AAEA;EACE,iBAAiB;;EAEjB,uCAAuC;AAKzC;;AAHE;IACE,oBAAoB;EACtB;;AAGF;EACE,qBAAqB;EACrB,gBAAgB;;EAEhB,sBAAsB;EACtB,WAAiB;EACjB,YAAkB;EAClB,iBAA4B;EAC5B,iBAA2B;;EAE3B,mBAAmB;;EAEnB,iDAAiD;EACjD,oDAAoD;AACtD;;AAEA;EACE,eAAyB;EACzB,gBAA0B;;EAE1B,iBAA4B;;EAE5B,sBAAsB;AACxB;;AAEA;EACE,WAAiB;;EAEjB,kBAAkB;;EAElB,sBAAmB;;KAAnB,mBAAmB;EACnB,0BAAuB;KAAvB,uBAAuB;AACzB\",sourcesContent:[null,'@import \"../global/variables.css\";\\n\\n@value unit from \"../global/global.css\";\\n@value max-height: 20px;\\n\\n.tag {\\n composes: resetButton from \"../global/global.css\";\\n\\n position: relative;\\n z-index: 1;\\n\\n display: inline-flex;\\n\\n box-sizing: border-box;\\n max-width: 100%;\\n height: max-height;\\n\\n padding: 0 unit;\\n\\n cursor: pointer;\\n\\n vertical-align: top;\\n\\n color: var(--ring-text-color);\\n\\n border: none;\\n border-radius: var(--ring-border-radius);\\n\\n font-size: 12px;\\n line-height: var(--ring-line-height);\\n}\\n\\n.tag,\\n.tagAngled::before {\\n transition: background-color var(--ring-ease);\\n\\n background-color: var(--ring-tag-background-color);\\n}\\n\\n.withRemove {\\n padding-right: 22px;\\n}\\n\\n.container {\\n position: relative;\\n\\n display: inline-block;\\n\\n max-width: calc(100% - unit / 2);\\n\\n margin-right: calc(unit / 2);\\n\\n white-space: nowrap;\\n}\\n\\n.focused,\\n.tag:focus-visible {\\n position: relative;\\n\\n outline: none;\\n box-shadow: 0 0 0 2px var(--ring-border-hover-color);\\n}\\n\\n.focused,\\n.focused.tagAngled::before,\\n.tag:focus-visible,\\n.tagAngled:focus-visible::before,\\n.tag:hover,\\n.tagAngled:hover::before {\\n transition: none;\\n\\n background-color: var(--ring-tag-hover-background-color);\\n}\\n\\n.tagAngled {\\n /* it needs to fix vertical alignment broken by \"overflow: hidden\". Remove this class, when IE11 will be deprecated */\\n\\n margin-bottom: -5px !important;\\n\\n margin-left: unit;\\n padding-left: calc(unit / 2);\\n\\n border-top-left-radius: 0;\\n border-bottom-left-radius: 0;\\n\\n &::before {\\n position: absolute;\\n z-index: -1;\\n top: 0;\\n left: 0;\\n\\n box-sizing: border-box;\\n width: 12px;\\n height: 12px;\\n\\n content: \"\";\\n transform: scaleY(1.177) rotate(45deg);\\n transform-origin: 0 0;\\n\\n border: none;\\n }\\n\\n &.focused,\\n &:focus {\\n box-shadow: 0 0 0 1px var(--ring-border-hover-color) inset, 0 0 0 1px var(--ring-border-hover-color);\\n }\\n\\n &:focus::before {\\n box-shadow:\\n 1px -1px var(--ring-border-hover-color) inset,\\n -0.8px 0.8px 0 0.5px var(--ring-border-hover-color);\\n }\\n}\\n\\n.content {\\n composes: ellipsis from \"../global/global.css\";\\n}\\n\\n.disabled.tag,\\n.disabled.tagAngled::before {\\n pointer-events: none;\\n\\n color: var(--ring-disabled-color);\\n background-color: var(--ring-disabled-background-color);\\n}\\n\\n.remove {\\n position: absolute;\\n z-index: 1;\\n top: 2px;\\n right: 0;\\n\\n height: auto;\\n padding: 0 calc(unit / 2);\\n\\n line-height: calc(unit * 2);\\n}\\n\\n.removeIcon.removeIcon {\\n color: var(--ring-icon-secondary-color);\\n}\\n\\n.icon {\\n margin-right: 6px;\\n\\n color: var(--ring-icon-secondary-color);\\n\\n & svg {\\n vertical-align: -3px;\\n }\\n}\\n\\n.avatarContainer {\\n display: inline-block;\\n overflow: hidden;\\n\\n box-sizing: border-box;\\n width: max-height;\\n height: max-height;\\n margin-right: calc(unit / 2);\\n margin-left: calc(0 - unit);\\n\\n vertical-align: top;\\n\\n border-top-left-radius: var(--ring-border-radius);\\n border-bottom-left-radius: var(--ring-border-radius);\\n}\\n\\n.customIcon {\\n max-width: calc(unit * 2);\\n max-height: calc(unit * 2);\\n\\n margin-right: calc(unit / 2);\\n\\n vertical-align: bottom;\\n}\\n\\n.avatarIcon {\\n width: max-height;\\n\\n margin-right: -4px;\\n\\n object-fit: contain;\\n object-position: center;\\n}\\n'],sourceRoot:\"\"}]),u.locals={unit:`${l.default.locals.unit}`,\"max-height\":\"20px\",tag:`tag_b7aa ${l.default.locals.resetButton}`,tagAngled:\"tagAngled_c869\",withRemove:\"withRemove_c0a5\",container:\"container_cb34\",focused:\"focused_fd92\",content:`content_a838 ${l.default.locals.ellipsis}`,disabled:\"disabled_b740\",remove:\"remove_eff8\",removeIcon:\"removeIcon_accf\",icon:\"icon_e877\",avatarContainer:\"avatarContainer_ee1b\",customIcon:\"customIcon_ac93\",avatarIcon:\"avatarIcon_a8ff\"};const s=u},6162:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>u});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(5280),c=a()(o());c.i(l.A),c.push([e.id,\".text_f1dc {\\n color: var(--ring-text-color);\\n}\\n\\n.sizeS_b3aa {\\n font-size: var(--ring-font-size-smaller);\\n}\\n\\n.sizeM_ae72 {\\n font-size: var(--ring-font-size);\\n}\\n\\n.sizeL_f259 {\\n font-size: var(--ring-font-size-larger);\\n}\\n\\n.info_c0a4 {\\n color: var(--ring-secondary-color);\\n}\\n\",\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/text/text.css\"],names:[],mappings:\"AAEA;EACE,6BAA6B;AAC/B;;AAEA;EACE,wCAAwC;AAC1C;;AAEA;EACE,gCAAgC;AAClC;;AAEA;EACE,uCAAuC;AACzC;;AAEA;EACE,kCAAkC;AACpC\",sourcesContent:['@import \"../global/variables.css\";\\n\\n.text {\\n color: var(--ring-text-color);\\n}\\n\\n.sizeS {\\n font-size: var(--ring-font-size-smaller);\\n}\\n\\n.sizeM {\\n font-size: var(--ring-font-size);\\n}\\n\\n.sizeL {\\n font-size: var(--ring-font-size-larger);\\n}\\n\\n.info {\\n color: var(--ring-secondary-color);\\n}\\n'],sourceRoot:\"\"}]),c.locals={text:\"text_f1dc\",sizeS:\"sizeS_b3aa\",sizeM:\"sizeM_ae72\",sizeL:\"sizeL_f259\",info:\"info_c0a4\"};const u=c},938:(e,n,t)=>{\"use strict\";t.r(n),t.d(n,{default:()=>s});var r=t(1404),o=t.n(r),i=t(7156),a=t.n(i),l=t(9106),c=t(5280),u=a()(o());u.i(c.A),u.i(l.default,\"\",!0),u.push([e.id,\".tooltip_fbfb {\\n max-width: 400px;\\n padding: 8px;\\n\\n text-align: left;\\n\\n color: var(--ring-text-color);\\n}\\n\\n.long_b7a5 {\\n padding: 8px 12px;\\n\\n font-size: var(--ring-font-size-smaller);\\n line-height: var(--ring-line-height-lowest);\\n}\\n\",\"\",{version:3,sources:[\"webpack://./node_modules/@jetbrains/ring-ui/components/tooltip/tooltip.css\"],names:[],mappings:\"AAIA;EACE,gBAA0B;EAC1B,YAAa;;EAEb,gBAAgB;;EAEhB,6BAA6B;AAC/B;;AAEA;EACE,iBAA8B;;EAE9B,wCAAwC;EACxC,2CAA2C;AAC7C\",sourcesContent:['@import \"../global/variables.css\";\\n\\n@value unit from \"../global/global.css\";\\n\\n.tooltip {\\n max-width: calc(unit * 50);\\n padding: unit;\\n\\n text-align: left;\\n\\n color: var(--ring-text-color);\\n}\\n\\n.long {\\n padding: unit calc(unit * 1.5);\\n\\n font-size: var(--ring-font-size-smaller);\\n line-height: var(--ring-line-height-lowest);\\n}\\n'],sourceRoot:\"\"}]),u.locals={unit:`${l.default.locals.unit}`,tooltip:\"tooltip_fbfb\",long:\"long_b7a5\"};const s=u},7156:e=>{\"use strict\";e.exports=function(e){var n=[];return n.toString=function(){return this.map((function(n){var t=\"\",r=void 0!==n[5];return n[4]&&(t+=\"@supports (\".concat(n[4],\") {\")),n[2]&&(t+=\"@media \".concat(n[2],\" {\")),r&&(t+=\"@layer\".concat(n[5].length>0?\" \".concat(n[5]):\"\",\" {\")),t+=e(n),r&&(t+=\"}\"),n[2]&&(t+=\"}\"),n[4]&&(t+=\"}\"),t})).join(\"\")},n.i=function(e,t,r,o,i){\"string\"==typeof e&&(e=[[null,e,void 0]]);var a={};if(r)for(var l=0;l0?\" \".concat(s[5]):\"\",\" {\").concat(s[1],\"}\")),s[5]=i),t&&(s[2]?(s[1]=\"@media \".concat(s[2],\" {\").concat(s[1],\"}\"),s[2]=t):s[2]=t),o&&(s[4]?(s[1]=\"@supports (\".concat(s[4],\") {\").concat(s[1],\"}\"),s[4]=o):s[4]=\"\".concat(o)),n.push(s))}},n}},1404:e=>{\"use strict\";e.exports=function(e){var n=e[1],t=e[3];if(!t)return n;if(\"function\"==typeof btoa){var r=btoa(unescape(encodeURIComponent(JSON.stringify(t)))),o=\"sourceMappingURL=data:application/json;charset=utf-8;base64,\".concat(r),i=\"/*# \".concat(o,\" */\");return[n].concat([i]).join(\"\\n\")}return[n].join(\"\\n\")}},4504:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(7222);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},9102:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(9892);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},6860:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(1866);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},3912:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(5486);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},8764:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(6506);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},6620:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(9106);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},9468:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(5066);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},274:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(8976);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},5924:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(8266);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},7826:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(6960);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},1914:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(480);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},8130:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(1586);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},1564:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(8890);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},5103:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(4481);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},3006:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(2636);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},9344:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(8102);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},4512:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(4561);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},6932:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(6162);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},8132:(e,n,t)=>{var r=t(8298),o=t(5163),i=t(2729),a=t(9986),l=t(9742),c=t(6291),u=t(938);u=u.__esModule?u.default:u;var s={};s.styleTagTransform=c,s.setAttributes=a,s.insert=i.bind(null,\"head\"),s.domAPI=o,s.insertStyleElement=l;r(u,s);e.exports=u&&u.locals||{}},8298:e=>{\"use strict\";var n=[];function t(e){for(var t=-1,r=0;r{\"use strict\";var n={};e.exports=function(e,t){var r=function(e){if(void 0===n[e]){var t=document.querySelector(e);if(window.HTMLIFrameElement&&t instanceof window.HTMLIFrameElement)try{t=t.contentDocument.head}catch(e){t=null}n[e]=t}return n[e]}(e);if(!r)throw new Error(\"Couldn't find a style target. This probably means that the value for the 'insert' parameter is invalid.\");r.appendChild(t)}},9742:e=>{\"use strict\";e.exports=function(e){var n=document.createElement(\"style\");return e.setAttributes(n,e.attributes),e.insert(n,e.options),n}},9986:(e,n,t)=>{\"use strict\";e.exports=function(e){var n=t.nc;n&&e.setAttribute(\"nonce\",n)}},5163:e=>{\"use strict\";e.exports=function(e){if(\"undefined\"==typeof document)return{update:function(){},remove:function(){}};var n=e.insertStyleElement(e);return{update:function(t){!function(e,n,t){var r=\"\";t.supports&&(r+=\"@supports (\".concat(t.supports,\") {\")),t.media&&(r+=\"@media \".concat(t.media,\" {\"));var o=void 0!==t.layer;o&&(r+=\"@layer\".concat(t.layer.length>0?\" \".concat(t.layer):\"\",\" {\")),r+=t.css,o&&(r+=\"}\"),t.media&&(r+=\"}\"),t.supports&&(r+=\"}\");var i=t.sourceMap;i&&\"undefined\"!=typeof btoa&&(r+=\"\\n/*# sourceMappingURL=data:application/json;base64,\".concat(btoa(unescape(encodeURIComponent(JSON.stringify(i)))),\" */\")),n.styleTagTransform(r,e,n.options)}(n,e,t)},remove:function(){!function(e){if(null===e.parentNode)return!1;e.parentNode.removeChild(e)}(n)}}}},6291:e=>{\"use strict\";e.exports=function(e,n){if(n.styleSheet)n.styleSheet.cssText=e;else{for(;n.firstChild;)n.removeChild(n.firstChild);n.appendChild(document.createTextNode(e))}}},9511:(e,n,t)=>{\"use strict\";var r=t(8075)(\"ArrayBuffer.prototype.byteLength\",!0),o=t(4670);e.exports=function(e){return o(e)?r?r(e):e.byteLength:NaN}},8075:(e,n,t)=>{\"use strict\";var r=t(453),o=t(487),i=o(r(\"String.prototype.indexOf\"));e.exports=function(e,n){var t=r(e,!!n);return\"function\"==typeof t&&i(e,\".prototype.\")>-1?o(t):t}},487:(e,n,t)=>{\"use strict\";var r=t(6743),o=t(453),i=t(6897),a=t(9675),l=o(\"%Function.prototype.apply%\"),c=o(\"%Function.prototype.call%\"),u=o(\"%Reflect.apply%\",!0)||r.call(c,l),s=t(3036),f=o(\"%Math.max%\");e.exports=function(e){if(\"function\"!=typeof e)throw new a(\"a function is required\");var n=u(r,c,arguments);return i(n,1+f(0,e.length-(arguments.length-1)),!0)};var p=function(){return u(r,l,arguments)};s?s(e.exports,\"apply\",{value:p}):e.exports.apply=p},5888:(e,n,t)=>{\"use strict\";e.exports=function(e,n){var t=this,r=t.constructor;return t.options=Object.assign({storeInstancesGlobally:!0},n||{}),t.callbacks={},t.directMap={},t.sequenceLevels={},t.resetTimer=null,t.ignoreNextKeyup=!1,t.ignoreNextKeypress=!1,t.nextExpectedAction=!1,t.element=e,t.addEvents(),t.options.storeInstancesGlobally&&r.instances.push(t),t},e.exports.prototype.bind=t(1210),e.exports.prototype.bindMultiple=t(4382),e.exports.prototype.unbind=t(3709),e.exports.prototype.trigger=t(3149),e.exports.prototype.reset=t(6726),e.exports.prototype.stopCallback=t(4446),e.exports.prototype.handleKey=t(4320),e.exports.prototype.addEvents=t(6687),e.exports.prototype.bindSingle=t(2214),e.exports.prototype.getKeyInfo=t(4174),e.exports.prototype.pickBestAction=t(6004),e.exports.prototype.getReverseMap=t(5193),e.exports.prototype.getMatches=t(9132),e.exports.prototype.resetSequences=t(3229),e.exports.prototype.fireCallback=t(7922),e.exports.prototype.bindSequence=t(3256),e.exports.prototype.resetSequenceTimer=t(602),e.exports.prototype.detach=t(3502),e.exports.instances=[],e.exports.reset=t(6255),e.exports.REVERSE_MAP=null},6687:(e,n,t)=>{\"use strict\";e.exports=function(){var e=this,n=t(2904),r=e.element;e.eventHandler=t(8178).bind(e),n(r,\"keypress\",e.eventHandler),n(r,\"keydown\",e.eventHandler),n(r,\"keyup\",e.eventHandler)}},1210:e=>{\"use strict\";e.exports=function(e,n,t){return e=e instanceof Array?e:[e],this.bindMultiple(e,n,t),this}},4382:e=>{\"use strict\";e.exports=function(e,n,t){for(var r=0;r{\"use strict\";e.exports=function(e,n,r,o){var i=this;function a(n){return function(){i.nextExpectedAction=n,++i.sequenceLevels[e],i.resetSequenceTimer()}}function l(n){var a;i.fireCallback(r,n,e),\"keyup\"!==o&&(a=t(3970),i.ignoreNextKeyup=a(n)),setTimeout((function(){i.resetSequences()}),10)}i.sequenceLevels[e]=0;for(var c=0;c{\"use strict\";e.exports=function(e,n,t,r,o){var i=this;i.directMap[e+\":\"+t]=n;var a,l=(e=e.replace(/\\s+/g,\" \")).split(\" \");l.length>1?i.bindSequence(e,l,n,t):(a=i.getKeyInfo(e,t),i.callbacks[a.key]=i.callbacks[a.key]||[],i.getMatches(a.key,a.modifiers,{type:a.action},r,e,o),i.callbacks[a.key][r?\"unshift\":\"push\"]({callback:n,modifiers:a.modifiers,action:a.action,seq:r,level:o,combo:e}))}},3502:(e,n,t)=>{var r=t(2904).off;e.exports=function(){var e=this,n=e.element;r(n,\"keypress\",e.eventHandler),r(n,\"keydown\",e.eventHandler),r(n,\"keyup\",e.eventHandler)}},2904:e=>{function n(e,n,t,r){return!e.addEventListener&&(n=\"on\"+n),(e.addEventListener||e.attachEvent).call(e,n,t,r),t}e.exports=n,e.exports.on=n,e.exports.off=function(e,n,t,r){return!e.removeEventListener&&(n=\"on\"+n),(e.removeEventListener||e.detachEvent).call(e,n,t,r),t}},7922:(e,n,t)=>{\"use strict\";e.exports=function(e,n,r,o){this.stopCallback(n,n.target||n.srcElement,r,o)||!1===e(n,r)&&(t(2156)(n),t(1849)(n))}},4174:(e,n,t)=>{\"use strict\";e.exports=function(e,n){var r,o,i,a,l,c,u=[];for(r=t(7486)(e),a=t(7641),l=t(7984),c=t(5962),i=0;i{\"use strict\";e.exports=function(e,n,r,o,i,a){var l,c,u,s,f=this,p=[],d=r.type;\"keypress\"!==d||r.code&&\"Arrow\"===r.code.slice(0,5)||(f.callbacks[\"any-character\"]||[]).forEach((function(e){p.push(e)}));if(!f.callbacks[e])return p;for(u=t(5962),\"keyup\"===d&&u(e)&&(n=[e]),l=0;l{\"use strict\";e.exports=function(){var e,n=this.constructor;if(!n.REVERSE_MAP)for(var r in n.REVERSE_MAP={},e=t(6814))r>95&&r<112||e.hasOwnProperty(r)&&(n.REVERSE_MAP[e[r]]=r);return n.REVERSE_MAP}},4320:(e,n,t)=>{\"use strict\";e.exports=function(e,n,r){var o,i,a,l,c=this,u={},s=0,f=!1;for(o=c.getMatches(e,n,r),i=0;i{\"use strict\";e.exports=function(e){var n,r=this;\"number\"!=typeof e.which&&(e.which=e.keyCode);var o=t(3970)(e);void 0!==o&&(\"keyup\"!==e.type||r.ignoreNextKeyup!==o?(n=t(5273),r.handleKey(o,n(e),e)):r.ignoreNextKeyup=!1)}},7238:e=>{\"use strict\";e.exports=function(e,n){return e.sort().join(\",\")===n.sort().join(\",\")}},6004:e=>{\"use strict\";e.exports=function(e,n,t){return t||(t=this.getReverseMap()[e]?\"keydown\":\"keypress\"),\"keypress\"===t&&n.length&&(t=\"keydown\"),t}},6726:e=>{\"use strict\";e.exports=function(){return this.callbacks={},this.directMap={},this}},602:e=>{\"use strict\";e.exports=function(){var e=this;clearTimeout(e.resetTimer),e.resetTimer=setTimeout((function(){e.resetSequences()}),1e3)}},3229:e=>{\"use strict\";e.exports=function(e){var n=this;e=e||{};var t,r=!1;for(t in n.sequenceLevels)e[t]?r=!0:n.sequenceLevels[t]=0;r||(n.nextExpectedAction=!1)}},4446:e=>{\"use strict\";e.exports=function(e,n){if((\" \"+n.className+\" \").indexOf(\" combokeys \")>-1)return!1;var t=n.tagName.toLowerCase();return\"input\"===t||\"select\"===t||\"textarea\"===t||n.isContentEditable}},3149:e=>{\"use strict\";e.exports=function(e,n){return this.directMap[e+\":\"+n]&&this.directMap[e+\":\"+n]({},e),this}},3709:e=>{\"use strict\";e.exports=function(e,n){return this.bind(e,(function(){}),n)}},6255:e=>{\"use strict\";e.exports=function(){this.instances.forEach((function(e){e.reset()}))}},3970:(e,n,t)=>{\"use strict\";e.exports=function(e){var n,r;if(n=t(6814),r=t(4082),\"keypress\"===e.type){var o=String.fromCharCode(e.which);return e.shiftKey||(o=o.toLowerCase()),o}return void 0!==n[e.which]?n[e.which]:void 0!==r[e.which]?r[e.which]:String.fromCharCode(e.which).toLowerCase()}},5273:e=>{\"use strict\";e.exports=function(e){var n=[];return e.shiftKey&&n.push(\"shift\"),e.altKey&&n.push(\"alt\"),e.ctrlKey&&n.push(\"ctrl\"),e.metaKey&&n.push(\"meta\"),n}},5962:e=>{\"use strict\";e.exports=function(e){return\"shift\"===e||\"ctrl\"===e||\"alt\"===e||\"meta\"===e}},7486:e=>{\"use strict\";e.exports=function(e){return\"+\"===e?[\"+\"]:e.split(\"+\")}},2156:e=>{\"use strict\";e.exports=function(e){e.preventDefault?e.preventDefault():e.returnValue=!1}},7984:e=>{\"use strict\";e.exports={\"~\":\"`\",\"!\":\"1\",\"@\":\"2\",\"#\":\"3\",$:\"4\",\"%\":\"5\",\"^\":\"6\",\"&\":\"7\",\"*\":\"8\",\"(\":\"9\",\")\":\"0\",_:\"-\",\"+\":\"=\",\":\":\";\",'\"':\"'\",\"<\":\",\",\">\":\".\",\"?\":\"/\",\"|\":\"\\\\\"}},7641:e=>{\"use strict\";e.exports={option:\"alt\",command:\"meta\",return:\"enter\",escape:\"esc\",mod:/Mac|iPod|iPhone|iPad/.test(navigator.platform)?\"meta\":\"ctrl\"}},4082:e=>{\"use strict\";e.exports={106:\"*\",107:\"plus\",109:\"minus\",110:\".\",111:\"/\",186:\";\",187:\"=\",188:\",\",189:\"-\",190:\".\",191:\"/\",192:\"`\",219:\"[\",220:\"\\\\\",221:\"]\",222:\"'\"}},6814:e=>{\"use strict\";e.exports={8:\"backspace\",9:\"tab\",13:\"enter\",16:\"shift\",17:\"ctrl\",18:\"alt\",20:\"capslock\",27:\"esc\",32:\"space\",33:\"pageup\",34:\"pagedown\",35:\"end\",36:\"home\",37:\"left\",38:\"up\",39:\"right\",40:\"down\",45:\"ins\",46:\"del\",91:\"meta\",93:\"meta\",173:\"minus\",187:\"plus\",189:\"minus\",224:\"meta\"};for(var n=1;n<20;++n)e.exports[111+n]=\"f\"+n;for(n=0;n<=9;++n)e.exports[n+96]=n},1849:e=>{\"use strict\";e.exports=function(e){e.stopPropagation?e.stopPropagation():e.cancelBubble=!0}},4982:(e,n,t)=>{\"use strict\";var r=t(6525),o=t(8075),i=t(1589),a=t(453),l=t(4552),c=t(920),u=t(7653),s=t(7244),f=t(4634),p=t(4670),d=t(2120),g=t(4035),h=t(7070),v=t(1189),b=t(1539),A=t(593),m=t(5767),y=t(9511),E=o(\"SharedArrayBuffer.prototype.byteLength\",!0),C=o(\"Date.prototype.getTime\"),w=Object.getPrototypeOf,_=o(\"Object.prototype.toString\"),x=a(\"%Set%\",!0),S=o(\"Map.prototype.has\",!0),k=o(\"Map.prototype.get\",!0),O=o(\"Map.prototype.size\",!0),B=o(\"Set.prototype.add\",!0),T=o(\"Set.prototype.delete\",!0),P=o(\"Set.prototype.has\",!0),I=o(\"Set.prototype.size\",!0);function j(e,n,t,r){for(var o,i=l(e);(o=i.next())&&!o.done;)if(N(n,o.value,t,r))return T(e,o.value),!0;return!1}function z(e){return void 0===e?null:\"object\"!=typeof e?\"symbol\"!=typeof e&&(\"string\"!=typeof e&&\"number\"!=typeof e||+e==+e):void 0}function D(e,n,t,o,i,a){var l=z(t);if(null!=l)return l;var c=k(n,l),u=r({},i,{strict:!1});return!(void 0===c&&!S(n,l)||!N(o,c,u,a))&&(!S(e,l)&&N(o,c,u,a))}function R(e,n,t){var r=z(t);return null!=r?r:P(n,r)&&!P(e,r)}function M(e,n,t,r,o,i){for(var a,c,u=l(e);(a=u.next())&&!a.done;)if(N(t,c=a.value,o,i)&&N(r,k(n,c),o,i))return T(e,c),!0;return!1}function N(e,n,t,o){var a=t||{};if(a.strict?u(e,n):e===n)return!0;if(b(e)!==b(n))return!1;if(!e||!n||\"object\"!=typeof e&&\"object\"!=typeof n)return a.strict?u(e,n):e==n;var c,T=o.has(e),z=o.has(n);if(T&&z){if(o.get(e)===o.get(n))return!0}else c={};return T||o.set(e,c),z||o.set(n,c),function(e,n,t,o){var a,c;if(typeof e!=typeof n)return!1;if(null==e||null==n)return!1;if(_(e)!==_(n))return!1;if(s(e)!==s(n))return!1;var u=f(e),b=f(n);if(u!==b)return!1;var T=e instanceof Error,z=n instanceof Error;if(T!==z)return!1;if((T||z)&&(e.name!==n.name||e.message!==n.message))return!1;var L=g(e),U=g(n);if(L!==U)return!1;if((L||U)&&(e.source!==n.source||i(e)!==i(n)))return!1;var H=d(e),W=d(n);if(H!==W)return!1;if((H||W)&&C(e)!==C(n))return!1;if(t.strict&&w&&w(e)!==w(n))return!1;var G=m(e),Y=m(n);if(G!==Y)return!1;if(G||Y){if(e.length!==n.length)return!1;for(a=0;a=0;a--)if(Z[a]!=J[a])return!1;for(a=Z.length-1;a>=0;a--)if(!N(e[c=Z[a]],n[c],t,o))return!1;var ee=A(e),ne=A(n);if(ee!==ne)return!1;if(\"Set\"===ee||\"Set\"===ne)return function(e,n,t,r){if(I(e)!==I(n))return!1;var o,i,a,c=l(e),u=l(n);for(;(o=c.next())&&!o.done;)if(o.value&&\"object\"==typeof o.value)a||(a=new x),B(a,o.value);else if(!P(n,o.value)){if(t.strict)return!1;if(!R(e,n,o.value))return!1;a||(a=new x),B(a,o.value)}if(a){for(;(i=u.next())&&!i.done;)if(i.value&&\"object\"==typeof i.value){if(!j(a,i.value,t.strict,r))return!1}else if(!t.strict&&!P(e,i.value)&&!j(a,i.value,t.strict,r))return!1;return 0===I(a)}return!0}(e,n,t,o);if(\"Map\"===ee)return function(e,n,t,o){if(O(e)!==O(n))return!1;var i,a,c,u,s,f,p=l(e),d=l(n);for(;(i=p.next())&&!i.done;)if(u=i.value[0],s=i.value[1],u&&\"object\"==typeof u)c||(c=new x),B(c,u);else if(void 0===(f=k(n,u))&&!S(n,u)||!N(s,f,t,o)){if(t.strict)return!1;if(!D(e,n,u,s,t,o))return!1;c||(c=new x),B(c,u)}if(c){for(;(a=d.next())&&!a.done;)if(u=a.value[0],f=a.value[1],u&&\"object\"==typeof u){if(!M(c,e,u,f,t,o))return!1}else if(!(t.strict||e.has(u)&&N(k(e,u),f,t,o)||M(c,e,u,f,r({},t,{strict:!1}),o)))return!1;return 0===I(c)}return!0}(e,n,t,o);return!0}(e,n,a,o)}function F(e){return!(!e||\"object\"!=typeof e||\"number\"!=typeof e.length)&&(\"function\"==typeof e.copy&&\"function\"==typeof e.slice&&(!(e.length>0&&\"number\"!=typeof e[0])&&!!(e.constructor&&e.constructor.isBuffer&&e.constructor.isBuffer(e))))}e.exports=function(e,n,t){return N(e,n,t,c())}},41:(e,n,t)=>{\"use strict\";var r=t(3036),o=t(8068),i=t(9675),a=t(5795);e.exports=function(e,n,t){if(!e||\"object\"!=typeof e&&\"function\"!=typeof e)throw new i(\"`obj` must be an object or a function`\");if(\"string\"!=typeof n&&\"symbol\"!=typeof n)throw new i(\"`property` must be a string or a symbol`\");if(arguments.length>3&&\"boolean\"!=typeof arguments[3]&&null!==arguments[3])throw new i(\"`nonEnumerable`, if provided, must be a boolean or null\");if(arguments.length>4&&\"boolean\"!=typeof arguments[4]&&null!==arguments[4])throw new i(\"`nonWritable`, if provided, must be a boolean or null\");if(arguments.length>5&&\"boolean\"!=typeof arguments[5]&&null!==arguments[5])throw new i(\"`nonConfigurable`, if provided, must be a boolean or null\");if(arguments.length>6&&\"boolean\"!=typeof arguments[6])throw new i(\"`loose`, if provided, must be a boolean\");var l=arguments.length>3?arguments[3]:null,c=arguments.length>4?arguments[4]:null,u=arguments.length>5?arguments[5]:null,s=arguments.length>6&&arguments[6],f=!!a&&a(e,n);if(r)r(e,n,{configurable:null===u&&f?f.configurable:!u,enumerable:null===l&&f?f.enumerable:!l,value:t,writable:null===c&&f?f.writable:!c});else{if(!s&&(l||c||u))throw new o(\"This environment does not support defining a property as non-configurable, non-writable, or non-enumerable.\");e[n]=t}}},8452:(e,n,t)=>{\"use strict\";var r=t(1189),o=\"function\"==typeof Symbol&&\"symbol\"==typeof Symbol(\"foo\"),i=Object.prototype.toString,a=Array.prototype.concat,l=t(41),c=t(592)(),u=function(e,n,t,r){if(n in e)if(!0===r){if(e[n]===t)return}else if(\"function\"!=typeof(o=r)||\"[object Function]\"!==i.call(o)||!r())return;var o;c?l(e,n,t,!0):l(e,n,t)},s=function(e,n){var t=arguments.length>2?arguments[2]:{},i=r(n);o&&(i=a.call(i,Object.getOwnPropertySymbols(n)));for(var l=0;l{\"use strict\";var r=t(453)(\"%Object.defineProperty%\",!0)||!1;if(r)try{r({},\"a\",{value:1})}catch(e){r=!1}e.exports=r},1237:e=>{\"use strict\";e.exports=EvalError},9383:e=>{\"use strict\";e.exports=Error},9290:e=>{\"use strict\";e.exports=RangeError},9538:e=>{\"use strict\";e.exports=ReferenceError},8068:e=>{\"use strict\";e.exports=SyntaxError},9675:e=>{\"use strict\";e.exports=TypeError},5345:e=>{\"use strict\";e.exports=URIError},2682:(e,n,t)=>{\"use strict\";var r=t(9600),o=Object.prototype.toString,i=Object.prototype.hasOwnProperty;e.exports=function(e,n,t){if(!r(n))throw new TypeError(\"iterator must be a function\");var a;arguments.length>=3&&(a=t),\"[object Array]\"===o.call(e)?function(e,n,t){for(var r=0,o=e.length;r{\"use strict\";var n=Object.prototype.toString,t=Math.max,r=function(e,n){for(var t=[],r=0;r{\"use strict\";var r=t(9353);e.exports=Function.prototype.bind||r},4462:e=>{\"use strict\";var n=function(){return\"string\"==typeof function(){}.name},t=Object.getOwnPropertyDescriptor;if(t)try{t([],\"length\")}catch(e){t=null}n.functionsHaveConfigurableNames=function(){if(!n()||!t)return!1;var e=t((function(){}),\"name\");return!!e&&!!e.configurable};var r=Function.prototype.bind;n.boundFunctionsHaveNames=function(){return n()&&\"function\"==typeof r&&\"\"!==function(){}.bind().name},e.exports=n},453:(e,n,t)=>{\"use strict\";var r,o=t(9383),i=t(1237),a=t(9290),l=t(9538),c=t(8068),u=t(9675),s=t(5345),f=Function,p=function(e){try{return f('\"use strict\"; return ('+e+\").constructor;\")()}catch(e){}},d=Object.getOwnPropertyDescriptor;if(d)try{d({},\"\")}catch(e){d=null}var g=function(){throw new u},h=d?function(){try{return g}catch(e){try{return d(arguments,\"callee\").get}catch(e){return g}}}():g,v=t(4039)(),b=t(24)(),A=Object.getPrototypeOf||(b?function(e){return e.__proto__}:null),m={},y=\"undefined\"!=typeof Uint8Array&&A?A(Uint8Array):r,E={__proto__:null,\"%AggregateError%\":\"undefined\"==typeof AggregateError?r:AggregateError,\"%Array%\":Array,\"%ArrayBuffer%\":\"undefined\"==typeof ArrayBuffer?r:ArrayBuffer,\"%ArrayIteratorPrototype%\":v&&A?A([][Symbol.iterator]()):r,\"%AsyncFromSyncIteratorPrototype%\":r,\"%AsyncFunction%\":m,\"%AsyncGenerator%\":m,\"%AsyncGeneratorFunction%\":m,\"%AsyncIteratorPrototype%\":m,\"%Atomics%\":\"undefined\"==typeof Atomics?r:Atomics,\"%BigInt%\":\"undefined\"==typeof BigInt?r:BigInt,\"%BigInt64Array%\":\"undefined\"==typeof BigInt64Array?r:BigInt64Array,\"%BigUint64Array%\":\"undefined\"==typeof BigUint64Array?r:BigUint64Array,\"%Boolean%\":Boolean,\"%DataView%\":\"undefined\"==typeof DataView?r:DataView,\"%Date%\":Date,\"%decodeURI%\":decodeURI,\"%decodeURIComponent%\":decodeURIComponent,\"%encodeURI%\":encodeURI,\"%encodeURIComponent%\":encodeURIComponent,\"%Error%\":o,\"%eval%\":eval,\"%EvalError%\":i,\"%Float32Array%\":\"undefined\"==typeof Float32Array?r:Float32Array,\"%Float64Array%\":\"undefined\"==typeof Float64Array?r:Float64Array,\"%FinalizationRegistry%\":\"undefined\"==typeof FinalizationRegistry?r:FinalizationRegistry,\"%Function%\":f,\"%GeneratorFunction%\":m,\"%Int8Array%\":\"undefined\"==typeof Int8Array?r:Int8Array,\"%Int16Array%\":\"undefined\"==typeof Int16Array?r:Int16Array,\"%Int32Array%\":\"undefined\"==typeof Int32Array?r:Int32Array,\"%isFinite%\":isFinite,\"%isNaN%\":isNaN,\"%IteratorPrototype%\":v&&A?A(A([][Symbol.iterator]())):r,\"%JSON%\":\"object\"==typeof JSON?JSON:r,\"%Map%\":\"undefined\"==typeof Map?r:Map,\"%MapIteratorPrototype%\":\"undefined\"!=typeof Map&&v&&A?A((new Map)[Symbol.iterator]()):r,\"%Math%\":Math,\"%Number%\":Number,\"%Object%\":Object,\"%parseFloat%\":parseFloat,\"%parseInt%\":parseInt,\"%Promise%\":\"undefined\"==typeof Promise?r:Promise,\"%Proxy%\":\"undefined\"==typeof Proxy?r:Proxy,\"%RangeError%\":a,\"%ReferenceError%\":l,\"%Reflect%\":\"undefined\"==typeof Reflect?r:Reflect,\"%RegExp%\":RegExp,\"%Set%\":\"undefined\"==typeof Set?r:Set,\"%SetIteratorPrototype%\":\"undefined\"!=typeof Set&&v&&A?A((new Set)[Symbol.iterator]()):r,\"%SharedArrayBuffer%\":\"undefined\"==typeof SharedArrayBuffer?r:SharedArrayBuffer,\"%String%\":String,\"%StringIteratorPrototype%\":v&&A?A(\"\"[Symbol.iterator]()):r,\"%Symbol%\":v?Symbol:r,\"%SyntaxError%\":c,\"%ThrowTypeError%\":h,\"%TypedArray%\":y,\"%TypeError%\":u,\"%Uint8Array%\":\"undefined\"==typeof Uint8Array?r:Uint8Array,\"%Uint8ClampedArray%\":\"undefined\"==typeof Uint8ClampedArray?r:Uint8ClampedArray,\"%Uint16Array%\":\"undefined\"==typeof Uint16Array?r:Uint16Array,\"%Uint32Array%\":\"undefined\"==typeof Uint32Array?r:Uint32Array,\"%URIError%\":s,\"%WeakMap%\":\"undefined\"==typeof WeakMap?r:WeakMap,\"%WeakRef%\":\"undefined\"==typeof WeakRef?r:WeakRef,\"%WeakSet%\":\"undefined\"==typeof WeakSet?r:WeakSet};if(A)try{null.error}catch(e){var C=A(A(e));E[\"%Error.prototype%\"]=C}var w=function e(n){var t;if(\"%AsyncFunction%\"===n)t=p(\"async function () {}\");else if(\"%GeneratorFunction%\"===n)t=p(\"function* () {}\");else if(\"%AsyncGeneratorFunction%\"===n)t=p(\"async function* () {}\");else if(\"%AsyncGenerator%\"===n){var r=e(\"%AsyncGeneratorFunction%\");r&&(t=r.prototype)}else if(\"%AsyncIteratorPrototype%\"===n){var o=e(\"%AsyncGenerator%\");o&&A&&(t=A(o.prototype))}return E[n]=t,t},_={__proto__:null,\"%ArrayBufferPrototype%\":[\"ArrayBuffer\",\"prototype\"],\"%ArrayPrototype%\":[\"Array\",\"prototype\"],\"%ArrayProto_entries%\":[\"Array\",\"prototype\",\"entries\"],\"%ArrayProto_forEach%\":[\"Array\",\"prototype\",\"forEach\"],\"%ArrayProto_keys%\":[\"Array\",\"prototype\",\"keys\"],\"%ArrayProto_values%\":[\"Array\",\"prototype\",\"values\"],\"%AsyncFunctionPrototype%\":[\"AsyncFunction\",\"prototype\"],\"%AsyncGenerator%\":[\"AsyncGeneratorFunction\",\"prototype\"],\"%AsyncGeneratorPrototype%\":[\"AsyncGeneratorFunction\",\"prototype\",\"prototype\"],\"%BooleanPrototype%\":[\"Boolean\",\"prototype\"],\"%DataViewPrototype%\":[\"DataView\",\"prototype\"],\"%DatePrototype%\":[\"Date\",\"prototype\"],\"%ErrorPrototype%\":[\"Error\",\"prototype\"],\"%EvalErrorPrototype%\":[\"EvalError\",\"prototype\"],\"%Float32ArrayPrototype%\":[\"Float32Array\",\"prototype\"],\"%Float64ArrayPrototype%\":[\"Float64Array\",\"prototype\"],\"%FunctionPrototype%\":[\"Function\",\"prototype\"],\"%Generator%\":[\"GeneratorFunction\",\"prototype\"],\"%GeneratorPrototype%\":[\"GeneratorFunction\",\"prototype\",\"prototype\"],\"%Int8ArrayPrototype%\":[\"Int8Array\",\"prototype\"],\"%Int16ArrayPrototype%\":[\"Int16Array\",\"prototype\"],\"%Int32ArrayPrototype%\":[\"Int32Array\",\"prototype\"],\"%JSONParse%\":[\"JSON\",\"parse\"],\"%JSONStringify%\":[\"JSON\",\"stringify\"],\"%MapPrototype%\":[\"Map\",\"prototype\"],\"%NumberPrototype%\":[\"Number\",\"prototype\"],\"%ObjectPrototype%\":[\"Object\",\"prototype\"],\"%ObjProto_toString%\":[\"Object\",\"prototype\",\"toString\"],\"%ObjProto_valueOf%\":[\"Object\",\"prototype\",\"valueOf\"],\"%PromisePrototype%\":[\"Promise\",\"prototype\"],\"%PromiseProto_then%\":[\"Promise\",\"prototype\",\"then\"],\"%Promise_all%\":[\"Promise\",\"all\"],\"%Promise_reject%\":[\"Promise\",\"reject\"],\"%Promise_resolve%\":[\"Promise\",\"resolve\"],\"%RangeErrorPrototype%\":[\"RangeError\",\"prototype\"],\"%ReferenceErrorPrototype%\":[\"ReferenceError\",\"prototype\"],\"%RegExpPrototype%\":[\"RegExp\",\"prototype\"],\"%SetPrototype%\":[\"Set\",\"prototype\"],\"%SharedArrayBufferPrototype%\":[\"SharedArrayBuffer\",\"prototype\"],\"%StringPrototype%\":[\"String\",\"prototype\"],\"%SymbolPrototype%\":[\"Symbol\",\"prototype\"],\"%SyntaxErrorPrototype%\":[\"SyntaxError\",\"prototype\"],\"%TypedArrayPrototype%\":[\"TypedArray\",\"prototype\"],\"%TypeErrorPrototype%\":[\"TypeError\",\"prototype\"],\"%Uint8ArrayPrototype%\":[\"Uint8Array\",\"prototype\"],\"%Uint8ClampedArrayPrototype%\":[\"Uint8ClampedArray\",\"prototype\"],\"%Uint16ArrayPrototype%\":[\"Uint16Array\",\"prototype\"],\"%Uint32ArrayPrototype%\":[\"Uint32Array\",\"prototype\"],\"%URIErrorPrototype%\":[\"URIError\",\"prototype\"],\"%WeakMapPrototype%\":[\"WeakMap\",\"prototype\"],\"%WeakSetPrototype%\":[\"WeakSet\",\"prototype\"]},x=t(6743),S=t(9957),k=x.call(Function.call,Array.prototype.concat),O=x.call(Function.apply,Array.prototype.splice),B=x.call(Function.call,String.prototype.replace),T=x.call(Function.call,String.prototype.slice),P=x.call(Function.call,RegExp.prototype.exec),I=/[^%.[\\]]+|\\[(?:(-?\\d+(?:\\.\\d+)?)|([\"'])((?:(?!\\2)[^\\\\]|\\\\.)*?)\\2)\\]|(?=(?:\\.|\\[\\])(?:\\.|\\[\\]|%$))/g,j=/\\\\(\\\\)?/g,z=function(e,n){var t,r=e;if(S(_,r)&&(r=\"%\"+(t=_[r])[0]+\"%\"),S(E,r)){var o=E[r];if(o===m&&(o=w(r)),void 0===o&&!n)throw new u(\"intrinsic \"+e+\" exists, but is not available. Please file an issue!\");return{alias:t,name:r,value:o}}throw new c(\"intrinsic \"+e+\" does not exist!\")};e.exports=function(e,n){if(\"string\"!=typeof e||0===e.length)throw new u(\"intrinsic name must be a non-empty string\");if(arguments.length>1&&\"boolean\"!=typeof n)throw new u('\"allowMissing\" argument must be a boolean');if(null===P(/^%?[^%]*%?$/,e))throw new c(\"`%` may not be present anywhere but at the beginning and end of the intrinsic name\");var t=function(e){var n=T(e,0,1),t=T(e,-1);if(\"%\"===n&&\"%\"!==t)throw new c(\"invalid intrinsic syntax, expected closing `%`\");if(\"%\"===t&&\"%\"!==n)throw new c(\"invalid intrinsic syntax, expected opening `%`\");var r=[];return B(e,I,(function(e,n,t,o){r[r.length]=t?B(o,j,\"$1\"):n||e})),r}(e),r=t.length>0?t[0]:\"\",o=z(\"%\"+r+\"%\",n),i=o.name,a=o.value,l=!1,s=o.alias;s&&(r=s[0],O(t,k([0,1],s)));for(var f=1,p=!0;f=t.length){var b=d(a,g);a=(p=!!b)&&\"get\"in b&&!(\"originalValue\"in b.get)?b.get:a[g]}else p=S(a,g),a=a[g];p&&!l&&(E[i]=a)}}return a}},5795:(e,n,t)=>{\"use strict\";var r=t(453)(\"%Object.getOwnPropertyDescriptor%\",!0);if(r)try{r([],\"length\")}catch(e){r=null}e.exports=r},9790:e=>{\"use strict\";var n=\"undefined\"!=typeof BigInt&&BigInt;e.exports=function(){return\"function\"==typeof n&&\"function\"==typeof BigInt&&\"bigint\"==typeof n(42)&&\"bigint\"==typeof BigInt(42)}},592:(e,n,t)=>{\"use strict\";var r=t(3036),o=function(){return!!r};o.hasArrayLengthDefineBug=function(){if(!r)return null;try{return 1!==r([],\"length\",{value:1}).length}catch(e){return!0}},e.exports=o},24:e=>{\"use strict\";var n={__proto__:null,foo:{}},t=Object;e.exports=function(){return{__proto__:n}.foo===n.foo&&!(n instanceof t)}},4039:(e,n,t)=>{\"use strict\";var r=\"undefined\"!=typeof Symbol&&Symbol,o=t(1333);e.exports=function(){return\"function\"==typeof r&&(\"function\"==typeof Symbol&&(\"symbol\"==typeof r(\"foo\")&&(\"symbol\"==typeof Symbol(\"bar\")&&o())))}},1333:e=>{\"use strict\";e.exports=function(){if(\"function\"!=typeof Symbol||\"function\"!=typeof Object.getOwnPropertySymbols)return!1;if(\"symbol\"==typeof Symbol.iterator)return!0;var e={},n=Symbol(\"test\"),t=Object(n);if(\"string\"==typeof n)return!1;if(\"[object Symbol]\"!==Object.prototype.toString.call(n))return!1;if(\"[object Symbol]\"!==Object.prototype.toString.call(t))return!1;for(n in e[n]=42,e)return!1;if(\"function\"==typeof Object.keys&&0!==Object.keys(e).length)return!1;if(\"function\"==typeof Object.getOwnPropertyNames&&0!==Object.getOwnPropertyNames(e).length)return!1;var r=Object.getOwnPropertySymbols(e);if(1!==r.length||r[0]!==n)return!1;if(!Object.prototype.propertyIsEnumerable.call(e,n))return!1;if(\"function\"==typeof Object.getOwnPropertyDescriptor){var o=Object.getOwnPropertyDescriptor(e,n);if(42!==o.value||!0!==o.enumerable)return!1}return!0}},9092:(e,n,t)=>{\"use strict\";var r=t(1333);e.exports=function(){return r()&&!!Symbol.toStringTag}},9957:(e,n,t)=>{\"use strict\";var r=Function.prototype.call,o=Object.prototype.hasOwnProperty,i=t(6743);e.exports=i.call(r,o)},63:(e,n,t)=>{\"use strict\";var r=t(9957),o=t(920)(),i=t(9675),a={assert:function(e,n){if(!e||\"object\"!=typeof e&&\"function\"!=typeof e)throw new i(\"`O` is not an object\");if(\"string\"!=typeof n)throw new i(\"`slot` must be a string\");if(o.assert(e),!a.has(e,n))throw new i(\"`\"+n+\"` is not present on `O`\")},get:function(e,n){if(!e||\"object\"!=typeof e&&\"function\"!=typeof e)throw new i(\"`O` is not an object\");if(\"string\"!=typeof n)throw new i(\"`slot` must be a string\");var t=o.get(e);return t&&t[\"$\"+n]},has:function(e,n){if(!e||\"object\"!=typeof e&&\"function\"!=typeof e)throw new i(\"`O` is not an object\");if(\"string\"!=typeof n)throw new i(\"`slot` must be a string\");var t=o.get(e);return!!t&&r(t,\"$\"+n)},set:function(e,n,t){if(!e||\"object\"!=typeof e&&\"function\"!=typeof e)throw new i(\"`O` is not an object\");if(\"string\"!=typeof n)throw new i(\"`slot` must be a string\");var r=o.get(e);r||(r={},o.set(e,r)),r[\"$\"+n]=t}};Object.freeze&&Object.freeze(a),e.exports=a},7244:(e,n,t)=>{\"use strict\";var r=t(9092)(),o=t(8075)(\"Object.prototype.toString\"),i=function(e){return!(r&&e&&\"object\"==typeof e&&Symbol.toStringTag in e)&&\"[object Arguments]\"===o(e)},a=function(e){return!!i(e)||null!==e&&\"object\"==typeof e&&\"number\"==typeof e.length&&e.length>=0&&\"[object Array]\"!==o(e)&&\"[object Function]\"===o(e.callee)},l=function(){return i(arguments)}();i.isLegacyArguments=a,e.exports=l?i:a},4670:(e,n,t)=>{\"use strict\";var r=t(487),o=t(8075),i=t(453)(\"%ArrayBuffer%\",!0),a=o(\"ArrayBuffer.prototype.byteLength\",!0),l=o(\"Object.prototype.toString\"),c=!!i&&!a&&new i(0).slice,u=!!c&&r(c);e.exports=a||u?function(e){if(!e||\"object\"!=typeof e)return!1;try{return a?a(e):u(e,0),!0}catch(e){return!1}}:i?function(e){return\"[object ArrayBuffer]\"===l(e)}:function(e){return!1}},9803:(e,n,t)=>{\"use strict\";if(t(9790)()){var r=BigInt.prototype.valueOf;e.exports=function(e){return null!=e&&\"boolean\"!=typeof e&&\"string\"!=typeof e&&\"number\"!=typeof e&&\"symbol\"!=typeof e&&\"function\"!=typeof e&&(\"bigint\"==typeof e||function(e){try{return r.call(e),!0}catch(e){}return!1}(e))}}else e.exports=function(e){return!1}},5128:(e,n,t)=>{\"use strict\";var r=t(8075),o=r(\"Boolean.prototype.toString\"),i=r(\"Object.prototype.toString\"),a=t(9092)();e.exports=function(e){return\"boolean\"==typeof e||null!==e&&\"object\"==typeof e&&(a&&Symbol.toStringTag in e?function(e){try{return o(e),!0}catch(e){return!1}}(e):\"[object Boolean]\"===i(e))}},9600:e=>{\"use strict\";var n,t,r=Function.prototype.toString,o=\"object\"==typeof Reflect&&null!==Reflect&&Reflect.apply;if(\"function\"==typeof o&&\"function\"==typeof Object.defineProperty)try{n=Object.defineProperty({},\"length\",{get:function(){throw t}}),t={},o((function(){throw 42}),null,n)}catch(e){e!==t&&(o=null)}else o=null;var i=/^\\s*class\\b/,a=function(e){try{var n=r.call(e);return i.test(n)}catch(e){return!1}},l=function(e){try{return!a(e)&&(r.call(e),!0)}catch(e){return!1}},c=Object.prototype.toString,u=\"function\"==typeof Symbol&&!!Symbol.toStringTag,s=!(0 in[,]),f=function(){return!1};if(\"object\"==typeof document){var p=document.all;c.call(p)===c.call(document.all)&&(f=function(e){if((s||!e)&&(void 0===e||\"object\"==typeof e))try{var n=c.call(e);return(\"[object HTMLAllCollection]\"===n||\"[object HTML document.all class]\"===n||\"[object HTMLCollection]\"===n||\"[object Object]\"===n)&&null==e(\"\")}catch(e){}return!1})}e.exports=o?function(e){if(f(e))return!0;if(!e)return!1;if(\"function\"!=typeof e&&\"object\"!=typeof e)return!1;try{o(e,null,n)}catch(e){if(e!==t)return!1}return!a(e)&&l(e)}:function(e){if(f(e))return!0;if(!e)return!1;if(\"function\"!=typeof e&&\"object\"!=typeof e)return!1;if(u)return l(e);if(a(e))return!1;var n=c.call(e);return!(\"[object Function]\"!==n&&\"[object GeneratorFunction]\"!==n&&!/^\\[object HTML/.test(n))&&l(e)}},2120:(e,n,t)=>{\"use strict\";var r=Date.prototype.getDay,o=Object.prototype.toString,i=t(9092)();e.exports=function(e){return\"object\"==typeof e&&null!==e&&(i?function(e){try{return r.call(e),!0}catch(e){return!1}}(e):\"[object Date]\"===o.call(e))}},1421:e=>{\"use strict\";var n,t=\"function\"==typeof Map&&Map.prototype?Map:null,r=\"function\"==typeof Set&&Set.prototype?Set:null;t||(n=function(e){return!1});var o=t?Map.prototype.has:null,i=r?Set.prototype.has:null;n||o||(n=function(e){return!1}),e.exports=n||function(e){if(!e||\"object\"!=typeof e)return!1;try{if(o.call(e),i)try{i.call(e)}catch(e){return!0}return e instanceof t}catch(e){}return!1}},1703:(e,n,t)=>{\"use strict\";var r=Number.prototype.toString,o=Object.prototype.toString,i=t(9092)();e.exports=function(e){return\"number\"==typeof e||\"object\"==typeof e&&(i?function(e){try{return r.call(e),!0}catch(e){return!1}}(e):\"[object Number]\"===o.call(e))}},4035:(e,n,t)=>{\"use strict\";var r,o,i,a,l=t(8075),c=t(9092)();if(c){r=l(\"Object.prototype.hasOwnProperty\"),o=l(\"RegExp.prototype.exec\"),i={};var u=function(){throw i};a={toString:u,valueOf:u},\"symbol\"==typeof Symbol.toPrimitive&&(a[Symbol.toPrimitive]=u)}var s=l(\"Object.prototype.toString\"),f=Object.getOwnPropertyDescriptor;e.exports=c?function(e){if(!e||\"object\"!=typeof e)return!1;var n=f(e,\"lastIndex\");if(!(n&&r(n,\"value\")))return!1;try{o(e,a)}catch(e){return e===i}}:function(e){return!(!e||\"object\"!=typeof e&&\"function\"!=typeof e)&&\"[object RegExp]\"===s(e)}},256:e=>{\"use strict\";var n,t=\"function\"==typeof Map&&Map.prototype?Map:null,r=\"function\"==typeof Set&&Set.prototype?Set:null;r||(n=function(e){return!1});var o=t?Map.prototype.has:null,i=r?Set.prototype.has:null;n||i||(n=function(e){return!1}),e.exports=n||function(e){if(!e||\"object\"!=typeof e)return!1;try{if(i.call(e),o)try{o.call(e)}catch(e){return!0}return e instanceof r}catch(e){}return!1}},7070:(e,n,t)=>{\"use strict\";var r=t(8075)(\"SharedArrayBuffer.prototype.byteLength\",!0);e.exports=r?function(e){if(!e||\"object\"!=typeof e)return!1;try{return r(e),!0}catch(e){return!1}}:function(e){return!1}},4761:(e,n,t)=>{\"use strict\";var r=String.prototype.valueOf,o=Object.prototype.toString,i=t(9092)();e.exports=function(e){return\"string\"==typeof e||\"object\"==typeof e&&(i?function(e){try{return r.call(e),!0}catch(e){return!1}}(e):\"[object String]\"===o.call(e))}},3612:(e,n,t)=>{\"use strict\";var r=Object.prototype.toString;if(t(4039)()){var o=Symbol.prototype.toString,i=/^Symbol\\(.*\\)$/;e.exports=function(e){if(\"symbol\"==typeof e)return!0;if(\"[object Symbol]\"!==r.call(e))return!1;try{return function(e){return\"symbol\"==typeof e.valueOf()&&i.test(o.call(e))}(e)}catch(e){return!1}}}else e.exports=function(e){return!1}},7842:e=>{\"use strict\";var n,t=\"function\"==typeof WeakMap&&WeakMap.prototype?WeakMap:null,r=\"function\"==typeof WeakSet&&WeakSet.prototype?WeakSet:null;t||(n=function(e){return!1});var o=t?t.prototype.has:null,i=r?r.prototype.has:null;n||o||(n=function(e){return!1}),e.exports=n||function(e){if(!e||\"object\"!=typeof e)return!1;try{if(o.call(e,o),i)try{i.call(e,i)}catch(e){return!0}return e instanceof t}catch(e){}return!1}},2648:(e,n,t)=>{\"use strict\";var r=t(453),o=t(8075),i=r(\"%WeakSet%\",!0),a=o(\"WeakSet.prototype.has\",!0);if(a){var l=o(\"WeakMap.prototype.has\",!0);e.exports=function(e){if(!e||\"object\"!=typeof e)return!1;try{if(a(e,a),l)try{l(e,l)}catch(e){return!0}return e instanceof i}catch(e){}return!1}}else e.exports=function(e){return!1}},4634:e=>{var n={}.toString;e.exports=Array.isArray||function(e){return\"[object Array]\"==n.call(e)}},2543:function(e,n,t){var r;\n/**\n * @license\n * Lodash \n * Copyright OpenJS Foundation and other contributors \n * Released under MIT license \n * Based on Underscore.js 1.8.3 \n * Copyright Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors\n */e=t.nmd(e),function(){var o,i=\"Expected a function\",a=\"__lodash_hash_undefined__\",l=\"__lodash_placeholder__\",c=16,u=32,s=64,f=128,p=256,d=1/0,g=9007199254740991,h=NaN,v=4294967295,b=[[\"ary\",f],[\"bind\",1],[\"bindKey\",2],[\"curry\",8],[\"curryRight\",c],[\"flip\",512],[\"partial\",u],[\"partialRight\",s],[\"rearg\",p]],A=\"[object Arguments]\",m=\"[object Array]\",y=\"[object Boolean]\",E=\"[object Date]\",C=\"[object Error]\",w=\"[object Function]\",_=\"[object GeneratorFunction]\",x=\"[object Map]\",S=\"[object Number]\",k=\"[object Object]\",O=\"[object Promise]\",B=\"[object RegExp]\",T=\"[object Set]\",P=\"[object String]\",I=\"[object Symbol]\",j=\"[object WeakMap]\",z=\"[object ArrayBuffer]\",D=\"[object DataView]\",R=\"[object Float32Array]\",M=\"[object Float64Array]\",N=\"[object Int8Array]\",F=\"[object Int16Array]\",L=\"[object Int32Array]\",U=\"[object Uint8Array]\",H=\"[object Uint8ClampedArray]\",W=\"[object Uint16Array]\",G=\"[object Uint32Array]\",Y=/\\b__p \\+= '';/g,q=/\\b(__p \\+=) '' \\+/g,V=/(__e\\(.*?\\)|\\b__t\\)) \\+\\n'';/g,$=/&(?:amp|lt|gt|quot|#39);/g,K=/[&<>\"']/g,Q=RegExp($.source),X=RegExp(K.source),Z=/<%-([\\s\\S]+?)%>/g,J=/<%([\\s\\S]+?)%>/g,ee=/<%=([\\s\\S]+?)%>/g,ne=/\\.|\\[(?:[^[\\]]*|([\"'])(?:(?!\\1)[^\\\\]|\\\\.)*?\\1)\\]/,te=/^\\w*$/,re=/[^.[\\]]+|\\[(?:(-?\\d+(?:\\.\\d+)?)|([\"'])((?:(?!\\2)[^\\\\]|\\\\.)*?)\\2)\\]|(?=(?:\\.|\\[\\])(?:\\.|\\[\\]|$))/g,oe=/[\\\\^$.*+?()[\\]{}|]/g,ie=RegExp(oe.source),ae=/^\\s+/,le=/\\s/,ce=/\\{(?:\\n\\/\\* \\[wrapped with .+\\] \\*\\/)?\\n?/,ue=/\\{\\n\\/\\* \\[wrapped with (.+)\\] \\*/,se=/,? & /,fe=/[^\\x00-\\x2f\\x3a-\\x40\\x5b-\\x60\\x7b-\\x7f]+/g,pe=/[()=,{}\\[\\]\\/\\s]/,de=/\\\\(\\\\)?/g,ge=/\\$\\{([^\\\\}]*(?:\\\\.[^\\\\}]*)*)\\}/g,he=/\\w*$/,ve=/^[-+]0x[0-9a-f]+$/i,be=/^0b[01]+$/i,Ae=/^\\[object .+?Constructor\\]$/,me=/^0o[0-7]+$/i,ye=/^(?:0|[1-9]\\d*)$/,Ee=/[\\xc0-\\xd6\\xd8-\\xf6\\xf8-\\xff\\u0100-\\u017f]/g,Ce=/($^)/,we=/['\\n\\r\\u2028\\u2029\\\\]/g,_e=\"\\\\ud800-\\\\udfff\",xe=\"\\\\u0300-\\\\u036f\\\\ufe20-\\\\ufe2f\\\\u20d0-\\\\u20ff\",Se=\"\\\\u2700-\\\\u27bf\",ke=\"a-z\\\\xdf-\\\\xf6\\\\xf8-\\\\xff\",Oe=\"A-Z\\\\xc0-\\\\xd6\\\\xd8-\\\\xde\",Be=\"\\\\ufe0e\\\\ufe0f\",Te=\"\\\\xac\\\\xb1\\\\xd7\\\\xf7\\\\x00-\\\\x2f\\\\x3a-\\\\x40\\\\x5b-\\\\x60\\\\x7b-\\\\xbf\\\\u2000-\\\\u206f \\\\t\\\\x0b\\\\f\\\\xa0\\\\ufeff\\\\n\\\\r\\\\u2028\\\\u2029\\\\u1680\\\\u180e\\\\u2000\\\\u2001\\\\u2002\\\\u2003\\\\u2004\\\\u2005\\\\u2006\\\\u2007\\\\u2008\\\\u2009\\\\u200a\\\\u202f\\\\u205f\\\\u3000\",Pe=\"['’]\",Ie=\"[\"+_e+\"]\",je=\"[\"+Te+\"]\",ze=\"[\"+xe+\"]\",De=\"\\\\d+\",Re=\"[\"+Se+\"]\",Me=\"[\"+ke+\"]\",Ne=\"[^\"+_e+Te+De+Se+ke+Oe+\"]\",Fe=\"\\\\ud83c[\\\\udffb-\\\\udfff]\",Le=\"[^\"+_e+\"]\",Ue=\"(?:\\\\ud83c[\\\\udde6-\\\\uddff]){2}\",He=\"[\\\\ud800-\\\\udbff][\\\\udc00-\\\\udfff]\",We=\"[\"+Oe+\"]\",Ge=\"\\\\u200d\",Ye=\"(?:\"+Me+\"|\"+Ne+\")\",qe=\"(?:\"+We+\"|\"+Ne+\")\",Ve=\"(?:['’](?:d|ll|m|re|s|t|ve))?\",$e=\"(?:['’](?:D|LL|M|RE|S|T|VE))?\",Ke=\"(?:\"+ze+\"|\"+Fe+\")\"+\"?\",Qe=\"[\"+Be+\"]?\",Xe=Qe+Ke+(\"(?:\"+Ge+\"(?:\"+[Le,Ue,He].join(\"|\")+\")\"+Qe+Ke+\")*\"),Ze=\"(?:\"+[Re,Ue,He].join(\"|\")+\")\"+Xe,Je=\"(?:\"+[Le+ze+\"?\",ze,Ue,He,Ie].join(\"|\")+\")\",en=RegExp(Pe,\"g\"),nn=RegExp(ze,\"g\"),tn=RegExp(Fe+\"(?=\"+Fe+\")|\"+Je+Xe,\"g\"),rn=RegExp([We+\"?\"+Me+\"+\"+Ve+\"(?=\"+[je,We,\"$\"].join(\"|\")+\")\",qe+\"+\"+$e+\"(?=\"+[je,We+Ye,\"$\"].join(\"|\")+\")\",We+\"?\"+Ye+\"+\"+Ve,We+\"+\"+$e,\"\\\\d*(?:1ST|2ND|3RD|(?![123])\\\\dTH)(?=\\\\b|[a-z_])\",\"\\\\d*(?:1st|2nd|3rd|(?![123])\\\\dth)(?=\\\\b|[A-Z_])\",De,Ze].join(\"|\"),\"g\"),on=RegExp(\"[\"+Ge+_e+xe+Be+\"]\"),an=/[a-z][A-Z]|[A-Z]{2}[a-z]|[0-9][a-zA-Z]|[a-zA-Z][0-9]|[^a-zA-Z0-9 ]/,ln=[\"Array\",\"Buffer\",\"DataView\",\"Date\",\"Error\",\"Float32Array\",\"Float64Array\",\"Function\",\"Int8Array\",\"Int16Array\",\"Int32Array\",\"Map\",\"Math\",\"Object\",\"Promise\",\"RegExp\",\"Set\",\"String\",\"Symbol\",\"TypeError\",\"Uint8Array\",\"Uint8ClampedArray\",\"Uint16Array\",\"Uint32Array\",\"WeakMap\",\"_\",\"clearTimeout\",\"isFinite\",\"parseInt\",\"setTimeout\"],cn=-1,un={};un[R]=un[M]=un[N]=un[F]=un[L]=un[U]=un[H]=un[W]=un[G]=!0,un[A]=un[m]=un[z]=un[y]=un[D]=un[E]=un[C]=un[w]=un[x]=un[S]=un[k]=un[B]=un[T]=un[P]=un[j]=!1;var sn={};sn[A]=sn[m]=sn[z]=sn[D]=sn[y]=sn[E]=sn[R]=sn[M]=sn[N]=sn[F]=sn[L]=sn[x]=sn[S]=sn[k]=sn[B]=sn[T]=sn[P]=sn[I]=sn[U]=sn[H]=sn[W]=sn[G]=!0,sn[C]=sn[w]=sn[j]=!1;var fn={\"\\\\\":\"\\\\\",\"'\":\"'\",\"\\n\":\"n\",\"\\r\":\"r\",\"\\u2028\":\"u2028\",\"\\u2029\":\"u2029\"},pn=parseFloat,dn=parseInt,gn=\"object\"==typeof t.g&&t.g&&t.g.Object===Object&&t.g,hn=\"object\"==typeof self&&self&&self.Object===Object&&self,vn=gn||hn||Function(\"return this\")(),bn=n&&!n.nodeType&&n,An=bn&&e&&!e.nodeType&&e,mn=An&&An.exports===bn,yn=mn&&gn.process,En=function(){try{var e=An&&An.require&&An.require(\"util\").types;return e||yn&&yn.binding&&yn.binding(\"util\")}catch(e){}}(),Cn=En&&En.isArrayBuffer,wn=En&&En.isDate,_n=En&&En.isMap,xn=En&&En.isRegExp,Sn=En&&En.isSet,kn=En&&En.isTypedArray;function On(e,n,t){switch(t.length){case 0:return e.call(n);case 1:return e.call(n,t[0]);case 2:return e.call(n,t[0],t[1]);case 3:return e.call(n,t[0],t[1],t[2])}return e.apply(n,t)}function Bn(e,n,t,r){for(var o=-1,i=null==e?0:e.length;++o-1}function Dn(e,n,t){for(var r=-1,o=null==e?0:e.length;++r-1;);return t}function ot(e,n){for(var t=e.length;t--&&Gn(n,e[t],0)>-1;);return t}var it=Kn({À:\"A\",Á:\"A\",Â:\"A\",Ã:\"A\",Ä:\"A\",Å:\"A\",à:\"a\",á:\"a\",â:\"a\",ã:\"a\",ä:\"a\",å:\"a\",Ç:\"C\",ç:\"c\",Ð:\"D\",ð:\"d\",È:\"E\",É:\"E\",Ê:\"E\",Ë:\"E\",è:\"e\",é:\"e\",ê:\"e\",ë:\"e\",Ì:\"I\",Í:\"I\",Î:\"I\",Ï:\"I\",ì:\"i\",í:\"i\",î:\"i\",ï:\"i\",Ñ:\"N\",ñ:\"n\",Ò:\"O\",Ó:\"O\",Ô:\"O\",Õ:\"O\",Ö:\"O\",Ø:\"O\",ò:\"o\",ó:\"o\",ô:\"o\",õ:\"o\",ö:\"o\",ø:\"o\",Ù:\"U\",Ú:\"U\",Û:\"U\",Ü:\"U\",ù:\"u\",ú:\"u\",û:\"u\",ü:\"u\",Ý:\"Y\",ý:\"y\",ÿ:\"y\",Æ:\"Ae\",æ:\"ae\",Þ:\"Th\",þ:\"th\",ß:\"ss\",Ā:\"A\",Ă:\"A\",Ą:\"A\",ā:\"a\",ă:\"a\",ą:\"a\",Ć:\"C\",Ĉ:\"C\",Ċ:\"C\",Č:\"C\",ć:\"c\",ĉ:\"c\",ċ:\"c\",č:\"c\",Ď:\"D\",Đ:\"D\",ď:\"d\",đ:\"d\",Ē:\"E\",Ĕ:\"E\",Ė:\"E\",Ę:\"E\",Ě:\"E\",ē:\"e\",ĕ:\"e\",ė:\"e\",ę:\"e\",ě:\"e\",Ĝ:\"G\",Ğ:\"G\",Ġ:\"G\",Ģ:\"G\",ĝ:\"g\",ğ:\"g\",ġ:\"g\",ģ:\"g\",Ĥ:\"H\",Ħ:\"H\",ĥ:\"h\",ħ:\"h\",Ĩ:\"I\",Ī:\"I\",Ĭ:\"I\",Į:\"I\",İ:\"I\",ĩ:\"i\",ī:\"i\",ĭ:\"i\",į:\"i\",ı:\"i\",Ĵ:\"J\",ĵ:\"j\",Ķ:\"K\",ķ:\"k\",ĸ:\"k\",Ĺ:\"L\",Ļ:\"L\",Ľ:\"L\",Ŀ:\"L\",Ł:\"L\",ĺ:\"l\",ļ:\"l\",ľ:\"l\",ŀ:\"l\",ł:\"l\",Ń:\"N\",Ņ:\"N\",Ň:\"N\",Ŋ:\"N\",ń:\"n\",ņ:\"n\",ň:\"n\",ŋ:\"n\",Ō:\"O\",Ŏ:\"O\",Ő:\"O\",ō:\"o\",ŏ:\"o\",ő:\"o\",Ŕ:\"R\",Ŗ:\"R\",Ř:\"R\",ŕ:\"r\",ŗ:\"r\",ř:\"r\",Ś:\"S\",Ŝ:\"S\",Ş:\"S\",Š:\"S\",ś:\"s\",ŝ:\"s\",ş:\"s\",š:\"s\",Ţ:\"T\",Ť:\"T\",Ŧ:\"T\",ţ:\"t\",ť:\"t\",ŧ:\"t\",Ũ:\"U\",Ū:\"U\",Ŭ:\"U\",Ů:\"U\",Ű:\"U\",Ų:\"U\",ũ:\"u\",ū:\"u\",ŭ:\"u\",ů:\"u\",ű:\"u\",ų:\"u\",Ŵ:\"W\",ŵ:\"w\",Ŷ:\"Y\",ŷ:\"y\",Ÿ:\"Y\",Ź:\"Z\",Ż:\"Z\",Ž:\"Z\",ź:\"z\",ż:\"z\",ž:\"z\",IJ:\"IJ\",ij:\"ij\",Œ:\"Oe\",œ:\"oe\",ʼn:\"'n\",ſ:\"s\"}),at=Kn({\"&\":\"&\",\"<\":\"<\",\">\":\">\",'\"':\""\",\"'\":\"'\"});function lt(e){return\"\\\\\"+fn[e]}function ct(e){return on.test(e)}function ut(e){var n=-1,t=Array(e.size);return e.forEach((function(e,r){t[++n]=[r,e]})),t}function st(e,n){return function(t){return e(n(t))}}function ft(e,n){for(var t=-1,r=e.length,o=0,i=[];++t\",\""\":'\"',\"'\":\"'\"});var At=function e(n){var t,r=(n=null==n?vn:At.defaults(vn.Object(),n,At.pick(vn,ln))).Array,le=n.Date,_e=n.Error,xe=n.Function,Se=n.Math,ke=n.Object,Oe=n.RegExp,Be=n.String,Te=n.TypeError,Pe=r.prototype,Ie=xe.prototype,je=ke.prototype,ze=n[\"__core-js_shared__\"],De=Ie.toString,Re=je.hasOwnProperty,Me=0,Ne=(t=/[^.]+$/.exec(ze&&ze.keys&&ze.keys.IE_PROTO||\"\"))?\"Symbol(src)_1.\"+t:\"\",Fe=je.toString,Le=De.call(ke),Ue=vn._,He=Oe(\"^\"+De.call(Re).replace(oe,\"\\\\$&\").replace(/hasOwnProperty|(function).*?(?=\\\\\\()| for .+?(?=\\\\\\])/g,\"$1.*?\")+\"$\"),We=mn?n.Buffer:o,Ge=n.Symbol,Ye=n.Uint8Array,qe=We?We.allocUnsafe:o,Ve=st(ke.getPrototypeOf,ke),$e=ke.create,Ke=je.propertyIsEnumerable,Qe=Pe.splice,Xe=Ge?Ge.isConcatSpreadable:o,Ze=Ge?Ge.iterator:o,Je=Ge?Ge.toStringTag:o,tn=function(){try{var e=di(ke,\"defineProperty\");return e({},\"\",{}),e}catch(e){}}(),on=n.clearTimeout!==vn.clearTimeout&&n.clearTimeout,fn=le&&le.now!==vn.Date.now&&le.now,gn=n.setTimeout!==vn.setTimeout&&n.setTimeout,hn=Se.ceil,bn=Se.floor,An=ke.getOwnPropertySymbols,yn=We?We.isBuffer:o,En=n.isFinite,Un=Pe.join,Kn=st(ke.keys,ke),mt=Se.max,yt=Se.min,Et=le.now,Ct=n.parseInt,wt=Se.random,_t=Pe.reverse,xt=di(n,\"DataView\"),St=di(n,\"Map\"),kt=di(n,\"Promise\"),Ot=di(n,\"Set\"),Bt=di(n,\"WeakMap\"),Tt=di(ke,\"create\"),Pt=Bt&&new Bt,It={},jt=Fi(xt),zt=Fi(St),Dt=Fi(kt),Rt=Fi(Ot),Mt=Fi(Bt),Nt=Ge?Ge.prototype:o,Ft=Nt?Nt.valueOf:o,Lt=Nt?Nt.toString:o;function Ut(e){if(tl(e)&&!Ya(e)&&!(e instanceof Yt)){if(e instanceof Gt)return e;if(Re.call(e,\"__wrapped__\"))return Li(e)}return new Gt(e)}var Ht=function(){function e(){}return function(n){if(!nl(n))return{};if($e)return $e(n);e.prototype=n;var t=new e;return e.prototype=o,t}}();function Wt(){}function Gt(e,n){this.__wrapped__=e,this.__actions__=[],this.__chain__=!!n,this.__index__=0,this.__values__=o}function Yt(e){this.__wrapped__=e,this.__actions__=[],this.__dir__=1,this.__filtered__=!1,this.__iteratees__=[],this.__takeCount__=v,this.__views__=[]}function qt(e){var n=-1,t=null==e?0:e.length;for(this.clear();++n=n?e:n)),e}function ur(e,n,t,r,i,a){var l,c=1&n,u=2&n,s=4&n;if(t&&(l=i?t(e,r,i,a):t(e)),l!==o)return l;if(!nl(e))return e;var f=Ya(e);if(f){if(l=function(e){var n=e.length,t=new e.constructor(n);n&&\"string\"==typeof e[0]&&Re.call(e,\"index\")&&(t.index=e.index,t.input=e.input);return t}(e),!c)return Po(e,l)}else{var p=vi(e),d=p==w||p==_;if(Ka(e))return xo(e,c);if(p==k||p==A||d&&!i){if(l=u||d?{}:Ai(e),!c)return u?function(e,n){return Io(e,hi(e),n)}(e,function(e,n){return e&&Io(n,jl(n),e)}(l,e)):function(e,n){return Io(e,gi(e),n)}(e,ir(l,e))}else{if(!sn[p])return i?e:{};l=function(e,n,t){var r=e.constructor;switch(n){case z:return So(e);case y:case E:return new r(+e);case D:return function(e,n){var t=n?So(e.buffer):e.buffer;return new e.constructor(t,e.byteOffset,e.byteLength)}(e,t);case R:case M:case N:case F:case L:case U:case H:case W:case G:return ko(e,t);case x:return new r;case S:case P:return new r(e);case B:return function(e){var n=new e.constructor(e.source,he.exec(e));return n.lastIndex=e.lastIndex,n}(e);case T:return new r;case I:return o=e,Ft?ke(Ft.call(o)):{}}var o}(e,p,c)}}a||(a=new Qt);var g=a.get(e);if(g)return g;a.set(e,l),ll(e)?e.forEach((function(r){l.add(ur(r,n,t,r,e,a))})):rl(e)&&e.forEach((function(r,o){l.set(o,ur(r,n,t,o,e,a))}));var h=f?o:(s?u?ai:ii:u?jl:Il)(e);return Tn(h||e,(function(r,o){h&&(r=e[o=r]),tr(l,o,ur(r,n,t,o,e,a))})),l}function sr(e,n,t){var r=t.length;if(null==e)return!r;for(e=ke(e);r--;){var i=t[r],a=n[i],l=e[i];if(l===o&&!(i in e)||!a(l))return!1}return!0}function fr(e,n,t){if(\"function\"!=typeof e)throw new Te(i);return Ii((function(){e.apply(o,t)}),n)}function pr(e,n,t,r){var o=-1,i=zn,a=!0,l=e.length,c=[],u=n.length;if(!l)return c;t&&(n=Rn(n,et(t))),r?(i=Dn,a=!1):n.length>=200&&(i=tt,a=!1,n=new Kt(n));e:for(;++o-1},Vt.prototype.set=function(e,n){var t=this.__data__,r=rr(t,e);return r<0?(++this.size,t.push([e,n])):t[r][1]=n,this},$t.prototype.clear=function(){this.size=0,this.__data__={hash:new qt,map:new(St||Vt),string:new qt}},$t.prototype.delete=function(e){var n=fi(this,e).delete(e);return this.size-=n?1:0,n},$t.prototype.get=function(e){return fi(this,e).get(e)},$t.prototype.has=function(e){return fi(this,e).has(e)},$t.prototype.set=function(e,n){var t=fi(this,e),r=t.size;return t.set(e,n),this.size+=t.size==r?0:1,this},Kt.prototype.add=Kt.prototype.push=function(e){return this.__data__.set(e,a),this},Kt.prototype.has=function(e){return this.__data__.has(e)},Qt.prototype.clear=function(){this.__data__=new Vt,this.size=0},Qt.prototype.delete=function(e){var n=this.__data__,t=n.delete(e);return this.size=n.size,t},Qt.prototype.get=function(e){return this.__data__.get(e)},Qt.prototype.has=function(e){return this.__data__.has(e)},Qt.prototype.set=function(e,n){var t=this.__data__;if(t instanceof Vt){var r=t.__data__;if(!St||r.length<199)return r.push([e,n]),this.size=++t.size,this;t=this.__data__=new $t(r)}return t.set(e,n),this.size=t.size,this};var dr=Do(Er),gr=Do(Cr,!0);function hr(e,n){var t=!0;return dr(e,(function(e,r,o){return t=!!n(e,r,o)})),t}function vr(e,n,t){for(var r=-1,i=e.length;++r0&&t(l)?n>1?Ar(l,n-1,t,r,o):Mn(o,l):r||(o[o.length]=l)}return o}var mr=Ro(),yr=Ro(!0);function Er(e,n){return e&&mr(e,n,Il)}function Cr(e,n){return e&&yr(e,n,Il)}function wr(e,n){return jn(n,(function(n){return Za(e[n])}))}function _r(e,n){for(var t=0,r=(n=Eo(n,e)).length;null!=e&&tn}function Or(e,n){return null!=e&&Re.call(e,n)}function Br(e,n){return null!=e&&n in ke(e)}function Tr(e,n,t){for(var i=t?Dn:zn,a=e[0].length,l=e.length,c=l,u=r(l),s=1/0,f=[];c--;){var p=e[c];c&&n&&(p=Rn(p,et(n))),s=yt(p.length,s),u[c]=!t&&(n||a>=120&&p.length>=120)?new Kt(c&&p):o}p=e[0];var d=-1,g=u[0];e:for(;++d=l?c:c*(\"desc\"==t[r]?-1:1)}return e.index-n.index}(e,n,t)}))}function qr(e,n,t){for(var r=-1,o=n.length,i={};++r-1;)l!==e&&Qe.call(l,c,1),Qe.call(e,c,1);return e}function $r(e,n){for(var t=e?n.length:0,r=t-1;t--;){var o=n[t];if(t==r||o!==i){var i=o;yi(o)?Qe.call(e,o,1):po(e,o)}}return e}function Kr(e,n){return e+bn(wt()*(n-e+1))}function Qr(e,n){var t=\"\";if(!e||n<1||n>g)return t;do{n%2&&(t+=e),(n=bn(n/2))&&(e+=e)}while(n);return t}function Xr(e,n){return ji(Oi(e,n,oc),e+\"\")}function Zr(e){return Zt(Ul(e))}function Jr(e,n){var t=Ul(e);return Ri(t,cr(n,0,t.length))}function eo(e,n,t,r){if(!nl(e))return e;for(var i=-1,a=(n=Eo(n,e)).length,l=a-1,c=e;null!=c&&++ii?0:i+n),(t=t>i?i:t)<0&&(t+=i),i=n>t?0:t-n>>>0,n>>>=0;for(var a=r(i);++o>>1,a=e[i];null!==a&&!ul(a)&&(t?a<=n:a=200){var u=n?null:Xo(e);if(u)return pt(u);a=!1,o=tt,c=new Kt}else c=n?[]:l;e:for(;++r=r?e:oo(e,n,t)}var _o=on||function(e){return vn.clearTimeout(e)};function xo(e,n){if(n)return e.slice();var t=e.length,r=qe?qe(t):new e.constructor(t);return e.copy(r),r}function So(e){var n=new e.constructor(e.byteLength);return new Ye(n).set(new Ye(e)),n}function ko(e,n){var t=n?So(e.buffer):e.buffer;return new e.constructor(t,e.byteOffset,e.length)}function Oo(e,n){if(e!==n){var t=e!==o,r=null===e,i=e==e,a=ul(e),l=n!==o,c=null===n,u=n==n,s=ul(n);if(!c&&!s&&!a&&e>n||a&&l&&u&&!c&&!s||r&&l&&u||!t&&u||!i)return 1;if(!r&&!a&&!s&&e1?t[i-1]:o,l=i>2?t[2]:o;for(a=e.length>3&&\"function\"==typeof a?(i--,a):o,l&&Ei(t[0],t[1],l)&&(a=i<3?o:a,i=1),n=ke(n);++r-1?i[a?n[l]:l]:o}}function Uo(e){return oi((function(n){var t=n.length,r=t,a=Gt.prototype.thru;for(e&&n.reverse();r--;){var l=n[r];if(\"function\"!=typeof l)throw new Te(i);if(a&&!c&&\"wrapper\"==ci(l))var c=new Gt([],!0)}for(r=c?r:t;++r1&&y.reverse(),d&&sc))return!1;var s=a.get(e),f=a.get(n);if(s&&f)return s==n&&f==e;var p=-1,d=!0,g=2&t?new Kt:o;for(a.set(e,n),a.set(n,e);++p-1&&e%1==0&&e1?\"& \":\"\")+n[r],n=n.join(t>2?\", \":\" \"),e.replace(ce,\"{\\n/* [wrapped with \"+n+\"] */\\n\")}(r,function(e,n){return Tn(b,(function(t){var r=\"_.\"+t[0];n&t[1]&&!zn(e,r)&&e.push(r)})),e.sort()}(function(e){var n=e.match(ue);return n?n[1].split(se):[]}(r),t)))}function Di(e){var n=0,t=0;return function(){var r=Et(),i=16-(r-t);if(t=r,i>0){if(++n>=800)return arguments[0]}else n=0;return e.apply(o,arguments)}}function Ri(e,n){var t=-1,r=e.length,i=r-1;for(n=n===o?r:n;++t1?e[n-1]:o;return t=\"function\"==typeof t?(e.pop(),t):o,aa(e,t)}));function da(e){var n=Ut(e);return n.__chain__=!0,n}function ga(e,n){return n(e)}var ha=oi((function(e){var n=e.length,t=n?e[0]:0,r=this.__wrapped__,i=function(n){return lr(n,e)};return!(n>1||this.__actions__.length)&&r instanceof Yt&&yi(t)?((r=r.slice(t,+t+(n?1:0))).__actions__.push({func:ga,args:[i],thisArg:o}),new Gt(r,this.__chain__).thru((function(e){return n&&!e.length&&e.push(o),e}))):this.thru(i)}));var va=jo((function(e,n,t){Re.call(e,t)?++e[t]:ar(e,t,1)}));var ba=Lo(Gi),Aa=Lo(Yi);function ma(e,n){return(Ya(e)?Tn:dr)(e,si(n,3))}function ya(e,n){return(Ya(e)?Pn:gr)(e,si(n,3))}var Ea=jo((function(e,n,t){Re.call(e,t)?e[t].push(n):ar(e,t,[n])}));var Ca=Xr((function(e,n,t){var o=-1,i=\"function\"==typeof n,a=Va(e)?r(e.length):[];return dr(e,(function(e){a[++o]=i?On(n,e,t):Pr(e,n,t)})),a})),wa=jo((function(e,n,t){ar(e,t,n)}));function _a(e,n){return(Ya(e)?Rn:Lr)(e,si(n,3))}var xa=jo((function(e,n,t){e[t?0:1].push(n)}),(function(){return[[],[]]}));var Sa=Xr((function(e,n){if(null==e)return[];var t=n.length;return t>1&&Ei(e,n[0],n[1])?n=[]:t>2&&Ei(n[0],n[1],n[2])&&(n=[n[0]]),Yr(e,Ar(n,1),[])})),ka=fn||function(){return vn.Date.now()};function Oa(e,n,t){return n=t?o:n,n=e&&null==n?e.length:n,Jo(e,f,o,o,o,o,n)}function Ba(e,n){var t;if(\"function\"!=typeof n)throw new Te(i);return e=hl(e),function(){return--e>0&&(t=n.apply(this,arguments)),e<=1&&(n=o),t}}var Ta=Xr((function(e,n,t){var r=1;if(t.length){var o=ft(t,ui(Ta));r|=u}return Jo(e,r,n,t,o)})),Pa=Xr((function(e,n,t){var r=3;if(t.length){var o=ft(t,ui(Pa));r|=u}return Jo(n,r,e,t,o)}));function Ia(e,n,t){var r,a,l,c,u,s,f=0,p=!1,d=!1,g=!0;if(\"function\"!=typeof e)throw new Te(i);function h(n){var t=r,i=a;return r=a=o,f=n,c=e.apply(i,t)}function v(e){var t=e-s;return s===o||t>=n||t<0||d&&e-f>=l}function b(){var e=ka();if(v(e))return A(e);u=Ii(b,function(e){var t=n-(e-s);return d?yt(t,l-(e-f)):t}(e))}function A(e){return u=o,g&&r?h(e):(r=a=o,c)}function m(){var e=ka(),t=v(e);if(r=arguments,a=this,s=e,t){if(u===o)return function(e){return f=e,u=Ii(b,n),p?h(e):c}(s);if(d)return _o(u),u=Ii(b,n),h(s)}return u===o&&(u=Ii(b,n)),c}return n=bl(n)||0,nl(t)&&(p=!!t.leading,l=(d=\"maxWait\"in t)?mt(bl(t.maxWait)||0,n):l,g=\"trailing\"in t?!!t.trailing:g),m.cancel=function(){u!==o&&_o(u),f=0,r=s=a=u=o},m.flush=function(){return u===o?c:A(ka())},m}var ja=Xr((function(e,n){return fr(e,1,n)})),za=Xr((function(e,n,t){return fr(e,bl(n)||0,t)}));function Da(e,n){if(\"function\"!=typeof e||null!=n&&\"function\"!=typeof n)throw new Te(i);var t=function(){var r=arguments,o=n?n.apply(this,r):r[0],i=t.cache;if(i.has(o))return i.get(o);var a=e.apply(this,r);return t.cache=i.set(o,a)||i,a};return t.cache=new(Da.Cache||$t),t}function Ra(e){if(\"function\"!=typeof e)throw new Te(i);return function(){var n=arguments;switch(n.length){case 0:return!e.call(this);case 1:return!e.call(this,n[0]);case 2:return!e.call(this,n[0],n[1]);case 3:return!e.call(this,n[0],n[1],n[2])}return!e.apply(this,n)}}Da.Cache=$t;var Ma=Co((function(e,n){var t=(n=1==n.length&&Ya(n[0])?Rn(n[0],et(si())):Rn(Ar(n,1),et(si()))).length;return Xr((function(r){for(var o=-1,i=yt(r.length,t);++o=n})),Ga=Ir(function(){return arguments}())?Ir:function(e){return tl(e)&&Re.call(e,\"callee\")&&!Ke.call(e,\"callee\")},Ya=r.isArray,qa=Cn?et(Cn):function(e){return tl(e)&&Sr(e)==z};function Va(e){return null!=e&&el(e.length)&&!Za(e)}function $a(e){return tl(e)&&Va(e)}var Ka=yn||bc,Qa=wn?et(wn):function(e){return tl(e)&&Sr(e)==E};function Xa(e){if(!tl(e))return!1;var n=Sr(e);return n==C||\"[object DOMException]\"==n||\"string\"==typeof e.message&&\"string\"==typeof e.name&&!il(e)}function Za(e){if(!nl(e))return!1;var n=Sr(e);return n==w||n==_||\"[object AsyncFunction]\"==n||\"[object Proxy]\"==n}function Ja(e){return\"number\"==typeof e&&e==hl(e)}function el(e){return\"number\"==typeof e&&e>-1&&e%1==0&&e<=g}function nl(e){var n=typeof e;return null!=e&&(\"object\"==n||\"function\"==n)}function tl(e){return null!=e&&\"object\"==typeof e}var rl=_n?et(_n):function(e){return tl(e)&&vi(e)==x};function ol(e){return\"number\"==typeof e||tl(e)&&Sr(e)==S}function il(e){if(!tl(e)||Sr(e)!=k)return!1;var n=Ve(e);if(null===n)return!0;var t=Re.call(n,\"constructor\")&&n.constructor;return\"function\"==typeof t&&t instanceof t&&De.call(t)==Le}var al=xn?et(xn):function(e){return tl(e)&&Sr(e)==B};var ll=Sn?et(Sn):function(e){return tl(e)&&vi(e)==T};function cl(e){return\"string\"==typeof e||!Ya(e)&&tl(e)&&Sr(e)==P}function ul(e){return\"symbol\"==typeof e||tl(e)&&Sr(e)==I}var sl=kn?et(kn):function(e){return tl(e)&&el(e.length)&&!!un[Sr(e)]};var fl=$o(Fr),pl=$o((function(e,n){return e<=n}));function dl(e){if(!e)return[];if(Va(e))return cl(e)?ht(e):Po(e);if(Ze&&e[Ze])return function(e){for(var n,t=[];!(n=e.next()).done;)t.push(n.value);return t}(e[Ze]());var n=vi(e);return(n==x?ut:n==T?pt:Ul)(e)}function gl(e){return e?(e=bl(e))===d||e===-1/0?17976931348623157e292*(e<0?-1:1):e==e?e:0:0===e?e:0}function hl(e){var n=gl(e),t=n%1;return n==n?t?n-t:n:0}function vl(e){return e?cr(hl(e),0,v):0}function bl(e){if(\"number\"==typeof e)return e;if(ul(e))return h;if(nl(e)){var n=\"function\"==typeof e.valueOf?e.valueOf():e;e=nl(n)?n+\"\":n}if(\"string\"!=typeof e)return 0===e?e:+e;e=Jn(e);var t=be.test(e);return t||me.test(e)?dn(e.slice(2),t?2:8):ve.test(e)?h:+e}function Al(e){return Io(e,jl(e))}function ml(e){return null==e?\"\":so(e)}var yl=zo((function(e,n){if(xi(n)||Va(n))Io(n,Il(n),e);else for(var t in n)Re.call(n,t)&&tr(e,t,n[t])})),El=zo((function(e,n){Io(n,jl(n),e)})),Cl=zo((function(e,n,t,r){Io(n,jl(n),e,r)})),wl=zo((function(e,n,t,r){Io(n,Il(n),e,r)})),_l=oi(lr);var xl=Xr((function(e,n){e=ke(e);var t=-1,r=n.length,i=r>2?n[2]:o;for(i&&Ei(n[0],n[1],i)&&(r=1);++t1),n})),Io(e,ai(e),t),r&&(t=ur(t,7,ti));for(var o=n.length;o--;)po(t,n[o]);return t}));var Ml=oi((function(e,n){return null==e?{}:function(e,n){return qr(e,n,(function(n,t){return Ol(e,t)}))}(e,n)}));function Nl(e,n){if(null==e)return{};var t=Rn(ai(e),(function(e){return[e]}));return n=si(n),qr(e,t,(function(e,t){return n(e,t[0])}))}var Fl=Zo(Il),Ll=Zo(jl);function Ul(e){return null==e?[]:nt(e,Il(e))}var Hl=No((function(e,n,t){return n=n.toLowerCase(),e+(t?Wl(n):n)}));function Wl(e){return Xl(ml(e).toLowerCase())}function Gl(e){return(e=ml(e))&&e.replace(Ee,it).replace(nn,\"\")}var Yl=No((function(e,n,t){return e+(t?\"-\":\"\")+n.toLowerCase()})),ql=No((function(e,n,t){return e+(t?\" \":\"\")+n.toLowerCase()})),Vl=Mo(\"toLowerCase\");var $l=No((function(e,n,t){return e+(t?\"_\":\"\")+n.toLowerCase()}));var Kl=No((function(e,n,t){return e+(t?\" \":\"\")+Xl(n)}));var Ql=No((function(e,n,t){return e+(t?\" \":\"\")+n.toUpperCase()})),Xl=Mo(\"toUpperCase\");function Zl(e,n,t){return e=ml(e),(n=t?o:n)===o?function(e){return an.test(e)}(e)?function(e){return e.match(rn)||[]}(e):function(e){return e.match(fe)||[]}(e):e.match(n)||[]}var Jl=Xr((function(e,n){try{return On(e,o,n)}catch(e){return Xa(e)?e:new _e(e)}})),ec=oi((function(e,n){return Tn(n,(function(n){n=Ni(n),ar(e,n,Ta(e[n],e))})),e}));function nc(e){return function(){return e}}var tc=Uo(),rc=Uo(!0);function oc(e){return e}function ic(e){return Rr(\"function\"==typeof e?e:ur(e,1))}var ac=Xr((function(e,n){return function(t){return Pr(t,e,n)}})),lc=Xr((function(e,n){return function(t){return Pr(e,t,n)}}));function cc(e,n,t){var r=Il(n),o=wr(n,r);null!=t||nl(n)&&(o.length||!r.length)||(t=n,n=e,e=this,o=wr(n,Il(n)));var i=!(nl(t)&&\"chain\"in t&&!t.chain),a=Za(e);return Tn(o,(function(t){var r=n[t];e[t]=r,a&&(e.prototype[t]=function(){var n=this.__chain__;if(i||n){var t=e(this.__wrapped__);return(t.__actions__=Po(this.__actions__)).push({func:r,args:arguments,thisArg:e}),t.__chain__=n,t}return r.apply(e,Mn([this.value()],arguments))})})),e}function uc(){}var sc=Yo(Rn),fc=Yo(In),pc=Yo(Ln);function dc(e){return Ci(e)?$n(Ni(e)):function(e){return function(n){return _r(n,e)}}(e)}var gc=Vo(),hc=Vo(!0);function vc(){return[]}function bc(){return!1}var Ac=Go((function(e,n){return e+n}),0),mc=Qo(\"ceil\"),yc=Go((function(e,n){return e/n}),1),Ec=Qo(\"floor\");var Cc,wc=Go((function(e,n){return e*n}),1),_c=Qo(\"round\"),xc=Go((function(e,n){return e-n}),0);return Ut.after=function(e,n){if(\"function\"!=typeof n)throw new Te(i);return e=hl(e),function(){if(--e<1)return n.apply(this,arguments)}},Ut.ary=Oa,Ut.assign=yl,Ut.assignIn=El,Ut.assignInWith=Cl,Ut.assignWith=wl,Ut.at=_l,Ut.before=Ba,Ut.bind=Ta,Ut.bindAll=ec,Ut.bindKey=Pa,Ut.castArray=function(){if(!arguments.length)return[];var e=arguments[0];return Ya(e)?e:[e]},Ut.chain=da,Ut.chunk=function(e,n,t){n=(t?Ei(e,n,t):n===o)?1:mt(hl(n),0);var i=null==e?0:e.length;if(!i||n<1)return[];for(var a=0,l=0,c=r(hn(i/n));ai?0:i+t),(r=r===o||r>i?i:hl(r))<0&&(r+=i),r=t>r?0:vl(r);t>>0)?(e=ml(e))&&(\"string\"==typeof n||null!=n&&!al(n))&&!(n=so(n))&&ct(e)?wo(ht(e),0,t):e.split(n,t):[]},Ut.spread=function(e,n){if(\"function\"!=typeof e)throw new Te(i);return n=null==n?0:mt(hl(n),0),Xr((function(t){var r=t[n],o=wo(t,0,n);return r&&Mn(o,r),On(e,this,o)}))},Ut.tail=function(e){var n=null==e?0:e.length;return n?oo(e,1,n):[]},Ut.take=function(e,n,t){return e&&e.length?oo(e,0,(n=t||n===o?1:hl(n))<0?0:n):[]},Ut.takeRight=function(e,n,t){var r=null==e?0:e.length;return r?oo(e,(n=r-(n=t||n===o?1:hl(n)))<0?0:n,r):[]},Ut.takeRightWhile=function(e,n){return e&&e.length?ho(e,si(n,3),!1,!0):[]},Ut.takeWhile=function(e,n){return e&&e.length?ho(e,si(n,3)):[]},Ut.tap=function(e,n){return n(e),e},Ut.throttle=function(e,n,t){var r=!0,o=!0;if(\"function\"!=typeof e)throw new Te(i);return nl(t)&&(r=\"leading\"in t?!!t.leading:r,o=\"trailing\"in t?!!t.trailing:o),Ia(e,n,{leading:r,maxWait:n,trailing:o})},Ut.thru=ga,Ut.toArray=dl,Ut.toPairs=Fl,Ut.toPairsIn=Ll,Ut.toPath=function(e){return Ya(e)?Rn(e,Ni):ul(e)?[e]:Po(Mi(ml(e)))},Ut.toPlainObject=Al,Ut.transform=function(e,n,t){var r=Ya(e),o=r||Ka(e)||sl(e);if(n=si(n,4),null==t){var i=e&&e.constructor;t=o?r?new i:[]:nl(e)&&Za(i)?Ht(Ve(e)):{}}return(o?Tn:Er)(e,(function(e,r,o){return n(t,e,r,o)})),t},Ut.unary=function(e){return Oa(e,1)},Ut.union=ta,Ut.unionBy=ra,Ut.unionWith=oa,Ut.uniq=function(e){return e&&e.length?fo(e):[]},Ut.uniqBy=function(e,n){return e&&e.length?fo(e,si(n,2)):[]},Ut.uniqWith=function(e,n){return n=\"function\"==typeof n?n:o,e&&e.length?fo(e,o,n):[]},Ut.unset=function(e,n){return null==e||po(e,n)},Ut.unzip=ia,Ut.unzipWith=aa,Ut.update=function(e,n,t){return null==e?e:go(e,n,yo(t))},Ut.updateWith=function(e,n,t,r){return r=\"function\"==typeof r?r:o,null==e?e:go(e,n,yo(t),r)},Ut.values=Ul,Ut.valuesIn=function(e){return null==e?[]:nt(e,jl(e))},Ut.without=la,Ut.words=Zl,Ut.wrap=function(e,n){return Na(yo(n),e)},Ut.xor=ca,Ut.xorBy=ua,Ut.xorWith=sa,Ut.zip=fa,Ut.zipObject=function(e,n){return Ao(e||[],n||[],tr)},Ut.zipObjectDeep=function(e,n){return Ao(e||[],n||[],eo)},Ut.zipWith=pa,Ut.entries=Fl,Ut.entriesIn=Ll,Ut.extend=El,Ut.extendWith=Cl,cc(Ut,Ut),Ut.add=Ac,Ut.attempt=Jl,Ut.camelCase=Hl,Ut.capitalize=Wl,Ut.ceil=mc,Ut.clamp=function(e,n,t){return t===o&&(t=n,n=o),t!==o&&(t=(t=bl(t))==t?t:0),n!==o&&(n=(n=bl(n))==n?n:0),cr(bl(e),n,t)},Ut.clone=function(e){return ur(e,4)},Ut.cloneDeep=function(e){return ur(e,5)},Ut.cloneDeepWith=function(e,n){return ur(e,5,n=\"function\"==typeof n?n:o)},Ut.cloneWith=function(e,n){return ur(e,4,n=\"function\"==typeof n?n:o)},Ut.conformsTo=function(e,n){return null==n||sr(e,n,Il(n))},Ut.deburr=Gl,Ut.defaultTo=function(e,n){return null==e||e!=e?n:e},Ut.divide=yc,Ut.endsWith=function(e,n,t){e=ml(e),n=so(n);var r=e.length,i=t=t===o?r:cr(hl(t),0,r);return(t-=n.length)>=0&&e.slice(t,i)==n},Ut.eq=Ua,Ut.escape=function(e){return(e=ml(e))&&X.test(e)?e.replace(K,at):e},Ut.escapeRegExp=function(e){return(e=ml(e))&&ie.test(e)?e.replace(oe,\"\\\\$&\"):e},Ut.every=function(e,n,t){var r=Ya(e)?In:hr;return t&&Ei(e,n,t)&&(n=o),r(e,si(n,3))},Ut.find=ba,Ut.findIndex=Gi,Ut.findKey=function(e,n){return Hn(e,si(n,3),Er)},Ut.findLast=Aa,Ut.findLastIndex=Yi,Ut.findLastKey=function(e,n){return Hn(e,si(n,3),Cr)},Ut.floor=Ec,Ut.forEach=ma,Ut.forEachRight=ya,Ut.forIn=function(e,n){return null==e?e:mr(e,si(n,3),jl)},Ut.forInRight=function(e,n){return null==e?e:yr(e,si(n,3),jl)},Ut.forOwn=function(e,n){return e&&Er(e,si(n,3))},Ut.forOwnRight=function(e,n){return e&&Cr(e,si(n,3))},Ut.get=kl,Ut.gt=Ha,Ut.gte=Wa,Ut.has=function(e,n){return null!=e&&bi(e,n,Or)},Ut.hasIn=Ol,Ut.head=Vi,Ut.identity=oc,Ut.includes=function(e,n,t,r){e=Va(e)?e:Ul(e),t=t&&!r?hl(t):0;var o=e.length;return t<0&&(t=mt(o+t,0)),cl(e)?t<=o&&e.indexOf(n,t)>-1:!!o&&Gn(e,n,t)>-1},Ut.indexOf=function(e,n,t){var r=null==e?0:e.length;if(!r)return-1;var o=null==t?0:hl(t);return o<0&&(o=mt(r+o,0)),Gn(e,n,o)},Ut.inRange=function(e,n,t){return n=gl(n),t===o?(t=n,n=0):t=gl(t),function(e,n,t){return e>=yt(n,t)&&e=-9007199254740991&&e<=g},Ut.isSet=ll,Ut.isString=cl,Ut.isSymbol=ul,Ut.isTypedArray=sl,Ut.isUndefined=function(e){return e===o},Ut.isWeakMap=function(e){return tl(e)&&vi(e)==j},Ut.isWeakSet=function(e){return tl(e)&&\"[object WeakSet]\"==Sr(e)},Ut.join=function(e,n){return null==e?\"\":Un.call(e,n)},Ut.kebabCase=Yl,Ut.last=Xi,Ut.lastIndexOf=function(e,n,t){var r=null==e?0:e.length;if(!r)return-1;var i=r;return t!==o&&(i=(i=hl(t))<0?mt(r+i,0):yt(i,r-1)),n==n?function(e,n,t){for(var r=t+1;r--;)if(e[r]===n)return r;return r}(e,n,i):Wn(e,qn,i,!0)},Ut.lowerCase=ql,Ut.lowerFirst=Vl,Ut.lt=fl,Ut.lte=pl,Ut.max=function(e){return e&&e.length?vr(e,oc,kr):o},Ut.maxBy=function(e,n){return e&&e.length?vr(e,si(n,2),kr):o},Ut.mean=function(e){return Vn(e,oc)},Ut.meanBy=function(e,n){return Vn(e,si(n,2))},Ut.min=function(e){return e&&e.length?vr(e,oc,Fr):o},Ut.minBy=function(e,n){return e&&e.length?vr(e,si(n,2),Fr):o},Ut.stubArray=vc,Ut.stubFalse=bc,Ut.stubObject=function(){return{}},Ut.stubString=function(){return\"\"},Ut.stubTrue=function(){return!0},Ut.multiply=wc,Ut.nth=function(e,n){return e&&e.length?Gr(e,hl(n)):o},Ut.noConflict=function(){return vn._===this&&(vn._=Ue),this},Ut.noop=uc,Ut.now=ka,Ut.pad=function(e,n,t){e=ml(e);var r=(n=hl(n))?gt(e):0;if(!n||r>=n)return e;var o=(n-r)/2;return qo(bn(o),t)+e+qo(hn(o),t)},Ut.padEnd=function(e,n,t){e=ml(e);var r=(n=hl(n))?gt(e):0;return n&&rn){var r=e;e=n,n=r}if(t||e%1||n%1){var i=wt();return yt(e+i*(n-e+pn(\"1e-\"+((i+\"\").length-1))),n)}return Kr(e,n)},Ut.reduce=function(e,n,t){var r=Ya(e)?Nn:Qn,o=arguments.length<3;return r(e,si(n,4),t,o,dr)},Ut.reduceRight=function(e,n,t){var r=Ya(e)?Fn:Qn,o=arguments.length<3;return r(e,si(n,4),t,o,gr)},Ut.repeat=function(e,n,t){return n=(t?Ei(e,n,t):n===o)?1:hl(n),Qr(ml(e),n)},Ut.replace=function(){var e=arguments,n=ml(e[0]);return e.length<3?n:n.replace(e[1],e[2])},Ut.result=function(e,n,t){var r=-1,i=(n=Eo(n,e)).length;for(i||(i=1,e=o);++rg)return[];var t=v,r=yt(e,v);n=si(n),e-=v;for(var o=Zn(r,n);++t=a)return e;var c=t-gt(r);if(c<1)return r;var u=l?wo(l,0,c).join(\"\"):e.slice(0,c);if(i===o)return u+r;if(l&&(c+=u.length-c),al(i)){if(e.slice(c).search(i)){var s,f=u;for(i.global||(i=Oe(i.source,ml(he.exec(i))+\"g\")),i.lastIndex=0;s=i.exec(f);)var p=s.index;u=u.slice(0,p===o?c:p)}}else if(e.indexOf(so(i),c)!=c){var d=u.lastIndexOf(i);d>-1&&(u=u.slice(0,d))}return u+r},Ut.unescape=function(e){return(e=ml(e))&&Q.test(e)?e.replace($,bt):e},Ut.uniqueId=function(e){var n=++Me;return ml(e)+n},Ut.upperCase=Ql,Ut.upperFirst=Xl,Ut.each=ma,Ut.eachRight=ya,Ut.first=Vi,cc(Ut,(Cc={},Er(Ut,(function(e,n){Re.call(Ut.prototype,n)||(Cc[n]=e)})),Cc),{chain:!1}),Ut.VERSION=\"4.17.21\",Tn([\"bind\",\"bindKey\",\"curry\",\"curryRight\",\"partial\",\"partialRight\"],(function(e){Ut[e].placeholder=Ut})),Tn([\"drop\",\"take\"],(function(e,n){Yt.prototype[e]=function(t){t=t===o?1:mt(hl(t),0);var r=this.__filtered__&&!n?new Yt(this):this.clone();return r.__filtered__?r.__takeCount__=yt(t,r.__takeCount__):r.__views__.push({size:yt(t,v),type:e+(r.__dir__<0?\"Right\":\"\")}),r},Yt.prototype[e+\"Right\"]=function(n){return this.reverse()[e](n).reverse()}})),Tn([\"filter\",\"map\",\"takeWhile\"],(function(e,n){var t=n+1,r=1==t||3==t;Yt.prototype[e]=function(e){var n=this.clone();return n.__iteratees__.push({iteratee:si(e,3),type:t}),n.__filtered__=n.__filtered__||r,n}})),Tn([\"head\",\"last\"],(function(e,n){var t=\"take\"+(n?\"Right\":\"\");Yt.prototype[e]=function(){return this[t](1).value()[0]}})),Tn([\"initial\",\"tail\"],(function(e,n){var t=\"drop\"+(n?\"\":\"Right\");Yt.prototype[e]=function(){return this.__filtered__?new Yt(this):this[t](1)}})),Yt.prototype.compact=function(){return this.filter(oc)},Yt.prototype.find=function(e){return this.filter(e).head()},Yt.prototype.findLast=function(e){return this.reverse().find(e)},Yt.prototype.invokeMap=Xr((function(e,n){return\"function\"==typeof e?new Yt(this):this.map((function(t){return Pr(t,e,n)}))})),Yt.prototype.reject=function(e){return this.filter(Ra(si(e)))},Yt.prototype.slice=function(e,n){e=hl(e);var t=this;return t.__filtered__&&(e>0||n<0)?new Yt(t):(e<0?t=t.takeRight(-e):e&&(t=t.drop(e)),n!==o&&(t=(n=hl(n))<0?t.dropRight(-n):t.take(n-e)),t)},Yt.prototype.takeRightWhile=function(e){return this.reverse().takeWhile(e).reverse()},Yt.prototype.toArray=function(){return this.take(v)},Er(Yt.prototype,(function(e,n){var t=/^(?:filter|find|map|reject)|While$/.test(n),r=/^(?:head|last)$/.test(n),i=Ut[r?\"take\"+(\"last\"==n?\"Right\":\"\"):n],a=r||/^find/.test(n);i&&(Ut.prototype[n]=function(){var n=this.__wrapped__,l=r?[1]:arguments,c=n instanceof Yt,u=l[0],s=c||Ya(n),f=function(e){var n=i.apply(Ut,Mn([e],l));return r&&p?n[0]:n};s&&t&&\"function\"==typeof u&&1!=u.length&&(c=s=!1);var p=this.__chain__,d=!!this.__actions__.length,g=a&&!p,h=c&&!d;if(!a&&s){n=h?n:new Yt(this);var v=e.apply(n,l);return v.__actions__.push({func:ga,args:[f],thisArg:o}),new Gt(v,p)}return g&&h?e.apply(this,l):(v=this.thru(f),g?r?v.value()[0]:v.value():v)})})),Tn([\"pop\",\"push\",\"shift\",\"sort\",\"splice\",\"unshift\"],(function(e){var n=Pe[e],t=/^(?:push|sort|unshift)$/.test(e)?\"tap\":\"thru\",r=/^(?:pop|shift)$/.test(e);Ut.prototype[e]=function(){var e=arguments;if(r&&!this.__chain__){var o=this.value();return n.apply(Ya(o)?o:[],e)}return this[t]((function(t){return n.apply(Ya(t)?t:[],e)}))}})),Er(Yt.prototype,(function(e,n){var t=Ut[n];if(t){var r=t.name+\"\";Re.call(It,r)||(It[r]=[]),It[r].push({name:n,func:t})}})),It[Ho(o,2).name]=[{name:\"wrapper\",func:o}],Yt.prototype.clone=function(){var e=new Yt(this.__wrapped__);return e.__actions__=Po(this.__actions__),e.__dir__=this.__dir__,e.__filtered__=this.__filtered__,e.__iteratees__=Po(this.__iteratees__),e.__takeCount__=this.__takeCount__,e.__views__=Po(this.__views__),e},Yt.prototype.reverse=function(){if(this.__filtered__){var e=new Yt(this);e.__dir__=-1,e.__filtered__=!0}else(e=this.clone()).__dir__*=-1;return e},Yt.prototype.value=function(){var e=this.__wrapped__.value(),n=this.__dir__,t=Ya(e),r=n<0,o=t?e.length:0,i=function(e,n,t){var r=-1,o=t.length;for(;++r=this.__values__.length;return{done:e,value:e?o:this.__values__[this.__index__++]}},Ut.prototype.plant=function(e){for(var n,t=this;t instanceof Wt;){var r=Li(t);r.__index__=0,r.__values__=o,n?i.__wrapped__=r:n=r;var i=r;t=t.__wrapped__}return i.__wrapped__=e,n},Ut.prototype.reverse=function(){var e=this.__wrapped__;if(e instanceof Yt){var n=e;return this.__actions__.length&&(n=new Yt(this)),(n=n.reverse()).__actions__.push({func:ga,args:[na],thisArg:o}),new Gt(n,this.__chain__)}return this.thru(na)},Ut.prototype.toJSON=Ut.prototype.valueOf=Ut.prototype.value=function(){return vo(this.__wrapped__,this.__actions__)},Ut.prototype.first=Ut.prototype.head,Ze&&(Ut.prototype[Ze]=function(){return this}),Ut}();vn._=At,(r=function(){return At}.call(n,t,n,e))===o||(e.exports=r)}.call(this)},5228:e=>{\"use strict\";\n/*\nobject-assign\n(c) Sindre Sorhus\n@license MIT\n*/var n=Object.getOwnPropertySymbols,t=Object.prototype.hasOwnProperty,r=Object.prototype.propertyIsEnumerable;e.exports=function(){try{if(!Object.assign)return!1;var e=new String(\"abc\");if(e[5]=\"de\",\"5\"===Object.getOwnPropertyNames(e)[0])return!1;for(var n={},t=0;t<10;t++)n[\"_\"+String.fromCharCode(t)]=t;if(\"0123456789\"!==Object.getOwnPropertyNames(n).map((function(e){return n[e]})).join(\"\"))return!1;var r={};return\"abcdefghijklmnopqrst\".split(\"\").forEach((function(e){r[e]=e})),\"abcdefghijklmnopqrst\"===Object.keys(Object.assign({},r)).join(\"\")}catch(e){return!1}}()?Object.assign:function(e,o){for(var i,a,l=function(e){if(null==e)throw new TypeError(\"Object.assign cannot be called with null or undefined\");return Object(e)}(e),c=1;c{var r=\"function\"==typeof Map&&Map.prototype,o=Object.getOwnPropertyDescriptor&&r?Object.getOwnPropertyDescriptor(Map.prototype,\"size\"):null,i=r&&o&&\"function\"==typeof o.get?o.get:null,a=r&&Map.prototype.forEach,l=\"function\"==typeof Set&&Set.prototype,c=Object.getOwnPropertyDescriptor&&l?Object.getOwnPropertyDescriptor(Set.prototype,\"size\"):null,u=l&&c&&\"function\"==typeof c.get?c.get:null,s=l&&Set.prototype.forEach,f=\"function\"==typeof WeakMap&&WeakMap.prototype?WeakMap.prototype.has:null,p=\"function\"==typeof WeakSet&&WeakSet.prototype?WeakSet.prototype.has:null,d=\"function\"==typeof WeakRef&&WeakRef.prototype?WeakRef.prototype.deref:null,g=Boolean.prototype.valueOf,h=Object.prototype.toString,v=Function.prototype.toString,b=String.prototype.match,A=String.prototype.slice,m=String.prototype.replace,y=String.prototype.toUpperCase,E=String.prototype.toLowerCase,C=RegExp.prototype.test,w=Array.prototype.concat,_=Array.prototype.join,x=Array.prototype.slice,S=Math.floor,k=\"function\"==typeof BigInt?BigInt.prototype.valueOf:null,O=Object.getOwnPropertySymbols,B=\"function\"==typeof Symbol&&\"symbol\"==typeof Symbol.iterator?Symbol.prototype.toString:null,T=\"function\"==typeof Symbol&&\"object\"==typeof Symbol.iterator,P=\"function\"==typeof Symbol&&Symbol.toStringTag&&(typeof Symbol.toStringTag===T||\"symbol\")?Symbol.toStringTag:null,I=Object.prototype.propertyIsEnumerable,j=(\"function\"==typeof Reflect?Reflect.getPrototypeOf:Object.getPrototypeOf)||([].__proto__===Array.prototype?function(e){return e.__proto__}:null);function z(e,n){if(e===1/0||e===-1/0||e!=e||e&&e>-1e3&&e<1e3||C.call(/e/,n))return n;var t=/[0-9](?=(?:[0-9]{3})+(?![0-9]))/g;if(\"number\"==typeof e){var r=e<0?-S(-e):S(e);if(r!==e){var o=String(r),i=A.call(n,o.length+1);return m.call(o,t,\"$&_\")+\".\"+m.call(m.call(i,/([0-9]{3})/g,\"$&_\"),/_$/,\"\")}}return m.call(n,t,\"$&_\")}var D=t(2634),R=D.custom,M=H(R)?R:null;function N(e,n,t){var r=\"double\"===(t.quoteStyle||n)?'\"':\"'\";return r+e+r}function F(e){return m.call(String(e),/\"/g,\""\")}function L(e){return!(\"[object Array]\"!==Y(e)||P&&\"object\"==typeof e&&P in e)}function U(e){return!(\"[object RegExp]\"!==Y(e)||P&&\"object\"==typeof e&&P in e)}function H(e){if(T)return e&&\"object\"==typeof e&&e instanceof Symbol;if(\"symbol\"==typeof e)return!0;if(!e||\"object\"!=typeof e||!B)return!1;try{return B.call(e),!0}catch(e){}return!1}e.exports=function e(n,r,o,l){var c=r||{};if(G(c,\"quoteStyle\")&&\"single\"!==c.quoteStyle&&\"double\"!==c.quoteStyle)throw new TypeError('option \"quoteStyle\" must be \"single\" or \"double\"');if(G(c,\"maxStringLength\")&&(\"number\"==typeof c.maxStringLength?c.maxStringLength<0&&c.maxStringLength!==1/0:null!==c.maxStringLength))throw new TypeError('option \"maxStringLength\", if provided, must be a positive integer, Infinity, or `null`');var h=!G(c,\"customInspect\")||c.customInspect;if(\"boolean\"!=typeof h&&\"symbol\"!==h)throw new TypeError(\"option \\\"customInspect\\\", if provided, must be `true`, `false`, or `'symbol'`\");if(G(c,\"indent\")&&null!==c.indent&&\"\\t\"!==c.indent&&!(parseInt(c.indent,10)===c.indent&&c.indent>0))throw new TypeError('option \"indent\" must be \"\\\\t\", an integer > 0, or `null`');if(G(c,\"numericSeparator\")&&\"boolean\"!=typeof c.numericSeparator)throw new TypeError('option \"numericSeparator\", if provided, must be `true` or `false`');var y=c.numericSeparator;if(void 0===n)return\"undefined\";if(null===n)return\"null\";if(\"boolean\"==typeof n)return n?\"true\":\"false\";if(\"string\"==typeof n)return V(n,c);if(\"number\"==typeof n){if(0===n)return 1/0/n>0?\"0\":\"-0\";var C=String(n);return y?z(n,C):C}if(\"bigint\"==typeof n){var S=String(n)+\"n\";return y?z(n,S):S}var O=void 0===c.depth?5:c.depth;if(void 0===o&&(o=0),o>=O&&O>0&&\"object\"==typeof n)return L(n)?\"[Array]\":\"[Object]\";var R=function(e,n){var t;if(\"\\t\"===e.indent)t=\"\\t\";else{if(!(\"number\"==typeof e.indent&&e.indent>0))return null;t=_.call(Array(e.indent+1),\" \")}return{base:t,prev:_.call(Array(n+1),t)}}(c,o);if(void 0===l)l=[];else if(q(l,n)>=0)return\"[Circular]\";function W(n,t,r){if(t&&(l=x.call(l)).push(t),r){var i={depth:c.depth};return G(c,\"quoteStyle\")&&(i.quoteStyle=c.quoteStyle),e(n,i,o+1,l)}return e(n,c,o+1,l)}if(\"function\"==typeof n&&!U(n)){var $=function(e){if(e.name)return e.name;var n=b.call(v.call(e),/^function\\s*([\\w$]+)/);if(n)return n[1];return null}(n),ee=J(n,W);return\"[Function\"+($?\": \"+$:\" (anonymous)\")+\"]\"+(ee.length>0?\" { \"+_.call(ee,\", \")+\" }\":\"\")}if(H(n)){var ne=T?m.call(String(n),/^(Symbol\\(.*\\))_[^)]*$/,\"$1\"):B.call(n);return\"object\"!=typeof n||T?ne:K(ne)}if(function(e){if(!e||\"object\"!=typeof e)return!1;if(\"undefined\"!=typeof HTMLElement&&e instanceof HTMLElement)return!0;return\"string\"==typeof e.nodeName&&\"function\"==typeof e.getAttribute}(n)){for(var te=\"<\"+E.call(String(n.nodeName)),re=n.attributes||[],oe=0;oe\",n.childNodes&&n.childNodes.length&&(te+=\"...\"),te+=\"\"}if(L(n)){if(0===n.length)return\"[]\";var ie=J(n,W);return R&&!function(e){for(var n=0;n=0)return!1;return!0}(ie)?\"[\"+Z(ie,R)+\"]\":\"[ \"+_.call(ie,\", \")+\" ]\"}if(function(e){return!(\"[object Error]\"!==Y(e)||P&&\"object\"==typeof e&&P in e)}(n)){var ae=J(n,W);return\"cause\"in Error.prototype||!(\"cause\"in n)||I.call(n,\"cause\")?0===ae.length?\"[\"+String(n)+\"]\":\"{ [\"+String(n)+\"] \"+_.call(ae,\", \")+\" }\":\"{ [\"+String(n)+\"] \"+_.call(w.call(\"[cause]: \"+W(n.cause),ae),\", \")+\" }\"}if(\"object\"==typeof n&&h){if(M&&\"function\"==typeof n[M]&&D)return D(n,{depth:O-o});if(\"symbol\"!==h&&\"function\"==typeof n.inspect)return n.inspect()}if(function(e){if(!i||!e||\"object\"!=typeof e)return!1;try{i.call(e);try{u.call(e)}catch(e){return!0}return e instanceof Map}catch(e){}return!1}(n)){var le=[];return a&&a.call(n,(function(e,t){le.push(W(t,n,!0)+\" => \"+W(e,n))})),X(\"Map\",i.call(n),le,R)}if(function(e){if(!u||!e||\"object\"!=typeof e)return!1;try{u.call(e);try{i.call(e)}catch(e){return!0}return e instanceof Set}catch(e){}return!1}(n)){var ce=[];return s&&s.call(n,(function(e){ce.push(W(e,n))})),X(\"Set\",u.call(n),ce,R)}if(function(e){if(!f||!e||\"object\"!=typeof e)return!1;try{f.call(e,f);try{p.call(e,p)}catch(e){return!0}return e instanceof WeakMap}catch(e){}return!1}(n))return Q(\"WeakMap\");if(function(e){if(!p||!e||\"object\"!=typeof e)return!1;try{p.call(e,p);try{f.call(e,f)}catch(e){return!0}return e instanceof WeakSet}catch(e){}return!1}(n))return Q(\"WeakSet\");if(function(e){if(!d||!e||\"object\"!=typeof e)return!1;try{return d.call(e),!0}catch(e){}return!1}(n))return Q(\"WeakRef\");if(function(e){return!(\"[object Number]\"!==Y(e)||P&&\"object\"==typeof e&&P in e)}(n))return K(W(Number(n)));if(function(e){if(!e||\"object\"!=typeof e||!k)return!1;try{return k.call(e),!0}catch(e){}return!1}(n))return K(W(k.call(n)));if(function(e){return!(\"[object Boolean]\"!==Y(e)||P&&\"object\"==typeof e&&P in e)}(n))return K(g.call(n));if(function(e){return!(\"[object String]\"!==Y(e)||P&&\"object\"==typeof e&&P in e)}(n))return K(W(String(n)));if(\"undefined\"!=typeof window&&n===window)return\"{ [object Window] }\";if(\"undefined\"!=typeof globalThis&&n===globalThis||void 0!==t.g&&n===t.g)return\"{ [object globalThis] }\";if(!function(e){return!(\"[object Date]\"!==Y(e)||P&&\"object\"==typeof e&&P in e)}(n)&&!U(n)){var ue=J(n,W),se=j?j(n)===Object.prototype:n instanceof Object||n.constructor===Object,fe=n instanceof Object?\"\":\"null prototype\",pe=!se&&P&&Object(n)===n&&P in n?A.call(Y(n),8,-1):fe?\"Object\":\"\",de=(se||\"function\"!=typeof n.constructor?\"\":n.constructor.name?n.constructor.name+\" \":\"\")+(pe||fe?\"[\"+_.call(w.call([],pe||[],fe||[]),\": \")+\"] \":\"\");return 0===ue.length?de+\"{}\":R?de+\"{\"+Z(ue,R)+\"}\":de+\"{ \"+_.call(ue,\", \")+\" }\"}return String(n)};var W=Object.prototype.hasOwnProperty||function(e){return e in this};function G(e,n){return W.call(e,n)}function Y(e){return h.call(e)}function q(e,n){if(e.indexOf)return e.indexOf(n);for(var t=0,r=e.length;tn.maxStringLength){var t=e.length-n.maxStringLength,r=\"... \"+t+\" more character\"+(t>1?\"s\":\"\");return V(A.call(e,0,n.maxStringLength),n)+r}return N(m.call(m.call(e,/(['\\\\])/g,\"\\\\$1\"),/[\\x00-\\x1f]/g,$),\"single\",n)}function $(e){var n=e.charCodeAt(0),t={8:\"b\",9:\"t\",10:\"n\",12:\"f\",13:\"r\"}[n];return t?\"\\\\\"+t:\"\\\\x\"+(n<16?\"0\":\"\")+y.call(n.toString(16))}function K(e){return\"Object(\"+e+\")\"}function Q(e){return e+\" { ? }\"}function X(e,n,t,r){return e+\" (\"+n+\") {\"+(r?Z(t,r):_.call(t,\", \"))+\"}\"}function Z(e,n){if(0===e.length)return\"\";var t=\"\\n\"+n.prev+n.base;return t+_.call(e,\",\"+t)+\"\\n\"+n.prev}function J(e,n){var t=L(e),r=[];if(t){r.length=e.length;for(var o=0;o{\"use strict\";var n=function(e){return e!=e};e.exports=function(e,t){return 0===e&&0===t?1/e==1/t:e===t||!(!n(e)||!n(t))}},7653:(e,n,t)=>{\"use strict\";var r=t(8452),o=t(487),i=t(9211),a=t(9394),l=t(6576),c=o(a(),Object);r(c,{getPolyfill:a,implementation:i,shim:l}),e.exports=c},9394:(e,n,t)=>{\"use strict\";var r=t(9211);e.exports=function(){return\"function\"==typeof Object.is?Object.is:r}},6576:(e,n,t)=>{\"use strict\";var r=t(9394),o=t(8452);e.exports=function(){var e=r();return o(Object,{is:e},{is:function(){return Object.is!==e}}),e}},8875:(e,n,t)=>{\"use strict\";var r;if(!Object.keys){var o=Object.prototype.hasOwnProperty,i=Object.prototype.toString,a=t(1093),l=Object.prototype.propertyIsEnumerable,c=!l.call({toString:null},\"toString\"),u=l.call((function(){}),\"prototype\"),s=[\"toString\",\"toLocaleString\",\"valueOf\",\"hasOwnProperty\",\"isPrototypeOf\",\"propertyIsEnumerable\",\"constructor\"],f=function(e){var n=e.constructor;return n&&n.prototype===e},p={$applicationCache:!0,$console:!0,$external:!0,$frame:!0,$frameElement:!0,$frames:!0,$innerHeight:!0,$innerWidth:!0,$onmozfullscreenchange:!0,$onmozfullscreenerror:!0,$outerHeight:!0,$outerWidth:!0,$pageXOffset:!0,$pageYOffset:!0,$parent:!0,$scrollLeft:!0,$scrollTop:!0,$scrollX:!0,$scrollY:!0,$self:!0,$webkitIndexedDB:!0,$webkitStorageInfo:!0,$window:!0},d=function(){if(\"undefined\"==typeof window)return!1;for(var e in window)try{if(!p[\"$\"+e]&&o.call(window,e)&&null!==window[e]&&\"object\"==typeof window[e])try{f(window[e])}catch(e){return!0}}catch(e){return!0}return!1}();r=function(e){var n=null!==e&&\"object\"==typeof e,t=\"[object Function]\"===i.call(e),r=a(e),l=n&&\"[object String]\"===i.call(e),p=[];if(!n&&!t&&!r)throw new TypeError(\"Object.keys called on a non-object\");var g=u&&t;if(l&&e.length>0&&!o.call(e,0))for(var h=0;h0)for(var v=0;v{\"use strict\";var r=Array.prototype.slice,o=t(1093),i=Object.keys,a=i?function(e){return i(e)}:t(8875),l=Object.keys;a.shim=function(){if(Object.keys){var e=function(){var e=Object.keys(arguments);return e&&e.length===arguments.length}(1,2);e||(Object.keys=function(e){return o(e)?l(r.call(e)):l(e)})}else Object.keys=a;return Object.keys||a},e.exports=a},1093:e=>{\"use strict\";var n=Object.prototype.toString;e.exports=function(e){var t=n.call(e),r=\"[object Arguments]\"===t;return r||(r=\"[object Array]\"!==t&&null!==e&&\"object\"==typeof e&&\"number\"==typeof e.length&&e.length>=0&&\"[object Function]\"===n.call(e.callee)),r}},8403:(e,n,t)=>{\"use strict\";var r=t(1189),o=t(1333)(),i=t(8075),a=Object,l=i(\"Array.prototype.push\"),c=i(\"Object.prototype.propertyIsEnumerable\"),u=o?Object.getOwnPropertySymbols:null;e.exports=function(e,n){if(null==e)throw new TypeError(\"target must be an object\");var t=a(e);if(1===arguments.length)return t;for(var i=1;i{\"use strict\";var r=t(8452),o=t(487),i=t(8403),a=t(1514),l=t(984),c=o.apply(a()),u=function(e,n){return c(Object,arguments)};r(u,{getPolyfill:a,implementation:i,shim:l}),e.exports=u},1514:(e,n,t)=>{\"use strict\";var r=t(8403);e.exports=function(){return Object.assign?function(){if(!Object.assign)return!1;for(var e=\"abcdefghijklmnopqrst\",n=e.split(\"\"),t={},r=0;r{\"use strict\";var r=t(8452),o=t(1514);e.exports=function(){var e=o();return r(Object,{assign:e},{assign:function(){return Object.assign!==e}}),e}},6578:e=>{\"use strict\";e.exports=[\"Float32Array\",\"Float64Array\",\"Int8Array\",\"Int16Array\",\"Int32Array\",\"Uint8Array\",\"Uint8ClampedArray\",\"Uint16Array\",\"Uint32Array\",\"BigInt64Array\",\"BigUint64Array\"]},2694:(e,n,t)=>{\"use strict\";var r=t(6925);function o(){}function i(){}i.resetWarningCache=o,e.exports=function(){function e(e,n,t,o,i,a){if(a!==r){var l=new Error(\"Calling PropTypes validators directly is not supported by the `prop-types` package. Use PropTypes.checkPropTypes() to call them. Read more at http://fb.me/use-check-prop-types\");throw l.name=\"Invariant Violation\",l}}function n(){return e}e.isRequired=e;var t={array:e,bigint:e,bool:e,func:e,number:e,object:e,string:e,symbol:e,any:e,arrayOf:n,element:e,elementType:e,instanceOf:n,node:e,objectOf:n,oneOf:n,oneOfType:n,shape:n,exact:n,checkPropTypes:i,resetWarningCache:o};return t.PropTypes=t,t}},5556:(e,n,t)=>{e.exports=t(2694)()},6925:e=>{\"use strict\";e.exports=\"SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED\"},2551:(e,n,t)=>{\"use strict\";var r=t(6540),o=t(5228),i=t(9982);\n/** @license React v17.0.2\n * react-dom.production.min.js\n *\n * Copyright (c) Facebook, Inc. and its affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n */function a(e){for(var n=\"https://reactjs.org/docs/error-decoder.html?invariant=\"+e,t=1;t