Browse Source

JMAP WIP #2

tags/alpha-0.6.0
Manos Pitsidianakis 1 year ago
parent
commit
e8611cca2f
Signed by: epilys GPG Key ID: 73627C2F690DF710
7 changed files with 955 additions and 2 deletions
  1. +6
    -2
      melib/src/backends/jmap.rs
  2. +25
    -0
      melib/src/backends/jmap/objects.rs
  3. +289
    -0
      melib/src/backends/jmap/objects/email.rs
  4. +133
    -0
      melib/src/backends/jmap/protocol.rs
  5. +408
    -0
      melib/src/backends/jmap/rfc8620.rs
  6. +44
    -0
      melib/src/backends/jmap/rfc8620/comparator.rs
  7. +50
    -0
      melib/src/backends/jmap/rfc8620/filters.rs

+ 6
- 2
melib/src/backends/jmap.rs View File

@ -36,11 +36,15 @@ use std::str::FromStr;
use std::sync::{Arc, Mutex, RwLock};
pub mod protocol;
use protocol::*;
pub mod folder;
pub mod rfc8620;
use rfc8620::*;
pub mod objects;
use objects::*;
pub mod folder;
use folder::*;
#[derive(Debug, Default)]

+ 25
- 0
melib/src/backends/jmap/objects.rs View File

@ -0,0 +1,25 @@
/*
* meli - jmap module.
*
* Copyright 2019 Manos Pitsidianakis
*
* This file is part of meli.
*
* meli is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* meli is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with meli. If not, see <http://www.gnu.org/licenses/>.
*/
use super::*;
mod email;
pub use email::*;

+ 289
- 0
melib/src/backends/jmap/objects/email.rs View File

@ -0,0 +1,289 @@
/*
* meli - jmap module.
*
* Copyright 2019 Manos Pitsidianakis
*
* This file is part of meli.
*
* meli is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* meli is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with meli. If not, see <http://www.gnu.org/licenses/>.
*/
use super::*;
use crate::backends::jmap::protocol::*;
use std::collections::HashMap;
// 4.1.1.
// Metadata
// These properties represent metadata about the message in the mail
// store and are not derived from parsing the message itself.
//
// o id: "Id" (immutable; server-set)
//
// The id of the Email object. Note that this is the JMAP object id,
// NOT the Message-ID header field value of the message [RFC5322].
//
// o blobId: "Id" (immutable; server-set)
//
// The id representing the raw octets of the message [RFC5322] for
// this Email. This may be used to download the raw original message
// or to attach it directly to another Email, etc.
//
// o threadId: "Id" (immutable; server-set)
//
// The id of the Thread to which this Email belongs.
//
// o mailboxIds: "Id[Boolean]"
//
// The set of Mailbox ids this Email belongs to. An Email in the
// mail store MUST belong to one or more Mailboxes at all times
// (until it is destroyed). The set is represented as an object,
// with each key being a Mailbox id. The value for each key in the
// object MUST be true.
//
// o keywords: "String[Boolean]" (default: {})
//
// A set of keywords that apply to the Email. The set is represented
// as an object, with the keys being the keywords. The value for
// each key in the object MUST be true.
//
// Keywords are shared with IMAP. The six system keywords from IMAP
// get special treatment. The following four keywords have their
// first character changed from "\" in IMAP to "$" in JMAP and have
// particular semantic meaning:
//
// * "$draft": The Email is a draft the user is composing.
//
// * "$seen": The Email has been read.
//
// * "$flagged": The Email has been flagged for urgent/special
// attention.
//
// * "$answered": The Email has been replied to.
//
// The IMAP "\Recent" keyword is not exposed via JMAP. The IMAP
// "\Deleted" keyword is also not present: IMAP uses a delete+expunge
// model, which JMAP does not. Any message with the "\Deleted"
// keyword MUST NOT be visible via JMAP (and so are not counted in
// the "totalEmails", "unreadEmails", "totalThreads", and
// "unreadThreads" Mailbox properties).
//
// Users may add arbitrary keywords to an Email. For compatibility
// with IMAP, a keyword is a case-insensitive string of 1-255
// characters in the ASCII subset %x21-%x7e (excludes control chars
// and space), and it MUST NOT include any of these characters:
//
// ( ) { ] % * " \
//
// Because JSON is case sensitive, servers MUST return keywords in
// lowercase.
//
// The IANA "IMAP and JMAP Keywords" registry at
// <https://www.iana.org/assignments/imap-jmap-keywords/> as
// established in [RFC5788] assigns semantic meaning to some other
// keywords in common use. New keywords may be established here in
// the future. In particular, note:
//
// * "$forwarded": The Email has been forwarded.
//
// * "$phishing": The Email is highly likely to be phishing.
// Clients SHOULD warn users to take care when viewing this Email
// and disable links and attachments.
//
// * "$junk": The Email is definitely spam. Clients SHOULD set this
// flag when users report spam to help train automated spam-
// detection systems.
//
// * "$notjunk": The Email is definitely not spam. Clients SHOULD
// set this flag when users indicate an Email is legitimate, to
// help train automated spam-detection systems.
//
// o size: "UnsignedInt" (immutable; server-set)
//
// The size, in octets, of the raw data for the message [RFC5322] (as
// referenced by the "blobId", i.e., the number of octets in the file
// the user would download).
//
// o receivedAt: "UTCDate" (immutable; default: time of creation on
// server)
//
// The date the Email was received by the message store. This is the
// "internal date" in IMAP [RFC3501]./
#[derive(Deserialize, Serialize, Debug)]
pub struct EmailObject {
pub id: Id,
pub blob_id: Id,
pub thread_id: Id,
pub mailbox_ids: HashMap<Id, bool>,
pub keywords: HashMap<String, bool>,
pub size: u64,
pub received_at: String,
}
impl Object for EmailObject {}
#[derive(Deserialize, Serialize, Debug)]
#[serde(rename_all = "camelCase")]
pub struct EmailQueryResponse {
pub account_id: Id,
pub can_calculate_changes: bool,
pub collapse_threads: bool,
// FIXME
pub filter: String,
pub ids: Vec<Id>,
pub position: u64,
pub query_state: String,
pub sort: Option<String>,
pub total: usize,
}
#[derive(Deserialize, Serialize, Debug)]
#[serde(rename_all = "camelCase")]
pub struct EmailQueryCall {
pub filter: Vec<EmailFilterCondition>, /* "inMailboxes": [ folder.id ] },*/
pub collapse_threads: bool,
pub position: u64,
pub fetch_threads: bool,
pub fetch_messages: bool,
pub fetch_message_properties: Vec<MessageProperty>,
}
impl Method<EmailObject> for EmailQueryCall {
const NAME: &'static str = "Email/query";
}
#[derive(Deserialize, Serialize, Debug)]
#[serde(rename_all = "camelCase")]
pub struct EmailGetCall {
pub filter: Vec<EmailFilterCondition>, /* "inMailboxes": [ folder.id ] },*/
pub collapse_threads: bool,
pub position: u64,
pub fetch_threads: bool,
pub fetch_messages: bool,
pub fetch_message_properties: Vec<MessageProperty>,
}
impl Method<EmailObject> for EmailGetCall {
const NAME: &'static str = "Email/get";
}
#[derive(Serialize, Deserialize, Default, Debug)]
#[serde(rename_all = "camelCase")]
pub struct EmailFilterCondition {
#[serde(skip_serializing_if = "Vec::is_empty")]
pub in_mailboxes: Vec<Id>,
#[serde(skip_serializing_if = "Vec::is_empty")]
pub in_mailbox_other_than: Vec<Id>,
#[serde(skip_serializing_if = "String::is_empty")]
pub before: UtcDate,
#[serde(skip_serializing_if = "String::is_empty")]
pub after: UtcDate,
#[serde(default)]
#[serde(skip_serializing_if = "Option::is_none")]
pub min_size: Option<u64>,
#[serde(default)]
#[serde(skip_serializing_if = "Option::is_none")]
pub max_size: Option<u64>,
#[serde(skip_serializing_if = "String::is_empty")]
pub all_in_thread_have_keyword: String,
#[serde(skip_serializing_if = "String::is_empty")]
pub some_in_thread_have_keyword: String,
#[serde(skip_serializing_if = "String::is_empty")]
pub none_in_thread_have_keyword: String,
#[serde(skip_serializing_if = "String::is_empty")]
pub has_keyword: String,
#[serde(skip_serializing_if = "String::is_empty")]
pub not_keyword: String,
#[serde(skip_serializing_if = "Option::is_none")]
pub has_attachment: Option<bool>,
#[serde(skip_serializing_if = "String::is_empty")]
pub text: String,
#[serde(skip_serializing_if = "String::is_empty")]
pub from: String,
#[serde(skip_serializing_if = "String::is_empty")]
pub to: String,
#[serde(skip_serializing_if = "String::is_empty")]
pub cc: String,
#[serde(skip_serializing_if = "String::is_empty")]
pub bcc: String,
#[serde(skip_serializing_if = "String::is_empty")]
pub subject: String,
#[serde(skip_serializing_if = "String::is_empty")]
pub body: String,
#[serde(skip_serializing_if = "Vec::is_empty")]
pub header: Vec<String>,
}
impl FilterTrait<EmailObject> for EmailFilterCondition {}
// The following convenience properties are also specified for the Email
// object:
//
// o messageId: "String[]|null" (immutable)
//
// The value is identical to the value of "header:Message-
// ID:asMessageIds". For messages conforming to RFC 5322, this will
// be an array with a single entry.
//
// o inReplyTo: "String[]|null" (immutable)
//
// The value is identical to the value of "header:In-Reply-
// To:asMessageIds".
//
// o references: "String[]|null" (immutable)
//
// The value is identical to the value of
// "header:References:asMessageIds".
//
// o sender: "EmailAddress[]|null" (immutable)
//
// The value is identical to the value of
// "header:Sender:asAddresses".
//
// o from: "EmailAddress[]|null" (immutable)
//
// The value is identical to the value of "header:From:asAddresses".
//
// o to: "EmailAddress[]|null" (immutable)
//
// The value is identical to the value of "header:To:asAddresses".
//
// o cc: "EmailAddress[]|null" (immutable)
//
// The value is identical to the value of "header:Cc:asAddresses".
//
// o bcc: "EmailAddress[]|null" (immutable)
//
// The value is identical to the value of "header:Bcc:asAddresses".
//
// o replyTo: "EmailAddress[]|null" (immutable)
//
// The value is identical to the value of "header:Reply-
// To:asAddresses".
//
// o subject: "String|null" (immutable)
//
// The value is identical to the value of "header:Subject:asText".
//
//
//
// Jenkins & Newman Standards Track [Page 34]
//
// RFC 8621 JMAP Mail August 2019
//
//
// o sentAt: "Date|null" (immutable; default on creation: current
// server time)
//
// The value is identical to the value of "header:Date:asDate".

+ 133
- 0
melib/src/backends/jmap/protocol.rs View File

@ -21,8 +21,34 @@
use super::folder::JmapFolder;
use super::*;
use serde::{de::DeserializeOwned, Serialize};
use serde_json::{json, Value};
pub type Id = String;
pub type UtcDate = String;
use super::rfc8620::Object;
pub trait Method<OBJ: Object>: Serialize {
const NAME: &'static str;
}
#[derive(Deserialize, Serialize, Debug)]
#[serde(rename_all = "camelCase")]
pub enum MessageProperty {
ThreadId,
MailboxId,
IsUnread,
IsFlagged,
IsAnswered,
IsDraft,
HasAttachment,
From,
To,
Subject,
Date,
Preview,
}
macro_rules! get_path_hash {
($path:expr) => {{
use std::collections::hash_map::DefaultHasher;
@ -35,6 +61,45 @@ macro_rules! get_path_hash {
static USING: &'static [&'static str] = &["urn:ietf:params:jmap:core", "urn:ietf:params:jmap:mail"];
#[derive(Serialize)]
#[serde(rename_all = "camelCase")]
pub struct Request {
using: &'static [&'static str],
/* Why is this Value instead of Box<dyn Method<_>>? The Method trait cannot be made into a
* Trait object because its serialize() will be generic. */
method_calls: Vec<Value>,
}
impl Request {
pub fn new() -> Self {
Request {
using: USING,
method_calls: Vec::new(),
}
}
pub fn add_call<M: Method<O>, O: Object>(&mut self, call: M) {
self.method_calls
.push(serde_json::to_value((M::NAME, call, "f")).unwrap());
}
}
#[derive(Serialize, Debug)]
#[serde(untagged)]
pub enum MethodCall {
#[serde(rename_all = "camelCase")]
EmailQuery {
filter: Vec<String>, /* "inMailboxes": [ folder.id ] },*/
collapse_threads: bool,
position: u64,
fetch_threads: bool,
fetch_messages: bool,
fetch_message_properties: Vec<MessageProperty>,
},
MailboxGet {},
Empty {},
}
pub fn get_mailboxes(conn: &mut JmapConnection) -> Result<FnvHashMap<FolderHash, JmapFolder>> {
let res = conn
.client
@ -195,6 +260,74 @@ pub struct JmapRights {
// }, "call1"]
// ]
pub fn get_message_list(conn: &mut JmapConnection, folder: &JmapFolder) -> Result<Vec<String>> {
let email_call: EmailQueryCall = EmailQueryCall {
filter: vec![EmailFilterCondition {
in_mailboxes: vec![folder.id.clone()],
..Default::default()
}],
collapse_threads: false,
position: 0,
fetch_threads: true,
fetch_messages: true,
fetch_message_properties: vec![
MessageProperty::ThreadId,
MessageProperty::MailboxId,
MessageProperty::IsUnread,
MessageProperty::IsFlagged,
MessageProperty::IsAnswered,
MessageProperty::IsDraft,
MessageProperty::HasAttachment,
MessageProperty::From,
MessageProperty::To,
MessageProperty::Subject,
MessageProperty::Date,
MessageProperty::Preview,
],
};
let mut req = Request::new();
req.add_call(email_call);
std::dbg!(serde_json::to_string(&req));
/*
{
"using": [
"urn:ietf:params:jmap:core",
"urn:ietf:params:jmap:mail"
],
"methodCalls": [[
"Email/query",
{
"collapseThreads": false,
"fetchMessageProperties": [
"threadId",
"mailboxId",
"isUnread",
"isFlagged",
"isAnswered",
"isDraft",
"hasAttachment",
"from",
"to",
"subject",
"date",
"preview"
],
"fetchMessages": true,
"fetchThreads": true,
"filter": [
{
"inMailboxes": [
"fde49e47-14e7-11ea-a277-2477037a1804"
]
}
],
"position": 0
},
"f"
]]
}
*/
let res = conn
.client
.post("https://jmap-proxy.local/jmap/fc32dffe-14e7-11ea-a277-2477037a1804/")

+ 408
- 0
melib/src/backends/jmap/rfc8620.rs View File

@ -0,0 +1,408 @@
/*
* meli - jmap module.
*
* Copyright 2019 Manos Pitsidianakis
*
* This file is part of meli.
*
* meli is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* meli is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with meli. If not, see <http://www.gnu.org/licenses/>.
*/
use core::marker::PhantomData;
use serde::{de::DeserializeOwned, Serialize};
mod filters;
pub use filters::*;
mod comparator;
pub use comparator::*;
use super::protocol::Method;
pub trait Object {}
// 5.1. /get
//
// Objects of type Foo are fetched via a call to "Foo/get".
//
// It takes the following arguments:
//
// o accountId: "Id"
//
// The id of the account to use.
//
// o ids: "Id[]|null"
//
// The ids of the Foo objects to return. If null, then *all* records
// of the data type are returned, if this is supported for that data
// type and the number of records does not exceed the
// "maxObjectsInGet" limit.
//
// o properties: "String[]|null"
//
// If supplied, only the properties listed in the array are returned
// for each Foo object. If null, all properties of the object are
// returned. The id property of the object is *always* returned,
// even if not explicitly requested. If an invalid property is
// requested, the call MUST be rejected with an "invalidArguments"
// error.
#[derive(Deserialize, Serialize, Debug)]
#[serde(rename_all = "camelCase")]
pub struct GetCall<OBJ: Object, CALL: Method<OBJ>>
where
OBJ: std::fmt::Debug + Serialize,
{
#[serde(skip_serializing_if = "String::is_empty")]
account_id: String,
#[serde(skip_serializing_if = "Option::is_none")]
ids: Option<Vec<String>>,
#[serde(skip_serializing_if = "Option::is_none")]
properties: Option<Vec<String>>,
_ph: PhantomData<*const CALL>,
__ph: PhantomData<*const OBJ>,
}
// The response has the following arguments:
//
// o accountId: "Id"
//
// The id of the account used for the call.
//
// o state: "String"
//
// A (preferably short) string representing the state on the server
// for *all* the data of this type in the account (not just the
// objects returned in this call). If the data changes, this string
// MUST change. If the Foo data is unchanged, servers SHOULD return
// the same state string on subsequent requests for this data type.
// When a client receives a response with a different state string to
// a previous call, it MUST either throw away all currently cached
// objects for the type or call "Foo/changes" to get the exact
// changes.
//
// o list: "Foo[]"
//
// An array of the Foo objects requested. This is the *empty array*
// if no objects were found or if the "ids" argument passed in was
// also an empty array. The results MAY be in a different order to
// the "ids" in the request arguments. If an identical id is
// included more than once in the request, the server MUST only
// include it once in either the "list" or the "notFound" argument of
// the response.
//
// o notFound: "Id[]"
//
// This array contains the ids passed to the method for records that
// do not exist. The array is empty if all requested ids were found
// or if the "ids" argument passed in was either null or an empty
// array.
//
// The following additional error may be returned instead of the "Foo/
// get" response:
//
// "requestTooLarge": The number of ids requested by the client exceeds
// the maximum number the server is willing to process in a single
// method call.
#[derive(Serialize, Debug)]
#[serde(rename_all = "camelCase")]
pub struct GetResponse<T> {
#[serde(skip_serializing_if = "String::is_empty")]
account_id: String,
state: String,
list: Vec<T>,
not_found: Vec<String>,
}
#[derive(Deserialize, Debug)]
#[serde(rename_all = "camelCase")]
enum JmapError {
RequestTooLarge,
InvalidArguments,
}
// 5.5. /query
//
// For data sets where the total amount of data is expected to be very
// small, clients can just fetch the complete set of data and then do
// any sorting/filtering locally. However, for large data sets (e.g.,
// multi-gigabyte mailboxes), the client needs to be able to
// search/sort/window the data type on the server.
//
// A query on the set of Foos in an account is made by calling "Foo/
// query". This takes a number of arguments to determine which records
// to include, how they should be sorted, and which part of the result
// should be returned (the full list may be *very* long). The result is
// returned as a list of Foo ids.
//
// A call to "Foo/query" takes the following arguments:
//
// o accountId: "Id"
//
// The id of the account to use.
//
// o filter: "FilterOperator|FilterCondition|null"
//
// Determines the set of Foos returned in the results. If null, all
// objects in the account of this type are included in the results.
// A *FilterOperator* object has the following properties:
//
// * operator: "String"
//
// This MUST be one of the following strings:
//
// + "AND": All of the conditions must match for the filter to
// match.
//
// + "OR": At least one of the conditions must match for the
// filter to match.
//
// + "NOT": None of the conditions must match for the filter to
// match.
//
// * conditions: "(FilterOperator|FilterCondition)[]"
//
// The conditions to evaluate against each record.
//
// A *FilterCondition* is an "object" whose allowed properties and
// semantics depend on the data type and is defined in the /query
// method specification for that type. It MUST NOT have an
// "operator" property.
//
// o sort: "Comparator[]|null"
//
// Lists the names of properties to compare between two Foo records,
// and how to compare them, to determine which comes first in the
// sort. If two Foo records have an identical value for the first
// comparator, the next comparator will be considered, and so on. If
// all comparators are the same (this includes the case where an
// empty array or null is given as the "sort" argument), the sort
// order is server dependent, but it MUST be stable between calls to
// "Foo/query". A *Comparator* has the following properties:
//
// * property: "String"
//
// The name of the property on the Foo objects to compare.
//
// * isAscending: "Boolean" (optional; default: true)
//
// If true, sort in ascending order. If false, reverse the
// comparator's results to sort in descending order.
//
// * collation: "String" (optional; default is server-dependent)
//
// The identifier, as registered in the collation registry defined
// in [RFC4790], for the algorithm to use when comparing the order
// of strings. The algorithms the server supports are advertised
// in the capabilities object returned with the Session object
// (see Section 2).
//
// If omitted, the default algorithm is server dependent, but:
//
// 1. It MUST be unicode-aware.
//
// 2. It MAY be selected based on an Accept-Language header in
// the request (as defined in [RFC7231], Section 5.3.5) or
// out-of-band information about the user's language/locale.
//
// 3. It SHOULD be case insensitive where such a concept makes
// sense for a language/locale. Where the user's language is
// unknown, it is RECOMMENDED to follow the advice in
// Section 5.2.3 of [RFC8264].
//
// The "i;unicode-casemap" collation [RFC5051] and the Unicode
// Collation Algorithm (<http://www.unicode.org/reports/tr10/>)
// are two examples that fulfil these criterion and provide
// reasonable behaviour for a large number of languages.
//
// When the property being compared is not a string, the
// "collation" property is ignored, and the following comparison
// rules apply based on the type. In ascending order:
//
// + "Boolean": false comes before true.
//
// + "Number": A lower number comes before a higher number.
//
// + "Date"/"UTCDate": The earlier date comes first.
//
// The Comparator object may also have additional properties as
// required for specific sort operations defined in a type's /query
// method.
//
// o position: "Int" (default: 0)
//
// The zero-based index of the first id in the full list of results
// to return.
//
// If a negative value is given, it is an offset from the end of the
// list. Specifically, the negative value MUST be added to the total
// number of results given the filter, and if still negative, it's
// clamped to "0". This is now the zero-based index of the first id
// to return.
//
// If the index is greater than or equal to the total number of
// objects in the results list, then the "ids" array in the response
// will be empty, but this is not an error.
//
// o anchor: "Id|null"
//
// A Foo id. If supplied, the "position" argument is ignored. The
// index of this id in the results will be used in combination with
// the "anchorOffset" argument to determine the index of the first
// result to return (see below for more details).
//
// o anchorOffset: "Int" (default: 0)
//
// The index of the first result to return relative to the index of
// the anchor, if an anchor is given. This MAY be negative. For
// example, "-1" means the Foo immediately preceding the anchor is
// the first result in the list returned (see below for more
// details).
//
// o limit: "UnsignedInt|null"
//
// The maximum number of results to return. If null, no limit
// presumed. The server MAY choose to enforce a maximum "limit"
// argument. In this case, if a greater value is given (or if it is
// null), the limit is clamped to the maximum; the new limit is
// returned with the response so the client is aware. If a negative
// value is given, the call MUST be rejected with an
// "invalidArguments" error.
//
// o calculateTotal: "Boolean" (default: false)
//
// Does the client wish to know the total number of results in the
// query? This may be slow and expensive for servers to calculate,
// particularly with complex filters, so clients should take care to
// only request the total when needed.
//
// If an "anchor" argument is given, the anchor is looked for in the
// results after filtering and sorting. If found, the "anchorOffset" is
// then added to its index. If the resulting index is now negative, it
// is clamped to 0. This index is now used exactly as though it were
// supplied as the "position" argument. If the anchor is not found, the
// call is rejected with an "anchorNotFound" error.
//
// If an "anchor" is specified, any position argument supplied by the
// client MUST be ignored. If no "anchor" is supplied, any
// "anchorOffset" argument MUST be ignored.
//
// A client can use "anchor" instead of "position" to find the index of
// an id within a large set of results.
#[derive(Serialize, Debug)]
#[serde(rename_all = "camelCase")]
pub struct QueryCall<F: FilterTrait<OBJ>, OBJ: Object>
where
OBJ: std::fmt::Debug + Serialize,
{
account_id: String,
filter: Option<Filter<F, OBJ>>,
sort: Option<Comparator<OBJ>>,
#[serde(default)]
position: u64,
#[serde(skip_serializing_if = "Option::is_none")]
anchor: Option<String>,
#[serde(default)]
anchor_offset: u64,
#[serde(skip_serializing_if = "Option::is_none")]
limit: Option<u64>,
#[serde(default = "bool_false")]
calculate_total: bool,
_ph: PhantomData<*const OBJ>,
}
fn bool_false() -> bool {
false
}
fn bool_true() -> bool {
true
}
// The response has the following arguments:
//
// o accountId: "Id"
//
// The id of the account used for the call.
//
// o queryState: "String"
//
// A string encoding the current state of the query on the server.
// This string MUST change if the results of the query (i.e., the
// matching ids and their sort order) have changed. The queryState
// string MAY change if something has changed on the server, which
// means the results may have changed but the server doesn't know for
// sure.
//
// The queryState string only represents the ordered list of ids that
// match the particular query (including its sort/filter). There is
// no requirement for it to change if a property on an object
// matching the query changes but the query results are unaffected
// (indeed, it is more efficient if the queryState string does not
// change in this case). The queryState string only has meaning when
// compared to future responses to a query with the same type/sort/
// filter or when used with /queryChanges to fetch changes.
//
// Should a client receive back a response with a different
// queryState string to a previous call, it MUST either throw away
// the currently cached query and fetch it again (note, this does not
// require fetching the records again, just the list of ids) or call
// "Foo/queryChanges" to get the difference.
//
// o canCalculateChanges: "Boolean"
//
// This is true if the server supports calling "Foo/queryChanges"
// with these "filter"/"sort" parameters. Note, this does not
// guarantee that the "Foo/queryChanges" call will succeed, as it may
// only be possible for a limited time afterwards due to server
// internal implementation details.
//
// o position: "UnsignedInt"
//
// The zero-based index of the first result in the "ids" array within
// the complete list of query results.
//
// o ids: "Id[]"
//
// The list of ids for each Foo in the query results, starting at the
// index given by the "position" argument of this response and
// continuing until it hits the end of the results or reaches the
// "limit" number of ids. If "position" is >= "total", this MUST be
// the empty list.
//
// o total: "UnsignedInt" (only if requested)
//
// The total number of Foos in the results (given the "filter").
// This argument MUST be omitted if the "calculateTotal" request
// argument is not true.
//
// o limit: "UnsignedInt" (if set by the server)
//
// The limit enforced by the server on the maximum number of results
// to return. This is only returned if the server set a limit or
// used a different limit than that given in the request.
//
// The following additional errors may be returned instead of the "Foo/
// query" response:
//
// "anchorNotFound": An anchor argument was supplied, but it cannot be
// found in the results of the query.
//
// "unsupportedSort": The "sort" is syntactically valid, but it includes
// a property the server does not support sorting on or a collation
// method it does not recognise.
//
// "unsupportedFilter": The "filter" is syntactically valid, but the
// server cannot process it. If the filter was the result of a user's
// search input, the client SHOULD suggest that the user simplify their
// search.

+ 44
- 0
melib/src/backends/jmap/rfc8620/comparator.rs View File

@ -0,0 +1,44 @@
/*
* meli - jmap module.
*
* Copyright 2019 Manos Pitsidianakis
*
* This file is part of meli.
*
* meli is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* meli is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with meli. If not, see <http://www.gnu.org/licenses/>.
*/
use super::*;
#[derive(Serialize, Debug)]
#[serde(rename_all = "camelCase")]
pub struct Comparator<OBJ: Object> {
property: String,
#[serde(default = "bool_true")]
is_ascending: bool,
//FIXME
collation: Option<String>,
//#[serde(flatten)]
additional_properties: Vec<String>,
_ph: PhantomData<*const OBJ>,
}
#[derive(Serialize, Debug)]
#[serde(rename_all = "UPPERCASE")]
pub enum FilterOperator {
And,
Or,
Not,
}

+ 50
- 0
melib/src/backends/jmap/rfc8620/filters.rs View File

@ -0,0 +1,50 @@
/*
* meli - jmap module.
*
* Copyright 2019 Manos Pitsidianakis
*
* This file is part of meli.
*
* meli is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* meli is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with meli. If not, see <http://www.gnu.org/licenses/>.
*/
use super::*;
pub trait FilterTrait<T> {}
#[derive(Serialize, Debug)]
#[serde(rename_all = "camelCase")]
#[serde(untagged)]
pub enum Filter<F: FilterTrait<OBJ>, OBJ: Object> {
Operator {
operator: FilterOperator,
conditions: Vec<Filter<F, OBJ>>,
},
Condition(FilterCondition<F, OBJ>),
}
#[derive(Serialize, Debug)]
pub struct FilterCondition<F: FilterTrait<OBJ>, OBJ: Object> {
#[serde(flatten)]
cond: F,
#[serde(skip)]
_ph: PhantomData<*const OBJ>,
}
#[derive(Serialize, Debug)]
#[serde(rename_all = "UPPERCASE")]
pub enum FilterOperator {
And,
Or,
Not,
}

Loading…
Cancel
Save