From api-return-959-archive-asf-public=cust-asf.ponee.io@directory.apache.org Mon Jan 22 00:12:17 2018 Return-Path: X-Original-To: archive-asf-public@eu.ponee.io Delivered-To: archive-asf-public@eu.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by mx-eu-01.ponee.io (Postfix) with ESMTP id A1AD7180652 for ; Mon, 22 Jan 2018 00:12:17 +0100 (CET) Received: by cust-asf.ponee.io (Postfix) id 9141E160C37; Sun, 21 Jan 2018 23:12:17 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id D6CB0160C36 for ; Mon, 22 Jan 2018 00:12:16 +0100 (CET) Received: (qmail 40865 invoked by uid 500); 21 Jan 2018 23:12:16 -0000 Mailing-List: contact api-help@directory.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: api@directory.apache.org Delivered-To: mailing list api@directory.apache.org Received: (qmail 97453 invoked by uid 99); 21 Jan 2018 21:25:35 -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; Sun, 21 Jan 2018 21:25:35 +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 ACE1CC2A34 for ; Sun, 21 Jan 2018 21:25:34 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd1-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: 1.879 X-Spam-Level: * X-Spam-Status: No, score=1.879 tagged_above=-999 required=6.31 tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=2, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_PASS=-0.001] autolearn=disabled Authentication-Results: spamd1-us-west.apache.org (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com Received: from mx1-lw-us.apache.org ([10.40.0.8]) by localhost (spamd1-us-west.apache.org [10.40.0.7]) (amavisd-new, port 10024) with ESMTP id ta2RclHcNjKQ for ; Sun, 21 Jan 2018 21:25:33 +0000 (UTC) Received: from mail-lf0-f51.google.com (mail-lf0-f51.google.com [209.85.215.51]) by mx1-lw-us.apache.org (ASF Mail Server at mx1-lw-us.apache.org) with ESMTPS id 5E4E15F6D2 for ; Sun, 21 Jan 2018 21:25:33 +0000 (UTC) Received: by mail-lf0-f51.google.com with SMTP id a204so8243416lfa.2 for ; Sun, 21 Jan 2018 13:25:33 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=PW18pzIoHKkFP8nnoP12Lysuai4F71FQFHSxmTCNaj8=; b=CsjGQR1mso9cB5gM4VaZIy7rj2BA4UsDVYFgqDNUy29tl2iTQE03YV/Ww2ZOOR55TO kRcL3U1q2iEEYCO31u+hcrhBmK0ShnSWxzFQH4Dy8AfNY3WyDhWC22uNEY37Ac6g29wr YBbm/P52HY8zAyBpQxNCNMP5RMkTguxYBBBv0rQmoCrHT2EkOTW2efvdaYWhPYqVyGcx LI38ozlL24FmHD8jhtvBozIw/jYnk3OnuxhKYal9fuLUfP0wQPLDiR70ay4Tzc5V0vsv lhFYXtkYmx1gkTCmHjCuIv099NNstH5j3ySjaubLMXmrkE+dhkjAqwSSYAlU0RCTzl2z 2uVQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=PW18pzIoHKkFP8nnoP12Lysuai4F71FQFHSxmTCNaj8=; b=EiHcV5Xgm+5WUbfTOI7cWGzJWjRG/xKTfT4KTBaZ77AK4SD+gszn7RrXblnBveT8VH cyI6CwTJ2O0juKFAmJoqBfRqL2wN5quK/Vpw6r+bbKAvpyd+adTz9ofQUTsOsxoN11hN soIACLmCz26+7WaqgW/r1YGd6TD0qNYtC8/gi8gIbNrM5la23fsIQkUCXCZtBNB3BNlT 1OtZSz9kkDGGvTbaM3hFCFxNkVVFs9Km4oTVJF6gxCwmmtB3CFSzWrzX+1XK5zgjfgAI SbVVRX9zP6ZOCTbXrn2J407/XQyAdYpcp/yd+mkQO5/wVMPginvyJVMUrr6i/U+bCiuh h11Q== X-Gm-Message-State: AKwxytdhe3k5k1wAwhvPeXt9izzBtG5TkMDGvXE36PdFHUOzV9zsuu2h tH5aDK41RqbudezUXv2OMTmKoEJ4zBEvEpBQYQ+omg== X-Google-Smtp-Source: AH8x224nAa33L3yxX98vQmhQRTffwAecaYppTI7HeCc0W3GeJRfZjXucAZtGTqanLYClLOWEtktGXI8A8OLx1a0aeJY= X-Received: by 10.46.36.26 with SMTP id k26mr429717ljk.14.1516569931421; Sun, 21 Jan 2018 13:25:31 -0800 (PST) MIME-Version: 1.0 Received: by 10.25.217.220 with HTTP; Sun, 21 Jan 2018 13:25:30 -0800 (PST) From: Nick Couchman Date: Sun, 21 Jan 2018 16:25:30 -0500 Message-ID: Subject: Questions about Referrals To: api@directory.apache.org Content-Type: multipart/alternative; boundary="f4f5e8076c240a1ecd05634ff43d" --f4f5e8076c240a1ecd05634ff43d Content-Type: text/plain; charset="UTF-8" Hey, there, everyone, Over at the ASF Guacamole project we're trying to migrate to the Apache Directory API from the legacy/unmaintained Novell Java API. We're most of the way there, but trying to deal correctly with referral following in the Apache API, so I have a couple of questions regarding how the Apache Directory Client functions... First, if I want to following referrals when retrieving search results, is it as simple as doing: request.followReferrals(); (where request is an instance of SearchRequestImpl) and the client automatically follows the referrals? Or do I need to implement the referral following manually by detecting if a referral occurs and then writing the code to follow that referral? Second, with regard to following referrals, assuming the above works to just make the client follow referrals, is there any way to limit the number of hops the client takes in following referrals? In the Novell API you can set a variety of controls, and one of them is the maximum number of "hops" taken when following referrals, which prevents the client from getting into a bad situation, like a recursive referral or an endless loop of referrals. I do not see anything similar in the Apache API for limiting - am I missing it? Finally, assuming there isn't anything built-in to the API to limit referral hops, I see that there is a getReferralLength() method in the ReferralImpl class, but it's unclear what is meant by "referral length?" Is this referring to the number of hops, or some other "length" associated with referrals? Thanks! -Nick --f4f5e8076c240a1ecd05634ff43d--