From dev-return-48394-archive-asf-public=cust-asf.ponee.io@jackrabbit.apache.org Thu Aug 9 08:28:05 2018 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by mx-eu-01.ponee.io (Postfix) with SMTP id 4601518065B for ; Thu, 9 Aug 2018 08:28:05 +0200 (CEST) Received: (qmail 27283 invoked by uid 500); 9 Aug 2018 06:28:04 -0000 Mailing-List: contact dev-help@jackrabbit.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@jackrabbit.apache.org Delivered-To: mailing list dev@jackrabbit.apache.org Received: (qmail 27273 invoked by uid 99); 9 Aug 2018 06:28:04 -0000 Received: from pnap-us-west-generic-nat.apache.org (HELO spamd1-us-west.apache.org) (209.188.14.142) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 09 Aug 2018 06:28:04 +0000 Received: from localhost (localhost [127.0.0.1]) by spamd1-us-west.apache.org (ASF Mail Server at spamd1-us-west.apache.org) with ESMTP id B8B32C8334 for ; Thu, 9 Aug 2018 06:28:03 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd1-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: -109.501 X-Spam-Level: X-Spam-Status: No, score=-109.501 tagged_above=-999 required=6.31 tests=[ENV_AND_HDR_SPF_MATCH=-0.5, KAM_ASCII_DIVIDERS=0.8, RCVD_IN_DNSWL_MED=-2.3, SPF_PASS=-0.001, USER_IN_DEF_SPF_WL=-7.5, USER_IN_WHITELIST=-100] autolearn=disabled Received: from mx1-lw-eu.apache.org ([10.40.0.8]) by localhost (spamd1-us-west.apache.org [10.40.0.7]) (amavisd-new, port 10024) with ESMTP id wtekxZARpVyW for ; Thu, 9 Aug 2018 06:28:03 +0000 (UTC) Received: from mailrelay1-us-west.apache.org (mailrelay1-us-west.apache.org [209.188.14.139]) by mx1-lw-eu.apache.org (ASF Mail Server at mx1-lw-eu.apache.org) with ESMTP id 77FB35F4AA for ; Thu, 9 Aug 2018 06:28:02 +0000 (UTC) Received: from jira-lw-us.apache.org (unknown [207.244.88.139]) by mailrelay1-us-west.apache.org (ASF Mail Server at mailrelay1-us-west.apache.org) with ESMTP id 691BBE2634 for ; Thu, 9 Aug 2018 06:28:01 +0000 (UTC) Received: from jira-lw-us.apache.org (localhost [127.0.0.1]) by jira-lw-us.apache.org (ASF Mail Server at jira-lw-us.apache.org) with ESMTP id A4E6A23FB1 for ; Thu, 9 Aug 2018 06:28:00 +0000 (UTC) Date: Thu, 9 Aug 2018 06:28:00 +0000 (UTC) From: "Alexander Klimetschek (JIRA)" To: dev@jackrabbit.apache.org Message-ID: In-Reply-To: References: Subject: [jira] [Updated] (JCR-4355) Javadoc fixes and improvements for new direct binary access API MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-JIRA-FingerPrint: 30527f35849b9dde25b450d4833f0394 [ https://issues.apache.org/jira/browse/JCR-4355?page=3Dcom.atlassian.= jira.plugin.system.issuetabpanels:all-tabpanel ] Alexander Klimetschek updated JCR-4355: --------------------------------------- Description:=20 Here are some changes to the javadocs for the new API: OAK-7569-api-javadoc= -improvements.patch * more concise descriptions * correcting some inaccuracies (clients cannot choose whether to do single = or multipart upload, multipart might be strictly required depending on the = size) * most importantly the upload algorithm (standard partSize calculation was = wrong) * focus on API users, separated notes to implementors * for BinaryDownloadOptions added note from which jcr properties a client w= ould normally take these values from * added security considerations was: Here are some changes to the javadocs for the new API: OAK-7569-api-javadoc= -improvements.patch * more concise descriptions * correcting some inaccuracies (clients cannot choose whether to do single = or multipart upload, multipart might be strictly required depending on the = size) * most importantly the upload algorithm (standard partSize calculation was = wrong) *=C2=A0focus on API users, separated notes to implementors *=C2=A0for BinaryDownloadOptions added note from which jcr properties a cli= ent would normally take these values from *=C2=A0added security considerations > Javadoc fixes and improvements for new direct binary access API > --------------------------------------------------------------- > > Key: JCR-4355 > URL: https://issues.apache.org/jira/browse/JCR-4355 > Project: Jackrabbit Content Repository > Issue Type: Improvement > Components: jackrabbit-api > Reporter: Alexander Klimetschek > Priority: Major > > Here are some changes to the javadocs for the new API: OAK-7569-api-javad= oc-improvements.patch > * more concise descriptions > * correcting some inaccuracies (clients cannot choose whether to do singl= e or multipart upload, multipart might be strictly required depending on th= e size) > * most importantly the upload algorithm (standard partSize calculation wa= s wrong) > * focus on API users, separated notes to implementors > * for BinaryDownloadOptions added note from which jcr properties a client= would normally take these values from > * added security considerations -- This message was sent by Atlassian JIRA (v7.6.3#76005)