| Classes in this File | Line Coverage | Branch Coverage | Complexity | ||||
| EmbeddedRegistry |
|
| 3.0;3 | ||||
| EmbeddedRegistry$1 |
|
| 3.0;3 |
| 1 | package org.apache.tomcat.maven.common.run; | |
| 2 | ||
| 3 | /* | |
| 4 | * Licensed to the Apache Software Foundation (ASF) under one | |
| 5 | * or more contributor license agreements. See the NOTICE file | |
| 6 | * distributed with this work for additional information | |
| 7 | * regarding copyright ownership. The ASF licenses this file | |
| 8 | * to you under the Apache License, Version 2.0 (the | |
| 9 | * "License"); you may not use this file except in compliance | |
| 10 | * with the License. You may obtain a copy of the License at | |
| 11 | * | |
| 12 | * http://www.apache.org/licenses/LICENSE-2.0 | |
| 13 | * | |
| 14 | * Unless required by applicable law or agreed to in writing, | |
| 15 | * software distributed under the License is distributed on an | |
| 16 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY | |
| 17 | * KIND, either express or implied. See the License for the | |
| 18 | * specific language governing permissions and limitations | |
| 19 | * under the License. | |
| 20 | */ | |
| 21 | ||
| 22 | import org.apache.maven.plugin.logging.Log; | |
| 23 | ||
| 24 | import java.lang.reflect.InvocationTargetException; | |
| 25 | import java.lang.reflect.Method; | |
| 26 | import java.util.HashSet; | |
| 27 | import java.util.Iterator; | |
| 28 | import java.util.Set; | |
| 29 | ||
| 30 | /** | |
| 31 | * Registry which collects all embedded Tomcat Servers so that they will be shutdown | |
| 32 | * through a shutdown hook when the JVM terminates or you can ask the registry to | |
| 33 | * shutdown all started servers. | |
| 34 | * | |
| 35 | * @author Mark Michaelis | |
| 36 | * @since 1.1 | |
| 37 | */ | |
| 38 | public final class EmbeddedRegistry | |
| 39 | { | |
| 40 | private static EmbeddedRegistry instance; | |
| 41 | ||
| 42 | 0 | private Set<Object> containers = new HashSet<Object>( 1 ); |
| 43 | ||
| 44 | /** | |
| 45 | * Don't instantiate - use the instance through {@link #getInstance()}. | |
| 46 | */ | |
| 47 | private EmbeddedRegistry() | |
| 48 | 0 | { |
| 49 | // no op | |
| 50 | 0 | } |
| 51 | ||
| 52 | /** | |
| 53 | * Retrieve the lazily initialized instance of the registry. | |
| 54 | * | |
| 55 | * @return singleton instance of the registry | |
| 56 | */ | |
| 57 | public static EmbeddedRegistry getInstance() | |
| 58 | { | |
| 59 | 0 | if ( instance == null ) |
| 60 | { | |
| 61 | 0 | instance = new EmbeddedRegistry(); |
| 62 | 0 | Runtime.getRuntime().addShutdownHook( new Thread() |
| 63 | 0 | { |
| 64 | @Override | |
| 65 | public void run() | |
| 66 | { | |
| 67 | try | |
| 68 | { | |
| 69 | 0 | getInstance().shutdownAll( null ); |
| 70 | } | |
| 71 | 0 | catch ( Exception e ) |
| 72 | { | |
| 73 | // ignore, the exception should already have been reported | |
| 74 | 0 | } |
| 75 | 0 | } |
| 76 | } ); | |
| 77 | } | |
| 78 | 0 | return instance; |
| 79 | } | |
| 80 | ||
| 81 | /** | |
| 82 | * Adds the given container to the registry which automatically registers it for the shutdown | |
| 83 | * hook. | |
| 84 | * | |
| 85 | * @param container the container to register | |
| 86 | * @return true if it got added; false if not | |
| 87 | */ | |
| 88 | public synchronized boolean register( final Object container ) | |
| 89 | { | |
| 90 | 0 | return containers.add( container ); |
| 91 | } | |
| 92 | ||
| 93 | /** | |
| 94 | * Shuts down all registered embedded tomcats. All tomcats which successfully shut down will be | |
| 95 | * removed from the registry. | |
| 96 | * | |
| 97 | * @param log the log to write possible shutdown exceptions to | |
| 98 | * @throws Exception the first exception which occurred will be rethrown | |
| 99 | */ | |
| 100 | public synchronized void shutdownAll( final Log log ) | |
| 101 | throws Exception | |
| 102 | { | |
| 103 | 0 | Exception firstException = null; |
| 104 | 0 | for ( Iterator<Object> iterator = containers.iterator(); iterator.hasNext(); ) |
| 105 | { | |
| 106 | 0 | Object embedded = iterator.next(); |
| 107 | try | |
| 108 | { | |
| 109 | 0 | Method method = embedded.getClass().getMethod( "stop", null ); |
| 110 | 0 | method.invoke( embedded, null ); |
| 111 | 0 | iterator.remove(); |
| 112 | } | |
| 113 | 0 | catch ( NoSuchMethodException e ) |
| 114 | { | |
| 115 | 0 | if ( firstException == null ) |
| 116 | { | |
| 117 | 0 | firstException = e; |
| 118 | 0 | error( log, e, "no stop method in class " + embedded.getClass().getName() ); |
| 119 | } | |
| 120 | else | |
| 121 | { | |
| 122 | 0 | error( log, e, "Error while shutting down embedded Tomcat." ); |
| 123 | } | |
| 124 | } | |
| 125 | 0 | catch ( IllegalAccessException e ) |
| 126 | { | |
| 127 | 0 | if ( firstException == null ) |
| 128 | { | |
| 129 | 0 | firstException = e; |
| 130 | 0 | error( log, e, "IllegalAccessException for stop method in class " + embedded.getClass().getName() ); |
| 131 | } | |
| 132 | else | |
| 133 | { | |
| 134 | 0 | error( log, e, "Error while shutting down embedded Tomcat." ); |
| 135 | } | |
| 136 | } | |
| 137 | 0 | catch ( InvocationTargetException e ) |
| 138 | { | |
| 139 | ||
| 140 | 0 | if ( firstException == null ) |
| 141 | { | |
| 142 | 0 | firstException = e; |
| 143 | 0 | error( log, e, "IllegalAccessException for stop method in class " + embedded.getClass().getName() ); |
| 144 | } | |
| 145 | else | |
| 146 | { | |
| 147 | 0 | error( log, e, "Error while shutting down embedded Tomcat." ); |
| 148 | } | |
| 149 | 0 | } |
| 150 | 0 | } |
| 151 | 0 | if ( firstException != null ) |
| 152 | { | |
| 153 | 0 | throw firstException; |
| 154 | } | |
| 155 | 0 | } |
| 156 | ||
| 157 | /** | |
| 158 | * Reports the exception. If a log is given (typically when called from within a Mojo) the | |
| 159 | * message will be printed to the log. Otherwise it will be printed to StdErr. | |
| 160 | * | |
| 161 | * @param log the log to write the message to; null to write to stderr | |
| 162 | * @param e exception which shall be reported | |
| 163 | * @param message message which shall be reported | |
| 164 | */ | |
| 165 | private void error( final Log log, final Exception e, final String message ) | |
| 166 | { | |
| 167 | 0 | if ( log == null ) |
| 168 | { | |
| 169 | 0 | System.err.println( "ERROR: " + message ); |
| 170 | 0 | e.printStackTrace(); |
| 171 | } | |
| 172 | else | |
| 173 | { | |
| 174 | 0 | log.error( message, e ); |
| 175 | } | |
| 176 | 0 | } |
| 177 | ||
| 178 | } |