View Javadoc

1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one
3    * or more contributor license agreements.  See the NOTICE file
4    * distributed with this work for additional information
5    * regarding copyright ownership.  The ASF licenses this file
6    * to you under the Apache License, Version 2.0 (the
7    * "License"); you may not use this file except in compliance
8    * with 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,
13   * software distributed under the License is distributed on an
14   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15   * KIND, either express or implied.  See the License for the
16   * specific language governing permissions and limitations
17   * under the License.
18   */
19  package org.apache.shiro.web.tags;
20  
21  import javax.servlet.jsp.JspException;
22  import javax.servlet.jsp.tagext.TagSupport;
23  
24  /**
25   * @since 0.1
26   */
27  public abstract class PermissionTag extends SecureTag {
28  
29      //TODO - complete JavaDoc
30  
31      private String name = null;
32  
33      public PermissionTag() {
34      }
35  
36      public String getName() {
37          return name;
38      }
39  
40      public void setName(String name) {
41          this.name = name;
42      }
43  
44      protected void verifyAttributes() throws JspException {
45          String permission = getName();
46  
47          if (permission == null || permission.length() == 0) {
48              String msg = "The 'name' tag attribute must be set.";
49              throw new JspException(msg);
50          }
51      }
52  
53      public int onDoStartTag() throws JspException {
54  
55          String p = getName();
56  
57          boolean show = showTagBody(p);
58          if (show) {
59              return TagSupport.EVAL_BODY_INCLUDE;
60          } else {
61              return TagSupport.SKIP_BODY;
62          }
63      }
64  
65      protected boolean isPermitted(String p) {
66          return getSubject() != null && getSubject().isPermitted(p);
67      }
68  
69      protected abstract boolean showTagBody(String p);
70  
71  }