-
Notifications
You must be signed in to change notification settings - Fork 78
/
JspPropertyGroupDescriptor.java
153 lines (137 loc) · 6.92 KB
/
JspPropertyGroupDescriptor.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
/*
* Copyright (c) 2017, 2021 Oracle and/or its affiliates and others.
* All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v. 2.0, which is available at
* http://www.eclipse.org/legal/epl-2.0.
*
* This Source Code may also be made available under the following Secondary
* Licenses when the conditions for such availability set forth in the
* Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
* version 2 with the GNU Classpath Exception, which is available at
* https://www.gnu.org/software/classpath/license.html.
*
* SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
*/
package jakarta.servlet.descriptor;
import java.util.Collection;
/**
* This interface provides access to the <code><jsp-property-group></code> related configuration of a web
* application.
*
* <p>
* The configuration is aggregated from the <code>web.xml</code> and <code>web-fragment.xml</code> descriptor files of
* the web application.
*
* @since Servlet 3.0
*/
public interface JspPropertyGroupDescriptor {
/**
* Gets the URL patterns of the JSP property group represented by this <code>JspPropertyGroupDescriptor</code>.
*
* <p>
* Any changes to the returned <code>Collection</code> must not affect this <code>JspPropertyGroupDescriptor</code>.
*
* @return a (possibly empty) <code>Collection</code> of the URL patterns of the JSP property group represented by this
* <code>JspPropertyGroupDescriptor</code>
*/
public Collection<String> getUrlPatterns();
/**
* Gets the value of the <code>el-ignored</code> configuration, which specifies whether Expression Language (EL)
* evaluation is enabled for any JSP pages mapped to the JSP property group represented by this
* <code>JspPropertyGroupDescriptor</code>.
*
* @return the value of the <code>el-ignored</code> configuration, or null if unspecified
*/
public String getElIgnored();
/**
* Will the use of an unknown identifier in EL within a JSP page trigger an error for this group?
*
* @return {@code true} if an error will be triggered, otherwise {@code false}
*/
public String getErrorOnELNotFound();
/**
* Gets the value of the <code>page-encoding</code> configuration, which specifies the default page encoding for any JSP
* pages mapped to the JSP property group represented by this <code>JspPropertyGroupDescriptor</code>.
*
* @return the value of the <code>page-encoding</code> configuration, or null if unspecified
*/
public String getPageEncoding();
/**
* Gets the value of the <code>scripting-invalid</code> configuration, which specifies whether scripting is enabled for
* any JSP pages mapped to the JSP property group represented by this <code>JspPropertyGroupDescriptor</code>.
*
* @return the value of the <code>scripting-invalid</code> configuration, or null if unspecified
*/
public String getScriptingInvalid();
/**
* Gets the value of the <code>is-xml</code> configuration, which specifies whether any JSP pages mapped to the JSP
* property group represented by this <code>JspPropertyGroupDescriptor</code> will be treated as JSP documents (XML
* syntax).
*
* @return the value of the <code>is-xml</code> configuration, or null if unspecified
*/
public String getIsXml();
/**
* Gets the <code>include-prelude</code> configuration of the JSP property group represented by this
* <code>JspPropertyGroupDescriptor</code>.
*
* <p>
* Any changes to the returned <code>Collection</code> must not affect this <code>JspPropertyGroupDescriptor</code>.
*
* @return a (possibly empty) <code>Collection</code> of the <code>include-prelude</code> configuration of the JSP
* property group represented by this <code>JspPropertyGroupDescriptor</code>
*/
public Collection<String> getIncludePreludes();
/**
* Gets the <code>include-coda</code> configuration of the JSP property group represented by this
* <code>JspPropertyGroupDescriptor</code>.
*
* <p>
* Any changes to the returned <code>Collection</code> must not affect this <code>JspPropertyGroupDescriptor</code>.
*
* @return a (possibly empty) <code>Collection</code> of the <code>include-coda</code> configuration of the JSP property
* group represented by this <code>JspPropertyGroupDescriptor</code>
*/
public Collection<String> getIncludeCodas();
/**
* Gets the value of the <code>deferred-syntax-allowed-as-literal</code> configuration, which specifies whether the
* character sequence <code>"#{"</code>, which is normally reserved for Expression Language (EL) expressions,
* will cause a translation error if it appears as a String literal in any JSP pages mapped to the JSP property group
* represented by this <code>JspPropertyGroupDescriptor</code>.
*
* @return the value of the <code>deferred-syntax-allowed-as-literal</code> configuration, or null if unspecified
*/
public String getDeferredSyntaxAllowedAsLiteral();
/**
* Gets the value of the <code>trim-directive-whitespaces</code> configuration, which specifies whether template text
* containing only whitespaces must be removed from the response output of any JSP pages mapped to the JSP property
* group represented by this <code>JspPropertyGroupDescriptor</code>.
*
* @return the value of the <code>trim-directive-whitespaces</code> configuration, or null if unspecified
*/
public String getTrimDirectiveWhitespaces();
/**
* Gets the value of the <code>default-content-type</code> configuration, which specifies the default response content
* type for any JSP pages mapped to the JSP property group represented by this <code>JspPropertyGroupDescriptor</code>.
*
* @return the value of the <code>default-content-type</code> configuration, or null if unspecified
*/
public String getDefaultContentType();
/**
* Gets the value of the <code>buffer</code> configuration, which specifies the default size of the response buffer for
* any JSP pages mapped to the JSP property group represented by this <code>JspPropertyGroupDescriptor</code>.
*
* @return the value of the <code>buffer</code> configuration, or null if unspecified
*/
public String getBuffer();
/**
* Gets the value of the <code>error-on-undeclared-namespace</code> configuration, which specifies whether an error will
* be raised at translation time if tag with an undeclared namespace is used in any JSP pages mapped to the JSP property
* group represented by this <code>JspPropertyGroupDescriptor</code>.
*
* @return the value of the <code>error-on-undeclared-namespace</code> configuration, or null if unspecified
*/
public String getErrorOnUndeclaredNamespace();
}