This is an automated email from the ASF dual-hosted git repository.
reschke pushed a commit to branch 1.22
in repository https://gitbox.apache.org/repos/asf/jackrabbit-oak.git
The following commit(s) were added to refs/heads/1.22 by this push:
new 167d35845b OAK-8863: Include documentation for BinaryUploadOptions
167d35845b is described below
commit 167d35845b37a1c183fe272ae18682684ac308f4
Author: Matt Ryan <[email protected]>
AuthorDate: Thu Jan 16 22:05:38 2020 +0000
OAK-8863: Include documentation for BinaryUploadOptions
git-svn-id: https://svn.apache.org/repos/asf/jackrabbit/oak/trunk@1872896
13f79535-47bb-0310-9956-ffa450edef68
---
.../src/site/markdown/features/direct-binary-access.md | 17 +++++++++++++++--
1 file changed, 15 insertions(+), 2 deletions(-)
diff --git a/oak-doc/src/site/markdown/features/direct-binary-access.md
b/oak-doc/src/site/markdown/features/direct-binary-access.md
index b66106ecdc..b96179124b 100644
--- a/oak-doc/src/site/markdown/features/direct-binary-access.md
+++ b/oak-doc/src/site/markdown/features/direct-binary-access.md
@@ -278,6 +278,19 @@ For example, suppose you have a service running in the
cloud and this service wi
To specify this behavior for signed download URIs, the client requesting the
URI should specify to ignore the domain override when building the
`BinaryDownloadOptions`:
```
-BinaryDownloadOptions.BinaryDownloadOptionsBuilder builder =
BinaryDownloadOptions.builder()
- .withDomainOverrideIgnored(true);
+BinaryDownloadOptions options = BinaryDownloadOptions.builder()
+ .withDomainOverrideIgnored(true)
+ .build();
```
+
+Default behavior is to use the domain override if one is configured.
+
+To ignore any configured domain override for signed upload URIs, the client
requesting the URI should specify to ignore the domain override via the
optional `BinaryUploadOptions` parameter:
+
+```
+BinaryUploadOptions options = BinaryUploadOptions.builder()
+ .withDomainOverrideIgnored(true)
+ .build();
+```
+
+Default behavior is to use the domain override if one is configured. Note
that providing a `BinaryUploadOptions` to
`JackrabbitValueFactory.initiateBinaryUpload()` is optional, and if not
provided the default behavior is used.
