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.authz; 20 21 /** 22 * Thrown when a particular client (that is, host address) has not been enabled to access the system 23 * or if the client has been enabled access but is not permitted to perform a particular operation 24 * or access a particular resource. 25 * 26 * @since 0.1 27 */ 28 public class HostUnauthorizedException extends UnauthorizedException { 29 30 private String host; 31 32 /** 33 * Creates a new HostUnauthorizedException. 34 */ 35 public HostUnauthorizedException() { 36 super(); 37 } 38 39 /** 40 * Constructs a new HostUnauthorizedException. 41 * 42 * @param message the reason for the exception 43 */ 44 public HostUnauthorizedException(String message) { 45 super(message); 46 } 47 48 /** 49 * Constructs a new HostUnauthorizedException. 50 * 51 * @param cause the underlying Throwable that caused this exception to be thrown. 52 */ 53 public HostUnauthorizedException(Throwable cause) { 54 super(cause); 55 } 56 57 /** 58 * Constructs a new HostUnauthorizedException. 59 * 60 * @param message the reason for the exception 61 * @param cause the underlying Throwable that caused this exception to be thrown. 62 */ 63 public HostUnauthorizedException(String message, Throwable cause) { 64 super(message, cause); 65 } 66 67 /** 68 * Returns the host associated with this exception. 69 * 70 * @return the host associated with this exception. 71 */ 72 public String getHost() { 73 return this.host; 74 } 75 76 /** 77 * Sets the host associated with this exception. 78 * 79 * @param host the host associated with this exception. 80 */ 81 public void setHostAddress(String host) { 82 this.host = host; 83 } 84 }