01: /*
02: * Licensed to the Apache Software Foundation (ASF) under one or more
03: * contributor license agreements. See the NOTICE file distributed with
04: * this work for additional information regarding copyright ownership.
05: * The ASF licenses this file to You under the Apache License, Version 2.0
06: * (the "License"); you may not use this file except in compliance with
07: * the License. You may obtain a copy of the License at
08: *
09: * http://www.apache.org/licenses/LICENSE-2.0
10: *
11: * Unless required by applicable law or agreed to in writing, software
12: * distributed under the License is distributed on an "AS IS" BASIS,
13: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14: * See the License for the specific language governing permissions and
15: * limitations under the License.
16: */
17: package org.apache.pluto;
18:
19: /**
20: * Thrown when an internal portlet container exception occurs within Pluto.
21: * This type of exception indicates an error from which the container is not
22: * able to recover.
23: *
24: * @version 1.0
25: */
26: public class PortletContainerException extends Exception {
27: private Throwable cause;
28:
29: /**
30: * Constructs a new PortletContainerException.
31: * This exception will have no message and no root cause.
32: */
33: public PortletContainerException() {
34:
35: }
36:
37: /**
38: * Constructs a new PortletContainerException with the given message.
39: * @param text the message explaining the exception occurance
40: */
41: public PortletContainerException(String text) {
42: super (text);
43: }
44:
45: /**
46: * Constructs a new PortletContainerException with the given message and
47: * root cause.
48: * @param text the message explaining the exception occurance
49: * @param cause the root cause of the is exception
50: */
51: public PortletContainerException(String text, Throwable cause) {
52: super (text);
53: this .cause = cause;
54: }
55:
56: /**
57: * Constructs a new portlet invoker exception when the portlet needs to
58: * throw an exception. The exception's message is based on the localized
59: * message of the underlying exception.
60: * @param cause the root cause
61: */
62: public PortletContainerException(Throwable cause) {
63: super (cause.getLocalizedMessage());
64: this .cause = cause;
65: }
66:
67: /**
68: * Returns the exception that cause this portlet exception.
69: * @return the <CODE>Throwable</CODE> that caused this portlet exception.
70: */
71: public Throwable getRootCause() {
72: return (cause);
73: }
74: }
|