From issues-return-59929-archive-asf-public=cust-asf.ponee.io@ignite.apache.org Sun Mar 25 10:03: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 5BD8318063B for ; Sun, 25 Mar 2018 10:03:05 +0200 (CEST) Received: (qmail 13119 invoked by uid 500); 25 Mar 2018 08:03:04 -0000 Mailing-List: contact issues-help@ignite.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@ignite.apache.org Delivered-To: mailing list issues@ignite.apache.org Received: (qmail 13110 invoked by uid 99); 25 Mar 2018 08:03:04 -0000 Received: from pnap-us-west-generic-nat.apache.org (HELO spamd2-us-west.apache.org) (209.188.14.142) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 25 Mar 2018 08:03:04 +0000 Received: from localhost (localhost [127.0.0.1]) by spamd2-us-west.apache.org (ASF Mail Server at spamd2-us-west.apache.org) with ESMTP id EB9CA1A03D9 for ; Sun, 25 Mar 2018 08:03:02 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd2-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: -101.511 X-Spam-Level: X-Spam-Status: No, score=-101.511 tagged_above=-999 required=6.31 tests=[KAM_ASCII_DIVIDERS=0.8, RCVD_IN_DNSWL_MED=-2.3, SPF_PASS=-0.001, T_RP_MATCHES_RCVD=-0.01, USER_IN_WHITELIST=-100] autolearn=disabled Received: from mx1-lw-us.apache.org ([10.40.0.8]) by localhost (spamd2-us-west.apache.org [10.40.0.9]) (amavisd-new, port 10024) with ESMTP id uC3bAFWGXaXI for ; Sun, 25 Mar 2018 08:03:01 +0000 (UTC) Received: from mailrelay1-us-west.apache.org (mailrelay1-us-west.apache.org [209.188.14.139]) by mx1-lw-us.apache.org (ASF Mail Server at mx1-lw-us.apache.org) with ESMTP id 8DF505FE08 for ; Sun, 25 Mar 2018 08:03:01 +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 C30ACE031B for ; Sun, 25 Mar 2018 08:03:00 +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 3E87A214FB for ; Sun, 25 Mar 2018 08:03:00 +0000 (UTC) Date: Sun, 25 Mar 2018 08:03:00 +0000 (UTC) From: "Alexey Kosenchuk (JIRA)" To: issues@ignite.apache.org Message-ID: In-Reply-To: References: Subject: [jira] [Assigned] (IGNITE-8039) Binary Client Protocol spec: data types/format clarifications 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/IGNITE-8039?page=3Dcom.atlassi= an.jira.plugin.system.issuetabpanels:all-tabpanel ] Alexey Kosenchuk reassigned IGNITE-8039: ---------------------------------------- Assignee: Prachi Garg > Binary Client Protocol spec: data types/format clarifications > ------------------------------------------------------------- > > Key: IGNITE-8039 > URL: https://issues.apache.org/jira/browse/IGNITE-8039 > Project: Ignite > Issue Type: Bug > Components: documentation, thin client > Affects Versions: 2.4 > Reporter: Alexey Kosenchuk > Assignee: Prachi Garg > Priority: Major > Fix For: 2.5 > > > Assuming the Binary Client Protocol spec should be detalized enough to al= low a client development basing on the spec only, w/o looking at other clie= nt implementations and asking additional questions... > The following should be clarified / corrected in the Binary Client Protoc= ol spec (v.2.4) (https://apacheignite.readme.io/v2.4/docs/binary-client-pro= tocol#section-data-format): > Type Codes table: > ----------------- > - UUID (Guid) size: should be 16 bytes, not 8 (?)=20 > - what is Object array (type code 23) ? What is the difference between it= and Objects Wrapped In=E2=80=8B Array (type code 27) ? > - what is Collection USER_SET ? > - what is Collection USER_COL ? > - what is Collection SINGLETON_LIST ? > - Collection: misprint: should be "... + length ..." > - what is Decimal ? > - what is Timestamp ? > - what is Time ? > Complex Objects: > ---------------- > - what does flag USER_TYPE mean ? > - Schema "field Id; Java-style hash code of field" -> should be "... of f= ield name". > - "Repeat for as many times as the total number of schemas you have" -> s= hould be "... total number of fields you have". > - is it mandated that the number of fields in the Schema must be equal to= the number of fields in the Data Object ? > Objects Wrapped In=E2=80=8B Array > ------------------------ > - may binary objects with different type codes be in the same array ? > - may complex objects with different type ids be in the same array ? > - "All cache operations return complex objects inside a wrapper (but not = primitives)." -> does it mean that in general a complex object (103) must a= lways be sent via the Binary Protocol in a wrapper (27)?=20 > - "Byte array size" -> "Payload size" or "Size of the whole array with he= ader" ? > - Offset. What is "object graph" here ? The Binary Protocol nowhere descr= ibes any relations ("graph") between data objects in the protocol. > Terminology > ----------- > Not critical but would be really convenient to define and use the same te= rms along the whole spec. For example: > - "binary object" is always the same as "data object" of any type (?). Ca= n be "standard/predefined type object" or "complex object". > - "cluster" or "server" ? > - "cluster member" or "server nodes" ? -- This message was sent by Atlassian JIRA (v7.6.3#76005)