View Javadoc

1   /*
2    * Copyright 2006-2008 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.service;
18  
19  import org.osgi.framework.Filter;
20  import org.osgi.framework.ServiceReference;
21  import org.springframework.osgi.util.OsgiServiceReferenceUtils;
22  
23  /**
24   * Exception indicating that an OSGi service became unavailable/unregistered.
25   * Normally this exception is used to indicate that no suitable replacement is
26   * found (in case service rebinding is actually performed).
27   * 
28   * @author Adrian Colyer
29   * @author Costin Leau
30   */
31  public class ServiceUnavailableException extends ServiceException {
32  
33  	private static final long serialVersionUID = -3479837278220329490L;
34  
35  
36  	/**
37  	 * Constructs a new <code>ServiceUnavailableException</code> instance.
38  	 * 
39  	 * @param filter service filter
40  	 */
41  	public ServiceUnavailableException(Filter filter) {
42  		super("service matching filter=[" + filter + "] unavailable");
43  	}
44  
45  	/**
46  	 * Constructs a new <code>ServiceUnavailableException</code> instance.
47  	 * 
48  	 * @param filter service filter (passed as a string)
49  	 */
50  	public ServiceUnavailableException(String filter) {
51  		super("service matching filter=[" + filter + "] unavailable");
52  	}
53  
54  	/**
55  	 * Constructs a new <code>ServiceUnavailableException</code> instance.
56  	 * 
57  	 * @param reference service reference
58  	 */
59  	public ServiceUnavailableException(ServiceReference reference) {
60  		super("service with id=[" + OsgiServiceReferenceUtils.getServiceId(reference) + "] unavailable");
61  	}
62  
63  }