Debian Codegraph @

src/java/org/apache/commons/collections/functors/package.html

raw
1 <!-- $Id: package.html 1713849 2015-11-11 14:21:37Z tn $ -->
2 <!--
3 Licensed to the Apache Software Foundation (ASF) under one or more
4 contributor license agreements. See the NOTICE file distributed with
5 this work for additional information regarding copyright ownership.
6 The ASF licenses this file to You under the Apache License, Version 2.0
7 (the "License"); you may not use this file except in compliance with
8 the License. You may obtain a copy of the License at
9
10 http://www.apache.org/licenses/LICENSE-2.0
11
12 Unless required by applicable law or agreed to in writing, software
13 distributed under the License is distributed on an "AS IS" BASIS,
14 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 See the License for the specific language governing permissions and
16 limitations under the License.
17 -->
18 <BODY>
19 <p>
20 This package contains implementations of the
21 {@link org.apache.commons.collections.Closure Closure},
22 {@link org.apache.commons.collections.Predicate Predicate},
23 {@link org.apache.commons.collections.Transformer Transformer} and
24 {@link org.apache.commons.collections.Factory Factory} interfaces.
25 These provide simple callbacks for processing with collections.
26 </p>
27 <p>
28 <b>WARNING:</b> from v3.2.2 onwards this several classes in this package will
29 throw an {@link UnsupportedOperationException} when trying to serialize or
30 de-serialize an instance to prevent potential remote code execution exploits.
31 </p>
32 <p>
33 Classes considered to be unsafe are:
34 </p>
35 <ul>
36 <li>CloneTransformer</li>
37 <li>ForClosure</li>
38 <li>InstantiateFactory</li>
39 <li>InstantiateTransformer</li>
40 <li>InvokerTransformer</li>
41 <li>PrototypeFactory$PrototypeCloneFactory</li>
42 <li>PrototypeFactory$PrototypeSerializationFactory</li>
43 <li>WhileClosure</li>
44 </ul>
45 <p>
46 In order to re-enable serialization support for these unsafe classes, the
47 following system property can be used (via -Dproperty=true):
48 <pre>
49 org.apache.commons.collections.enableUnsafeSerialization
50 </pre>
51 <p>
52 Be warned though that enabling serialization support for these unsafe classes
53 makes your application vulnerable to known exploits and you must ensure that
54 your application does not de-serialize objects from untrusted sources.
55 </p>
56
57 </BODY>