RE: Addition to XAPI: getNames()

2002-11-28 Thread Ford, Trevor
 simply use the deprecated flag for the getName() method.
 
Indeed!

 I thought about :
 Iterator getNames()
 
 and maybe
 String[] getNames()
 
 would be better since it's much easier to initialize statically
 
I would also prefer the second version (return a String[]), because this
feels like it fits in better with the API's style (as there are already a
few methods which return arrays, but none which return an Iterator).
In addition, having the entries in a String[] saves users from casting
Iterator contents to Strings when iterating through them.

 -Vladimir
 
 -- 
 Vladimir R. Bossicard
 www.bossicard.com

Cheers,
Trevor.
--
Post a message: mailto:[EMAIL PROTECTED]
Unsubscribe:mailto:[EMAIL PROTECTED]
Contact administrator:  mailto:[EMAIL PROTECTED]
Read archived messages: http://archive.xmldb.org/
--


Re: Addition to XAPI: getNames()

2002-11-28 Thread Lars Martin
On Thu, 28 Nov 2002 10:50:57 -0700
Ford, Trevor [EMAIL PROTECTED] wrote:

  simply use the deprecated flag for the getName() method.
  
 Indeed!
 
  I thought about :
  Iterator getNames()
  
  and maybe
  String[] getNames()
  
  would be better since it's much easier to initialize statically
  
 I would also prefer the second version (return a String[]), because this
 feels like it fits in better with the API's style (as there are already a
 few methods which return arrays, but none which return an Iterator).
 In addition, having the entries in a String[] saves users from casting
 Iterator contents to Strings when iterating through them.

Sounds all reasonable. I'll try to update the API and sample apps and
let you know my results.
Kindest regards, Lars.
--
__
Lars Martin mailto:[EMAIL PROTECTED]
SMB GmbHhttp://www.smb-tec.com
D-04347 LeipzigRohrteichstrasse 18
Tel: +49-(0)341-699 46 04Fax: +49-(0)341-699 47 04
Product Management BusinessServer BS1

--
Post a message: mailto:[EMAIL PROTECTED]
Unsubscribe:mailto:[EMAIL PROTECTED]
Contact administrator:  mailto:[EMAIL PROTECTED]
Read archived messages: http://archive.xmldb.org/
--


Re: Addition to XAPI: getNames()

2002-11-28 Thread Vladimir R. Bossicard
Whilst I agree that getName() is a special case of getNames(), isn't it
perhaps a bit harsh to remove getName() - this would break all of the 
applications which are directly using the getName() method.
(Even if all driver vendors update their implementations immediately.)

Perhaps it is better to leave it in, but making it clear that the method
will be removed later?
simply use the deprecated flag for the getName() method.

I thought about :
   Iterator getNames()
and maybe
   String[] getNames()
would be better since it's much easier to initialize statically

-Vladimir

--
Vladimir R. Bossicard
www.bossicard.com
--
Post a message: mailto:[EMAIL PROTECTED]
Unsubscribe:mailto:[EMAIL PROTECTED]
Contact administrator:  mailto:[EMAIL PROTECTED]
Read archived messages: http://archive.xmldb.org/
--


Addition to XAPI: getNames()

2002-11-27 Thread Lars Martin
On Tue, 26 Nov 2002 14:49:23 +0100
Per Nyfelt [EMAIL PROTECTED] wrote:

 No, sounds good to add getNames().

Ok, I would like to add this extension. But what's the behaviour of a
vendor implementation? Does such an implementation needs to implement
both getters for a single name and a sequence of names?
Does registerDatabase() need to retrieve names through both getters?
I see getName() as a special case of getNames() so may be we should
omit the getName() method?

Kindest regards, Lars
--
__
Lars Martin mailto:[EMAIL PROTECTED]
SMB GmbHhttp://www.smb-tec.com
D-04347 LeipzigRohrteichstrasse 18
Tel: +49-(0)341-699 46 04Fax: +49-(0)341-699 47 04
Product Management BusinessServer BS1

--
Post a message: mailto:[EMAIL PROTECTED]
Unsubscribe:mailto:[EMAIL PROTECTED]
Contact administrator:  mailto:[EMAIL PROTECTED]
Read archived messages: http://archive.xmldb.org/
--


RE: Addition to XAPI: getNames()

2002-11-27 Thread Ford, Trevor
 Ok, I would like to add this extension. But what's the behaviour of a
 vendor implementation? Does such an implementation needs to implement
 both getters for a single name and a sequence of names?
 Does registerDatabase() need to retrieve names through both getters?
 I see getName() as a special case of getNames() so may be we should
 omit the getName() method?

Whilst I agree that getName() is a special case of getNames(), isn't it
perhaps a bit harsh to remove getName() - this would break all of the 
applications which are directly using the getName() method.
(Even if all driver vendors update their implementations immediately.)

Perhaps it is better to leave it in, but making it clear that the method
will be removed later?

 Kindest regards, Lars

Thanks,
Trevor.
--
Post a message: mailto:[EMAIL PROTECTED]
Unsubscribe:mailto:[EMAIL PROTECTED]
Contact administrator:  mailto:[EMAIL PROTECTED]
Read archived messages: http://archive.xmldb.org/
--