Mailing-List: contact abdera-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: abdera-dev@incubator.apache.org
Received-SPF: pass (asf.osuosl.org: domain of sayrer@gmail.com designates
 64.233.182.189 as permitted sender)
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws;
        s=beta; d=gmail.com;
        h=received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references;
        b=L9gzzvM17N686hf1BniqPB8CaMQaw3zEfxU1SQgwwPYUi76gzsdQI9ZymTIAKo8jkw8V8IzSX8miCk0CPWpbu0YEDlk3/XP5ChfHhYJyJRaMjR4THMKSrwZWOgOMjspflItduwF1cFMk1ONaPtQodhGXyzAKlYmxfjajP6yUt+A=
Message-ID: <68fba5c50607131511w5238648dre9df1334fc9bb638@mail.gmail.com>
Date: Thu, 13 Jul 2006 18:11:30 -0400
From: "Robert Sayre" <sayrer@gmail.com>
To: abdera-dev@incubator.apache.org
Subject: Re: Model api changes
In-Reply-To: <7edfeeef0607131330j3063325en7ed76478437958d@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
References: <44B6A805.2040307@gmail.com>
	 <7edfeeef0607131330j3063325en7ed76478437958d@mail.gmail.com>

On 7/13/06, Garrett Rooney <rooneg@electricjellyfish.net> wrote:
> On 7/13/06, James M Snell <jasnell@gmail.com> wrote:
> > There are a number of aspects of the model api that have been bugging me
> > for some time.
> >
> > For instance,
> >
> > Feed.getEntries() returns a List, however, Feed.getEntries().add(...)
> > doesn't actually do anything.  It makes more sense for Feed.getEntries()
> > to return an Iterator given that it's primary purpose is iterating
> > through the entries.  Doing so also allows us to optimize the underlying
> >  Axiom code (which provides efficient element iterators).
>
>  Returning an Iterator at least makes it clear
> that there was no deep copy type semantics going on.

FWIW, the Java convention is to use a List. See
Collections.unmodifiableList(), etc.

-- 

Robert Sayre

"I would have written a shorter letter, but I did not have the time."