You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by ASHWIN Suresh <a....@sigmatel.net.ma> on 2003/12/02 00:17:01 UTC

AMap name


> -----Original Message-----
> From: Michael Heuer [mailto:heuermh@acm.org]
> Sent: Monday, December 01, 2003 22:56
> To: Jakarta Commons Developers List

> 
> Might the name IterateableMap or IteratableMap (the proper spelling
> alludes me) be more descriptive than AMap?
> 
>    michael


Going by the standard pattern, it would be "IterableMap".

[Pattern: -ation > -able ]

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Re: [collections] AMap/IterableMap name

Posted by Stephen Colebourne <sc...@btopenworld.com>.
IterableMap it is, now on CVS
Stephen

----- Original Message ----- 
From: "Brian McCallister" <mc...@forthillcompany.com>
To: "Jakarta Commons Developers List" <co...@jakarta.apache.org>
Sent: Tuesday, December 02, 2003 11:00 PM
Subject: Re: [collections] AMap/IterableMap name


> non-binding +1 on IterableMap
> 
> It is longer, but Map2 is painful.
> 
> -Brian
> 
> On Tuesday, December 2, 2003, at 04:22 PM, Stephen Colebourne wrote:
> 
> > There is no obvious 'standard' to follow here, other than adding '2' 
> > to the
> > end (LayoutManager2). But even Sun tends to use descriptive alternate 
> > names
> > a lot of the time (Map to replace Dictionary etc.)
> >
> > I'll probably change it to IterableMap unless anyone has better ideas.
> >
> > Stephen
> >
> > ----- Original Message -----
> > From: "__matthewHawthorne" <ma...@phreaker.net>
> >> Stephen Colebourne wrote:
> >>> I can think of various possible names:
> >>>  Map2 - follows Sun naming standards for replacing interfaces
> >>>  MapA - similar idea, but doesn't clash if Sun ever creates Map2
> >>>  AMap - similar idea but reversed (A is for Apache)
> >>>  IMap - similar idea, but I is for interface
> >>>  IterableMap - the long name
> >>>
> >>> If people favour IterableMap, then thats fine. I was looking for
> > something
> >>> short to indicate that this should be a general replacement to using
> > Map.
> >>> Maybe IterableMap is clearer though
> >>>
> >>> Naming opinions please?
> >>
> >> I like IterableMap, but I can also see why you wanted a short name.
> >>
> >> What about XMap or MapX, to indicate a "Map extension", like the 
> >> javax.*
> >> packages?
> >>
> >> Similarly, HashMapX and XHashMap could be used instead of HashedMap.
> >>
> >> It's kind of a strange situation, but it would be nice to come up 
> >> with a
> >> nice naming standard for classes which can replace their JDK
> >> counterparts.   Any other suggestions?
> >>
> >>
> >> ---------------------------------------------------------------------
> >> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> >> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> >>
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> > For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> >
> >
> 
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> 


---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Re: [collections] AMap/IterableMap name

Posted by Brian McCallister <mc...@forthillcompany.com>.
non-binding +1 on IterableMap

It is longer, but Map2 is painful.

-Brian

On Tuesday, December 2, 2003, at 04:22 PM, Stephen Colebourne wrote:

> There is no obvious 'standard' to follow here, other than adding '2' 
> to the
> end (LayoutManager2). But even Sun tends to use descriptive alternate 
> names
> a lot of the time (Map to replace Dictionary etc.)
>
> I'll probably change it to IterableMap unless anyone has better ideas.
>
> Stephen
>
> ----- Original Message -----
> From: "__matthewHawthorne" <ma...@phreaker.net>
>> Stephen Colebourne wrote:
>>> I can think of various possible names:
>>>  Map2 - follows Sun naming standards for replacing interfaces
>>>  MapA - similar idea, but doesn't clash if Sun ever creates Map2
>>>  AMap - similar idea but reversed (A is for Apache)
>>>  IMap - similar idea, but I is for interface
>>>  IterableMap - the long name
>>>
>>> If people favour IterableMap, then thats fine. I was looking for
> something
>>> short to indicate that this should be a general replacement to using
> Map.
>>> Maybe IterableMap is clearer though
>>>
>>> Naming opinions please?
>>
>> I like IterableMap, but I can also see why you wanted a short name.
>>
>> What about XMap or MapX, to indicate a "Map extension", like the 
>> javax.*
>> packages?
>>
>> Similarly, HashMapX and XHashMap could be used instead of HashedMap.
>>
>> It's kind of a strange situation, but it would be nice to come up 
>> with a
>> nice naming standard for classes which can replace their JDK
>> counterparts.   Any other suggestions?
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
>> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>
>



---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Re: [collections] AMap/IterableMap name

Posted by Stephen Colebourne <sc...@btopenworld.com>.
There is no obvious 'standard' to follow here, other than adding '2' to the
end (LayoutManager2). But even Sun tends to use descriptive alternate names
a lot of the time (Map to replace Dictionary etc.)

I'll probably change it to IterableMap unless anyone has better ideas.

Stephen

----- Original Message -----
From: "__matthewHawthorne" <ma...@phreaker.net>
> Stephen Colebourne wrote:
> > I can think of various possible names:
> >  Map2 - follows Sun naming standards for replacing interfaces
> >  MapA - similar idea, but doesn't clash if Sun ever creates Map2
> >  AMap - similar idea but reversed (A is for Apache)
> >  IMap - similar idea, but I is for interface
> >  IterableMap - the long name
>  >
> > If people favour IterableMap, then thats fine. I was looking for
something
> > short to indicate that this should be a general replacement to using
Map.
> > Maybe IterableMap is clearer though
> >
> > Naming opinions please?
>
> I like IterableMap, but I can also see why you wanted a short name.
>
> What about XMap or MapX, to indicate a "Map extension", like the javax.*
> packages?
>
> Similarly, HashMapX and XHashMap could be used instead of HashedMap.
>
> It's kind of a strange situation, but it would be nice to come up with a
> nice naming standard for classes which can replace their JDK
> counterparts.   Any other suggestions?
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>


---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Re: [collections] AMap/IterableMap name

Posted by __matthewHawthorne <ma...@phreaker.net>.
Stephen Colebourne wrote:
> I can think of various possible names:
>  Map2 - follows Sun naming standards for replacing interfaces
>  MapA - similar idea, but doesn't clash if Sun ever creates Map2
>  AMap - similar idea but reversed (A is for Apache)
>  IMap - similar idea, but I is for interface
>  IterableMap - the long name
 >
> If people favour IterableMap, then thats fine. I was looking for something
> short to indicate that this should be a general replacement to using Map.
> Maybe IterableMap is clearer though
> 
> Naming opinions please?

I like IterableMap, but I can also see why you wanted a short name.

What about XMap or MapX, to indicate a "Map extension", like the javax.* 
packages?

Similarly, HashMapX and XHashMap could be used instead of HashedMap.

It's kind of a strange situation, but it would be nice to come up with a 
nice naming standard for classes which can replace their JDK 
counterparts.   Any other suggestions?


---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Re: [collections] AMap/IterableMap name

Posted by Michael Heuer <he...@acm.org>.
On Tue, 2 Dec 2003, Stephen Colebourne wrote:

> AMap is a new interface that extends Map to provide one extra method
>   MapIterator mapIterator()
>
> I can think of various possible names:
>  Map2 - follows Sun naming standards for replacing interfaces
>  MapA - similar idea, but doesn't clash if Sun ever creates Map2
>  AMap - similar idea but reversed (A is for Apache)

+0

>  IMap - similar idea, but I is for interface

-0

>  IterableMap - the long name

+1

> If people favour IterableMap, then thats fine. I was looking for something
> short to indicate that this should be a general replacement to using Map.
> Maybe IterableMap is clearer though
>
> Naming opinions please?
>
> Stephen
> PS. The new implementation HashedMap is also checked in. Naming views on
> this are also welcomed plus a proper code review!!
> And I even discovered a small performance error in the JDK HashMap.
>
>
> ----- Original Message -----
> From: "ASHWIN Suresh" <a....@sigmatel.net.ma>
> > > -----Original Message-----
> > > From: Michael Heuer [mailto:heuermh@acm.org]
> > > Sent: Monday, December 01, 2003 22:56
> > > To: Jakarta Commons Developers List
> >
> > >
> > > Might the name IterateableMap or IteratableMap (the proper spelling
> > > alludes me) be more descriptive than AMap?
> > >
> > >    michael
> >
> >
> > Going by the standard pattern, it would be "IterableMap".
> >
> > [Pattern: -ation > -able ]
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> > For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> >
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>
>


---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Re: [collections] AMap/IterableMap name

Posted by Stephen Colebourne <sc...@btopenworld.com>.
AMap is a new interface that extends Map to provide one extra method
  MapIterator mapIterator()

I can think of various possible names:
 Map2 - follows Sun naming standards for replacing interfaces
 MapA - similar idea, but doesn't clash if Sun ever creates Map2
 AMap - similar idea but reversed (A is for Apache)
 IMap - similar idea, but I is for interface
 IterableMap - the long name

If people favour IterableMap, then thats fine. I was looking for something
short to indicate that this should be a general replacement to using Map.
Maybe IterableMap is clearer though

Naming opinions please?

Stephen
PS. The new implementation HashedMap is also checked in. Naming views on
this are also welcomed plus a proper code review!!
And I even discovered a small performance error in the JDK HashMap.


----- Original Message -----
From: "ASHWIN Suresh" <a....@sigmatel.net.ma>
> > -----Original Message-----
> > From: Michael Heuer [mailto:heuermh@acm.org]
> > Sent: Monday, December 01, 2003 22:56
> > To: Jakarta Commons Developers List
>
> >
> > Might the name IterateableMap or IteratableMap (the proper spelling
> > alludes me) be more descriptive than AMap?
> >
> >    michael
>
>
> Going by the standard pattern, it would be "IterableMap".
>
> [Pattern: -ation > -able ]
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>


---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org