james-server-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From adup...@apache.org
Subject [3/4] james-project git commit: JAMES-1714 Update JMAP documentation with SetMailboxes support
Date Wed, 13 Apr 2016 07:13:06 GMT
JAMES-1714 Update JMAP documentation with SetMailboxes support

Project: http://git-wip-us.apache.org/repos/asf/james-project/repo
Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/df85eaf3
Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/df85eaf3
Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/df85eaf3

Branch: refs/heads/master
Commit: df85eaf33ea7ea88b94ed7a7b29497d842195464
Parents: f185db6
Author: Laura Royet <lroyet@linagora.com>
Authored: Tue Apr 12 14:24:43 2016 +0200
Committer: Laura Royet <lroyet@linagora.com>
Committed: Tue Apr 12 14:24:55 2016 +0200

 .../protocols/jmap/doc/specs/spec/mailbox.mdwn   | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/server/protocols/jmap/doc/specs/spec/mailbox.mdwn b/server/protocols/jmap/doc/specs/spec/mailbox.mdwn
index c575328..253a0a9 100644
--- a/server/protocols/jmap/doc/specs/spec/mailbox.mdwn
+++ b/server/protocols/jmap/doc/specs/spec/mailbox.mdwn
@@ -196,15 +196,21 @@ The following errors may be returned instead of the `mailboxUpdates`
 `cannotCalculateChanges`: Returned if the server cannot calculate the changes from the state
string given by the client. Usually due to the client's state being too old. The client MUST
invalidate its Mailbox cache. The error object MUST also include a `newState: String` property
with the current state for the type.
 ### setMailboxes
-<aside class="warning">
-Not implemented
+<aside class="notice">
+The mailbox name property should not contain the special '.' (dot) character. 
 Mailboxes can be created, updated and destroyed using the *setMailboxes* method. The method
takes the following arguments:
 - **accountId**: `String|null`
+  <aside class="warning">
+  Not implemented
+  </aside>
   The id of the account to use for this call. If `null`, defaults to the primary account.
 - **ifInState**: `String|null`
+  <aside class="warning">
+  Not implemented
+  </aside>
   This is a state string as returned by the *getMailboxes* method. If supplied, the string
must match the current state, otherwise the method will be aborted and a `stateMismatch` error
 - **create**: `String[Mailbox]|null`
   A map of *creation id* (an arbitrary string set by the client) to Mailbox objects. If `null`,
no objects will be created.
@@ -218,6 +224,9 @@ Each create, update or destroy is considered an atomic unit. The server
MAY comm
 If a create, update or destroy is rejected, the appropriate error should be added to the
notCreated/notUpdated/notDestroyed property of the response and the server MUST continue to
the next create/update/destroy. It does not terminate the method.
 ####  Creating mailboxes
+<aside class="notice">
+Only Name, Role & ParentId properties are supported.
 The properties of the Mailbox object submitted for creation MUST conform to the following
@@ -233,6 +242,9 @@ If any of the properties are invalid, the server MUST reject the create
with an
 There may be a maximum number of mailboxes allowed on the server. If this is reached, any
attempt at creation will be rejected with a `maxQuotaReached` error.
 ####  Updating mailboxes
+<aside class="notice">
+Due to cycle detection, mailboxes with child cannot be updated. 
 If the *id* given does not correspond to a Mailbox in the given account, the update MUST
be rejected with a `notFound` error.
@@ -240,6 +252,9 @@ All properties being updated must be of the correct type, not immutable
or serve
 - The *name* property MUST be valid UTF-8, between 1 and 256 bytes in size.
 - The *parentId* property MUST be either `null` or be a valid id for *another* mailbox that
is **not a descendant** of this mailbox, and for which the `mayCreateChild` property is `true`.
+  <aside class="notice">
+  Only Name, Role & ParentId properties are supported.
+  </aside>
 - These properties are immutable or may only be set by the server:
   - id
   - role

To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org

View raw message