You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by Henri Biestro <he...@apache.org> on 2011/11/27 19:34:40 UTC

[VOTE] Release JEXL 2.1 based on RC1

Dear all,

After a pretty long cycle, JEXL 2.1 is ready for review.
Here is a quick list of new features (from the release notes):

What's new in 2.1:
==================
* A more thorough arithmetic (JexlArithmetic) that allows fine control over decimals (scale and precision), a
  new syntax for numeric literals (OGNL inspired Big and Huge notations) and a better type handling keeping the most
  appropriate representation in casual operations.
* The introduction of script variables and parameters that reduce context dependencies and methods; this allows to
  perform checks after script creation (light static checking hints). Plus the ability to call script from scripts.
* A sandoxing feature to restrict and rename what JEXL can access from the environment allowing tighter control over security.
* Extensions to UnifiedJEXL that allow the creation of templates.

New features in 2.1:
====================	
* JEXL-114:     Allow scripts to create local variables // Add return keyword
* JEXL-113:     Add functions to extract which variables, parameters and local variables are used to evaluate a script
* JEXL-118:     Provide an IN operator
* JEXL-115:     Add support for asynchronous script execution and cancellation
* JEXL-116:     Add control over classes, methods, constructors and properties allowed in scripts
* JEXL-120:     Add simple template features
* JEXL-119:     Allow indexed properties container resolution in expressions

Tested against Java 1.{5,6} / Maven{2,3}, Windows 7/Linux/Mac OS.

Tag: 

https://svn.apache.org/repos/asf/commons/proper/jexl/tags/COMMONS_JEXL_2_1_RC1/

Site: 

https://people.apache.org/~henrib/jexl-2.1

Binaries:

 https://repository.apache.org/content/repositories/orgapachecommons-258/

This vote will close in 72 hours, 08:00PM GMT, Nov 30th.

  [ ] +1 Release these artifacts
  [ ] +0 OK, but...
  [ ] -0 OK, but really should fix...
  [ ] -1 I oppose this release because...

Many thanks,
Regards.
Henrib



Re: [VOTE] Release JEXL 2.1 based on RC1

Posted by sebb <se...@gmail.com>.
On 28 November 2011 14:30, sebb <se...@gmail.com> wrote:
> On 28 November 2011 14:19, henrib <he...@apache.org> wrote:
>> Thanks for tidying up my mess.
>>
>> About org.apache.commons.jexl2.UnifiedJEXL$Expression, its subclasses are
>> private because only that base class is supposed to be usable by end-users;
>> one declares 'UnifiedJEXL.Expression expr' and the engine manages the rest.
>
> That's a pity.
>
>> org.apache.commons.jexl2.internal is definitely internal (sic :-)).
>
> OK, I'll exclude it.

Done.

>> org.apache.commons.jexl2.introspection is intended to be used as a base to
>> customization so should be considered public  (albeit most likely never used
>> by anyone); Uberspect.getConstructor was not carrying the proper signature
>> in 2.0.x.

Would it be possible to add a new method to the Impl that has the
correct sig and deprecate the old one?
e.g. getConstructorMethod ?

If the interface is unlikely to be directly used externally, then it
might be OK to allow that as an API break.

>>
>> The amount of work to try to make the release binary compatible seems
>> unfortunately much greater than switching to a new package name...
>
> Are you sure?
>
> I thought so originally with NET which needed quite a major refactor,
> but found that I could add new methods and deprecate old ones.
>
> I'm happy to do some of the work, but as indicated I'm not entirely
> sure what is intended to be external.
>
>> Thanks again for your help,
>> Henrib
>>
>>
>> --
>> View this message in context: http://apache-commons.680414.n4.nabble.com/VOTE-Release-JEXL-2-1-based-on-RC1-tp4113403p4115331.html
>> Sent from the Commons - Dev mailing list archive at Nabble.com.
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>>
>>
>

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


Re: [VOTE] Release JEXL 2.1 based on RC1

Posted by sebb <se...@gmail.com>.
On 28 November 2011 14:19, henrib <he...@apache.org> wrote:
> Thanks for tidying up my mess.
>
> About org.apache.commons.jexl2.UnifiedJEXL$Expression, its subclasses are
> private because only that base class is supposed to be usable by end-users;
> one declares 'UnifiedJEXL.Expression expr' and the engine manages the rest.

That's a pity.

> org.apache.commons.jexl2.internal is definitely internal (sic :-)).

OK, I'll exclude it.

> org.apache.commons.jexl2.introspection is intended to be used as a base to
> customization so should be considered public  (albeit most likely never used
> by anyone); Uberspect.getConstructor was not carrying the proper signature
> in 2.0.x.
>
> The amount of work to try to make the release binary compatible seems
> unfortunately much greater than switching to a new package name...

Are you sure?

I thought so originally with NET which needed quite a major refactor,
but found that I could add new methods and deprecate old ones.

I'm happy to do some of the work, but as indicated I'm not entirely
sure what is intended to be external.

> Thanks again for your help,
> Henrib
>
>
> --
> View this message in context: http://apache-commons.680414.n4.nabble.com/VOTE-Release-JEXL-2-1-based-on-RC1-tp4113403p4115331.html
> Sent from the Commons - Dev mailing list archive at Nabble.com.
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>

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


Re: [VOTE] Release JEXL 2.1 based on RC1

Posted by henrib <he...@apache.org>.
Thanks for tidying up my mess.

About org.apache.commons.jexl2.UnifiedJEXL$Expression, its subclasses are
private because only that base class is supposed to be usable by end-users;
one declares 'UnifiedJEXL.Expression expr' and the engine manages the rest.

org.apache.commons.jexl2.internal is definitely internal (sic :-)).

org.apache.commons.jexl2.introspection is intended to be used as a base to
customization so should be considered public  (albeit most likely never used
by anyone); Uberspect.getConstructor was not carrying the proper signature
in 2.0.x.

The amount of work to try to make the release binary compatible seems
unfortunately much greater than switching to a new package name...

Thanks again for your help,
Henrib


--
View this message in context: http://apache-commons.680414.n4.nabble.com/VOTE-Release-JEXL-2-1-based-on-RC1-tp4113403p4115331.html
Sent from the Commons - Dev mailing list archive at Nabble.com.

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


Re: [VOTE] Release JEXL 2.1 based on RC1

Posted by sebb <se...@gmail.com>.
On 28 November 2011 09:40, sebb <se...@gmail.com> wrote:
> On 28 November 2011 01:40, sebb <se...@gmail.com> wrote:
>> On 28 November 2011 01:03, Gary Gregory <ga...@gmail.com> wrote:
>>> I see 35 Clirr Errors that point to backwards incompatibility.
>>
>> Many of these relate to the parser, which is not really part of the public API.
>
> Just checked, and the clirr plugin supports an excludes configuration
> element which could be used to ignore these.

I've fixed the pom so it ignores the parser classes (and tidied up a
bit; there were some unnecessary entries).

There are possibly one or two other ignorable classes - e.g. the nested class

org.apache.commons.jexl2.UnifiedJEXL$Expression

All its existing subclasses are private, so I wonder why it is public?

It's OK to break binary compat if the class is not part of the API, so
it's worth checking what is public because it is part of the API and
what is public merely because the code uses multiple package names
(and so needs public rather than package access).

What about the following packages:

org.apache.commons.jexl2.internal
org.apache.commons.jexl2.introspection

I assume the former is not part of the API - what about the latter?

>> However, there are some which do look like they break binary compatibility
>>
>>> So... do we have a Commons-wide policy of changing package names and making
>>> a major release (3.0 vs. 2.1 here) or not?
>>
>> I think Jexl should be binary compatible.
>>
>> If the changes cannot be re-done in a binary compatible way, then I
>> think Jexl needs a major release and package change.
>>
>>> Gary
>>>
>>> On Sun, Nov 27, 2011 at 1:34 PM, Henri Biestro <he...@apache.org> wrote:
>>>
>>>>
>>>> Dear all,
>>>>
>>>> After a pretty long cycle, JEXL 2.1 is ready for review.
>>>> Here is a quick list of new features (from the release notes):
>>>>
>>>> What's new in 2.1:
>>>> ==================
>>>> * A more thorough arithmetic (JexlArithmetic) that allows fine control
>>>> over decimals (scale and precision), a
>>>>  new syntax for numeric literals (OGNL inspired Big and Huge notations)
>>>> and a better type handling keeping the most
>>>>  appropriate representation in casual operations.
>>>> * The introduction of script variables and parameters that reduce context
>>>> dependencies and methods; this allows to
>>>>  perform checks after script creation (light static checking hints). Plus
>>>> the ability to call script from scripts.
>>>> * A sandoxing feature to restrict and rename what JEXL can access from the
>>>> environment allowing tighter control over security.
>>>> * Extensions to UnifiedJEXL that allow the creation of templates.
>>>>
>>>> New features in 2.1:
>>>> ====================
>>>> * JEXL-114:     Allow scripts to create local variables // Add return
>>>> keyword
>>>> * JEXL-113:     Add functions to extract which variables, parameters and
>>>> local variables are used to evaluate a script
>>>> * JEXL-118:     Provide an IN operator
>>>> * JEXL-115:     Add support for asynchronous script execution and
>>>> cancellation
>>>> * JEXL-116:     Add control over classes, methods, constructors and
>>>> properties allowed in scripts
>>>> * JEXL-120:     Add simple template features
>>>> * JEXL-119:     Allow indexed properties container resolution in
>>>> expressions
>>>>
>>>> Tested against Java 1.{5,6} / Maven{2,3}, Windows 7/Linux/Mac OS.
>>>>
>>>> Tag:
>>>>
>>>>
>>>> https://svn.apache.org/repos/asf/commons/proper/jexl/tags/COMMONS_JEXL_2_1_RC1/
>>>>
>>>> Site:
>>>>
>>>> https://people.apache.org/~henrib/jexl-2.1
>>>>
>>>> Binaries:
>>>>
>>>>  https://repository.apache.org/content/repositories/orgapachecommons-258/
>>>>
>>>> This vote will close in 72 hours, 08:00PM GMT, Nov 30th.
>>>>
>>>>  [ ] +1 Release these artifacts
>>>>  [ ] +0 OK, but...
>>>>  [ ] -0 OK, but really should fix...
>>>>  [ ] -1 I oppose this release because...
>>>>
>>>> Many thanks,
>>>> Regards.
>>>> Henrib
>>>>
>>>>
>>>>
>>>
>>>
>>> --
>>> E-Mail: garydgregory@gmail.com | ggregory@apache.org
>>> JUnit in Action, 2nd Ed: <http://goog_1249600977>http://bit.ly/ECvg0
>>> Spring Batch in Action: <http://s.apache.org/HOq>http://bit.ly/bqpbCK
>>> Blog: http://garygregory.wordpress.com
>>> Home: http://garygregory.com/
>>> Tweet! http://twitter.com/GaryGregory
>>>
>>
>

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


Re: [VOTE] Release JEXL 2.1 based on RC1

Posted by sebb <se...@gmail.com>.
On 28 November 2011 01:40, sebb <se...@gmail.com> wrote:
> On 28 November 2011 01:03, Gary Gregory <ga...@gmail.com> wrote:
>> I see 35 Clirr Errors that point to backwards incompatibility.
>
> Many of these relate to the parser, which is not really part of the public API.

Just checked, and the clirr plugin supports an excludes configuration
element which could be used to ignore these.

> However, there are some which do look like they break binary compatibility
>
>> So... do we have a Commons-wide policy of changing package names and making
>> a major release (3.0 vs. 2.1 here) or not?
>
> I think Jexl should be binary compatible.
>
> If the changes cannot be re-done in a binary compatible way, then I
> think Jexl needs a major release and package change.
>
>> Gary
>>
>> On Sun, Nov 27, 2011 at 1:34 PM, Henri Biestro <he...@apache.org> wrote:
>>
>>>
>>> Dear all,
>>>
>>> After a pretty long cycle, JEXL 2.1 is ready for review.
>>> Here is a quick list of new features (from the release notes):
>>>
>>> What's new in 2.1:
>>> ==================
>>> * A more thorough arithmetic (JexlArithmetic) that allows fine control
>>> over decimals (scale and precision), a
>>>  new syntax for numeric literals (OGNL inspired Big and Huge notations)
>>> and a better type handling keeping the most
>>>  appropriate representation in casual operations.
>>> * The introduction of script variables and parameters that reduce context
>>> dependencies and methods; this allows to
>>>  perform checks after script creation (light static checking hints). Plus
>>> the ability to call script from scripts.
>>> * A sandoxing feature to restrict and rename what JEXL can access from the
>>> environment allowing tighter control over security.
>>> * Extensions to UnifiedJEXL that allow the creation of templates.
>>>
>>> New features in 2.1:
>>> ====================
>>> * JEXL-114:     Allow scripts to create local variables // Add return
>>> keyword
>>> * JEXL-113:     Add functions to extract which variables, parameters and
>>> local variables are used to evaluate a script
>>> * JEXL-118:     Provide an IN operator
>>> * JEXL-115:     Add support for asynchronous script execution and
>>> cancellation
>>> * JEXL-116:     Add control over classes, methods, constructors and
>>> properties allowed in scripts
>>> * JEXL-120:     Add simple template features
>>> * JEXL-119:     Allow indexed properties container resolution in
>>> expressions
>>>
>>> Tested against Java 1.{5,6} / Maven{2,3}, Windows 7/Linux/Mac OS.
>>>
>>> Tag:
>>>
>>>
>>> https://svn.apache.org/repos/asf/commons/proper/jexl/tags/COMMONS_JEXL_2_1_RC1/
>>>
>>> Site:
>>>
>>> https://people.apache.org/~henrib/jexl-2.1
>>>
>>> Binaries:
>>>
>>>  https://repository.apache.org/content/repositories/orgapachecommons-258/
>>>
>>> This vote will close in 72 hours, 08:00PM GMT, Nov 30th.
>>>
>>>  [ ] +1 Release these artifacts
>>>  [ ] +0 OK, but...
>>>  [ ] -0 OK, but really should fix...
>>>  [ ] -1 I oppose this release because...
>>>
>>> Many thanks,
>>> Regards.
>>> Henrib
>>>
>>>
>>>
>>
>>
>> --
>> E-Mail: garydgregory@gmail.com | ggregory@apache.org
>> JUnit in Action, 2nd Ed: <http://goog_1249600977>http://bit.ly/ECvg0
>> Spring Batch in Action: <http://s.apache.org/HOq>http://bit.ly/bqpbCK
>> Blog: http://garygregory.wordpress.com
>> Home: http://garygregory.com/
>> Tweet! http://twitter.com/GaryGregory
>>
>

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


Re: [VOTE] Release JEXL 2.1 based on RC1

Posted by henrib <he...@apache.org>.
Cancelled vote.
Henrib

--
View this message in context: http://apache-commons.680414.n4.nabble.com/VOTE-Release-JEXL-2-1-based-on-RC1-tp4113403p4114453.html
Sent from the Commons - Dev mailing list archive at Nabble.com.

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


Re: [VOTE] Release JEXL 2.1 based on RC1

Posted by sebb <se...@gmail.com>.
On 28 November 2011 01:03, Gary Gregory <ga...@gmail.com> wrote:
> I see 35 Clirr Errors that point to backwards incompatibility.

Many of these relate to the parser, which is not really part of the public API.

However, there are some which do look like they break binary compatibility

> So... do we have a Commons-wide policy of changing package names and making
> a major release (3.0 vs. 2.1 here) or not?

I think Jexl should be binary compatible.

If the changes cannot be re-done in a binary compatible way, then I
think Jexl needs a major release and package change.

> Gary
>
> On Sun, Nov 27, 2011 at 1:34 PM, Henri Biestro <he...@apache.org> wrote:
>
>>
>> Dear all,
>>
>> After a pretty long cycle, JEXL 2.1 is ready for review.
>> Here is a quick list of new features (from the release notes):
>>
>> What's new in 2.1:
>> ==================
>> * A more thorough arithmetic (JexlArithmetic) that allows fine control
>> over decimals (scale and precision), a
>>  new syntax for numeric literals (OGNL inspired Big and Huge notations)
>> and a better type handling keeping the most
>>  appropriate representation in casual operations.
>> * The introduction of script variables and parameters that reduce context
>> dependencies and methods; this allows to
>>  perform checks after script creation (light static checking hints). Plus
>> the ability to call script from scripts.
>> * A sandoxing feature to restrict and rename what JEXL can access from the
>> environment allowing tighter control over security.
>> * Extensions to UnifiedJEXL that allow the creation of templates.
>>
>> New features in 2.1:
>> ====================
>> * JEXL-114:     Allow scripts to create local variables // Add return
>> keyword
>> * JEXL-113:     Add functions to extract which variables, parameters and
>> local variables are used to evaluate a script
>> * JEXL-118:     Provide an IN operator
>> * JEXL-115:     Add support for asynchronous script execution and
>> cancellation
>> * JEXL-116:     Add control over classes, methods, constructors and
>> properties allowed in scripts
>> * JEXL-120:     Add simple template features
>> * JEXL-119:     Allow indexed properties container resolution in
>> expressions
>>
>> Tested against Java 1.{5,6} / Maven{2,3}, Windows 7/Linux/Mac OS.
>>
>> Tag:
>>
>>
>> https://svn.apache.org/repos/asf/commons/proper/jexl/tags/COMMONS_JEXL_2_1_RC1/
>>
>> Site:
>>
>> https://people.apache.org/~henrib/jexl-2.1
>>
>> Binaries:
>>
>>  https://repository.apache.org/content/repositories/orgapachecommons-258/
>>
>> This vote will close in 72 hours, 08:00PM GMT, Nov 30th.
>>
>>  [ ] +1 Release these artifacts
>>  [ ] +0 OK, but...
>>  [ ] -0 OK, but really should fix...
>>  [ ] -1 I oppose this release because...
>>
>> Many thanks,
>> Regards.
>> Henrib
>>
>>
>>
>
>
> --
> E-Mail: garydgregory@gmail.com | ggregory@apache.org
> JUnit in Action, 2nd Ed: <http://goog_1249600977>http://bit.ly/ECvg0
> Spring Batch in Action: <http://s.apache.org/HOq>http://bit.ly/bqpbCK
> Blog: http://garygregory.wordpress.com
> Home: http://garygregory.com/
> Tweet! http://twitter.com/GaryGregory
>

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


Re: [VOTE] Release JEXL 2.1 based on RC1

Posted by Gary Gregory <ga...@gmail.com>.
I see 35 Clirr Errors that point to backwards incompatibility.

So... do we have a Commons-wide policy of changing package names and making
a major release (3.0 vs. 2.1 here) or not?

Gary

On Sun, Nov 27, 2011 at 1:34 PM, Henri Biestro <he...@apache.org> wrote:

>
> Dear all,
>
> After a pretty long cycle, JEXL 2.1 is ready for review.
> Here is a quick list of new features (from the release notes):
>
> What's new in 2.1:
> ==================
> * A more thorough arithmetic (JexlArithmetic) that allows fine control
> over decimals (scale and precision), a
>  new syntax for numeric literals (OGNL inspired Big and Huge notations)
> and a better type handling keeping the most
>  appropriate representation in casual operations.
> * The introduction of script variables and parameters that reduce context
> dependencies and methods; this allows to
>  perform checks after script creation (light static checking hints). Plus
> the ability to call script from scripts.
> * A sandoxing feature to restrict and rename what JEXL can access from the
> environment allowing tighter control over security.
> * Extensions to UnifiedJEXL that allow the creation of templates.
>
> New features in 2.1:
> ====================
> * JEXL-114:     Allow scripts to create local variables // Add return
> keyword
> * JEXL-113:     Add functions to extract which variables, parameters and
> local variables are used to evaluate a script
> * JEXL-118:     Provide an IN operator
> * JEXL-115:     Add support for asynchronous script execution and
> cancellation
> * JEXL-116:     Add control over classes, methods, constructors and
> properties allowed in scripts
> * JEXL-120:     Add simple template features
> * JEXL-119:     Allow indexed properties container resolution in
> expressions
>
> Tested against Java 1.{5,6} / Maven{2,3}, Windows 7/Linux/Mac OS.
>
> Tag:
>
>
> https://svn.apache.org/repos/asf/commons/proper/jexl/tags/COMMONS_JEXL_2_1_RC1/
>
> Site:
>
> https://people.apache.org/~henrib/jexl-2.1
>
> Binaries:
>
>  https://repository.apache.org/content/repositories/orgapachecommons-258/
>
> This vote will close in 72 hours, 08:00PM GMT, Nov 30th.
>
>  [ ] +1 Release these artifacts
>  [ ] +0 OK, but...
>  [ ] -0 OK, but really should fix...
>  [ ] -1 I oppose this release because...
>
> Many thanks,
> Regards.
> Henrib
>
>
>


-- 
E-Mail: garydgregory@gmail.com | ggregory@apache.org
JUnit in Action, 2nd Ed: <http://goog_1249600977>http://bit.ly/ECvg0
Spring Batch in Action: <http://s.apache.org/HOq>http://bit.ly/bqpbCK
Blog: http://garygregory.wordpress.com
Home: http://garygregory.com/
Tweet! http://twitter.com/GaryGregory