Petr Kuzel wrote:
> > >  - XMLAttributes.getName(int,QName)
> [...]
> 
> I did not have nothing against convenience methods in the interface.
> There is just overlook that getName() actually sets one.

This was so the caller provided the object that gets filled
in by the getName call. In this way I avoid returning the
object actually holding the data which would allow the code
to change the values "behind my back"; and also avoid
creating new objects to prevent the first case.

But, in the end, it may be cleaner to remove these and just
have setters/getters for the individual values.

> E.g.: http://nagoya.apache.org/bugzilla/show_bug.cgi?id=2213

Okay, I'll look at this.

> > >  - startEntity(String,...) name can start with
> > >     '%' denoting parameter entity
> > >     '#' denoting character entity ref
> > [...]
> 
> Right, if application enables it then it must be aware of
> consequences (i.e. proper handling of entity refs starting with '#').

Since it's not a default feature, then this should be
documented where the feature is documented and probably
not in the XNI javadoc.

-- 
Andy Clark * IBM, TRL - Japan * [EMAIL PROTECTED]

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to