From users-return-11919-apmail-qpid-users-archive=qpid.apache.org@qpid.apache.org Wed Feb 18 18:19:12 2015 Return-Path: X-Original-To: apmail-qpid-users-archive@www.apache.org Delivered-To: apmail-qpid-users-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 6EA5A10177 for ; Wed, 18 Feb 2015 18:19:12 +0000 (UTC) Received: (qmail 6893 invoked by uid 500); 18 Feb 2015 18:19:12 -0000 Delivered-To: apmail-qpid-users-archive@qpid.apache.org Received: (qmail 6779 invoked by uid 500); 18 Feb 2015 18:19:12 -0000 Mailing-List: contact users-help@qpid.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: users@qpid.apache.org Delivered-To: mailing list users@qpid.apache.org Received: (qmail 6739 invoked by uid 99); 18 Feb 2015 18:19:11 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 18 Feb 2015 18:19:11 +0000 X-ASF-Spam-Status: No, hits=1.5 required=5.0 tests=HTML_MESSAGE,RCVD_IN_DNSWL_LOW,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (athena.apache.org: domain of justin.ross@gmail.com designates 209.85.212.175 as permitted sender) Received: from [209.85.212.175] (HELO mail-wi0-f175.google.com) (209.85.212.175) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 18 Feb 2015 18:19:06 +0000 Received: by mail-wi0-f175.google.com with SMTP id r20so43003411wiv.2 for ; Wed, 18 Feb 2015 10:18:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type; bh=GRflzgPU0xVSIs69DpFZw0wkEY7362g2Y9SgDg4X+PU=; b=MDn7/zUz1IOO6LypoRQwL6bTwqXdYF6y6FYCKvoEDYT6FAASUjCZQaTLPv7uUNZ0P1 y6IH3XRWlteCfuL+VszbzA4I2cev8+ykgBZxC2vTznL6MzTKQlLDjz0yQqosdiL98DSQ QdEGX9I8SFks9jYbwkcvKQ5+AhoOFUIPI37Qs4GSjXi0wSlLHVMmsR7hcuE/h8HakOe0 zXX0mj2lNMl0nOF6TfcsbhnyABwaSqX8MQKSQ/IUzwW9FmqbwdG4zcGhOhQImVk8Dy01 YUkaa2y5+5BKpWRUVJh2PFoOP0KEGUt9ISzmGxlARUzpIkk51k0drALj2wqRQJ1yn+7C urhw== MIME-Version: 1.0 X-Received: by 10.180.212.8 with SMTP id ng8mr2727691wic.18.1424283480423; Wed, 18 Feb 2015 10:18:00 -0800 (PST) Received: by 10.27.136.70 with HTTP; Wed, 18 Feb 2015 10:18:00 -0800 (PST) In-Reply-To: References: <54E458E2.1080105@redhat.com> Date: Wed, 18 Feb 2015 13:18:00 -0500 Message-ID: Subject: Re: Proton API layout proposal From: Justin Ross To: "users@qpid.apache.org" Content-Type: multipart/alternative; boundary=001a11c364e4e90202050f60d690 X-Virus-Checked: Checked by ClamAV on apache.org --001a11c364e4e90202050f60d690 Content-Type: text/plain; charset=UTF-8 On Wed, Feb 18, 2015 at 10:53 AM, Justin Ross wrote: > > > On Wed, Feb 18, 2015 at 9:28 AM, Rafael Schloming > wrote: > >> A couple of comments in no particular order... >> >> The "Core user model and uitility classes" description could be >> misinterpreted on a quick read. Maybe go with "Core protocol model..." or >> something like that? (Really all these APIs are for users, so it seems >> weird to mention it.) Also the utility classes mentioned here sound like >> they overlap with the util package. What is that actually referring to? >> > > Yes, good point. I'll go with protocol instead. > > If I could, I'd make util go away. It's for low-level things (not Proton > extensions, but language library extensions) that we wish to make public. > The best example we currently have is URL. > I should say also that I since there's just one utility of this kind so far, and since we will have extras/contrib/adapters for things such as BlockingConnection, I am content to drop proton.util and move URL to the top level. I would then consider a proton.logging group if there were enough things to put there. > Reference points: > > - > https://git-wip-us.apache.org/repos/asf?p=qpid-proton.git;a=tree;f=examples/python > - http://people.apache.org/~jross/proton-apidoc-draft-2/group__types.html > - > http://qpid.apache.org/releases/qpid-proton-0.8/protocol-engine/java/api/index.html > Gah, html frames got me. I meant to link to the list of proton-j types. http://qpid.apache.org/releases/qpid-proton-0.8/protocol-engine/java/api/org/apache/qpid/proton/amqp/package-summary.html --001a11c364e4e90202050f60d690--