equal
deleted
inserted
replaced
1 /* |
1 /* |
2 * Copyright (c) 2003, 2016, Oracle and/or its affiliates. All rights reserved. |
2 * Copyright (c) 2003, 2017, Oracle and/or its affiliates. All rights reserved. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
4 * |
4 * |
5 * This code is free software; you can redistribute it and/or modify it |
5 * This code is free software; you can redistribute it and/or modify it |
6 * under the terms of the GNU General Public License version 2 only, as |
6 * under the terms of the GNU General Public License version 2 only, as |
7 * published by the Free Software Foundation. Oracle designates this |
7 * published by the Free Software Foundation. Oracle designates this |
29 import javax.xml.namespace.QName; |
29 import javax.xml.namespace.QName; |
30 import org.xml.sax.InputSource; |
30 import org.xml.sax.InputSource; |
31 |
31 |
32 /** |
32 /** |
33 * {@code XPath} provides access to the XPath evaluation environment and expressions. |
33 * {@code XPath} provides access to the XPath evaluation environment and expressions. |
34 * |
34 * The XPath evaluation is affected by the factors described in the following table. |
35 * <a name="XPath-evaluation"></a> |
35 * |
36 * <table border="1" cellpadding="2"> |
36 * <a id="XPath-evaluation"></a> |
|
37 * <table class="striped"> |
|
38 * <caption>Evaluation of XPath Expressions</caption> |
37 * <thead> |
39 * <thead> |
38 * <tr> |
40 * <tr> |
39 * <th colspan="2">Evaluation of XPath Expressions.</th> |
41 * <th>Factor</th> |
|
42 * <th>Behavior</th> |
40 * </tr> |
43 * </tr> |
41 * </thead> |
44 * </thead> |
|
45 * <tbody> |
42 * <tr> |
46 * <tr> |
43 * <td>context</td> |
47 * <td>context</td> |
44 * <td> |
48 * <td> |
45 * The type of the context is implementation-dependent. If the value is |
49 * The type of the context is implementation-dependent. If the value is |
46 * null, the operation must have no dependency on the context, otherwise |
50 * null, the operation must have no dependency on the context, otherwise |
82 * This result of evaluating an expression is converted to an instance of the desired return type. |
86 * This result of evaluating an expression is converted to an instance of the desired return type. |
83 * Valid return types are defined in {@link XPathConstants}. |
87 * Valid return types are defined in {@link XPathConstants}. |
84 * Conversion to the return type follows XPath conversion rules. |
88 * Conversion to the return type follows XPath conversion rules. |
85 * </td> |
89 * </td> |
86 * </tr> |
90 * </tr> |
|
91 * </tbody> |
87 * </table> |
92 * </table> |
88 * |
93 * |
89 * <p>An XPath object is not thread-safe and not reentrant. |
94 * <p>An XPath object is not thread-safe and not reentrant. |
90 * In other words, it is the application's responsibility to make |
95 * In other words, it is the application's responsibility to make |
91 * sure that one {@link XPath} object is not used from |
96 * sure that one {@link XPath} object is not used from |