View Javadoc

1   /*
2    * Copyright 2006-2009 the original author or authors.
3    * 
4    * Licensed under the Apache License, Version 2.0 (the "License");
5    * you may not use this file except in compliance with the License.
6    * You may obtain a copy of the License at
7    * 
8    *      http://www.apache.org/licenses/LICENSE-2.0
9    * 
10   * Unless required by applicable law or agreed to in writing, software
11   * distributed under the License is distributed on an "AS IS" BASIS,
12   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13   * See the License for the specific language governing permissions and
14   * limitations under the License.
15   */
16  
17  package org.springframework.osgi.context.event;
18  
19  import org.osgi.framework.Bundle;
20  import org.springframework.context.ApplicationContext;
21  
22  /**
23   * Event raised when the initialization of an <code>ApplicationContext</code> failed.
24   * 
25   * @author Costin Leau
26   * 
27   */
28  public class OsgiBundleContextFailedEvent extends OsgiBundleApplicationContextEvent {
29  
30  	private final Throwable cause;
31  
32  	/**
33  	 * Constructs a new <code>OsgiBundleContextFailedEvent</code> instance.
34  	 * 
35  	 * @param source the <code>ApplicationContext</code> that has failed (must not be <code>null</code>)
36  	 * @param bundle the OSGi bundle associated with the source application context
37  	 * @param cause optional <code>Throwable</code> indicating the cause of the failure
38  	 */
39  	public OsgiBundleContextFailedEvent(ApplicationContext source, Bundle bundle, Throwable cause) {
40  		super(source, bundle);
41  		this.cause = cause;
42  	}
43  
44  	/**
45  	 * Returns the <code>Throwable</code> that caused the application context to fail.
46  	 * 
47  	 * @return the cause of the failure.
48  	 */
49  	public final Throwable getFailureCause() {
50  		return cause;
51  	}
52  }