001    /*****************************************************************************
002     * Copyright (C) PicoContainer Organization. All rights reserved.            *
003     * ------------------------------------------------------------------------- *
004     * The software in this package is published under the terms of the BSD      *
005     * style license a copy of which has been included with this distribution in *
006     * the LICENSE.txt file.                                                     *
007     *                                                                           *
008     * Original code by                                                          *
009     *****************************************************************************/
010    package org.picocontainer.monitors;
011    
012    import java.lang.reflect.Constructor;
013    import java.lang.reflect.Method;
014    import java.lang.reflect.Member;
015    import java.util.ArrayList;
016    import java.util.Collection;
017    import java.util.List;
018    
019    import org.picocontainer.ComponentMonitor;
020    import org.picocontainer.PicoException;
021    import org.picocontainer.PicoLifecycleException;
022    import org.picocontainer.ComponentAdapter;
023    import org.picocontainer.MutablePicoContainer;
024    import org.picocontainer.PicoContainer;
025    
026    /**
027     * A {@link ComponentMonitor} which collects lifecycle failures
028     * and rethrows them on demand after the failures.
029     * 
030     * @author Paul Hammant
031     * @author Mauro Talevi
032     */
033    public final class LifecycleComponentMonitor implements ComponentMonitor {
034    
035        private final ComponentMonitor delegate;
036        private final List lifecycleFailures = new ArrayList();
037    
038        public LifecycleComponentMonitor(ComponentMonitor delegate) {
039            this.delegate = delegate;
040        }
041    
042        public LifecycleComponentMonitor() {
043            this(new NullComponentMonitor());
044        }
045    
046        public Constructor instantiating(PicoContainer container, ComponentAdapter componentAdapter,
047                                         Constructor constructor) {
048            return delegate.instantiating(container, componentAdapter, constructor);
049        }
050    
051        public void instantiated(PicoContainer container, ComponentAdapter componentAdapter,
052                                 Constructor constructor,
053                                 Object instantiated,
054                                 Object[] parameters,
055                                 long duration) {
056            delegate.instantiated(container, componentAdapter, constructor, instantiated, parameters, duration);
057        }
058    
059        public void instantiationFailed(PicoContainer container,
060                                        ComponentAdapter componentAdapter,
061                                        Constructor constructor,
062                                        Exception cause) {
063            delegate.instantiationFailed(container, componentAdapter, constructor, cause);
064        }
065    
066        public void invoking(PicoContainer container,
067                             ComponentAdapter componentAdapter,
068                             Member member,
069                             Object instance) {
070            delegate.invoking(container, componentAdapter, member, instance);
071        }
072    
073        public void invoked(PicoContainer container,
074                            ComponentAdapter componentAdapter,
075                            Method method,
076                            Object instance,
077                            long duration) {
078            delegate.invoked(container, componentAdapter, method, instance, duration);
079        }
080    
081        public void invocationFailed(Member member, Object instance, Exception cause) {
082            delegate.invocationFailed(member, instance, cause);
083        }
084    
085        public void lifecycleInvocationFailed(MutablePicoContainer container,
086                                              ComponentAdapter componentAdapter, Method method,
087                                              Object instance,
088                                              RuntimeException cause) {
089            lifecycleFailures.add(cause);
090            try {
091                delegate.lifecycleInvocationFailed(container, componentAdapter, method, instance, cause);
092            } catch (PicoLifecycleException e) {
093                // do nothing, exception already logged for later rethrow.
094            }
095        }
096    
097        public Object noComponentFound(MutablePicoContainer container, Object componentKey) {
098            return delegate.noComponentFound(container, componentKey);
099        }
100    
101    
102        public void rethrowLifecycleFailuresException() {
103            throw new LifecycleFailuresException(lifecycleFailures);
104        }
105    
106        /**
107         * Subclass of {@link PicoException} that is thrown when the collected
108         * lifecycle failures need to be be collectively rethrown.
109         * 
110         * @author Paul Hammant
111         * @author Mauro Talevi
112         */
113        public final class LifecycleFailuresException extends PicoException {
114    
115            private final List lifecycleFailures;
116    
117            public LifecycleFailuresException(List lifecycleFailures) {
118                this.lifecycleFailures = lifecycleFailures;
119            }
120    
121            public String getMessage() {
122                StringBuffer message = new StringBuffer();
123                for (Object lifecycleFailure : lifecycleFailures) {
124                    Exception failure = (Exception)lifecycleFailure;
125                    message.append(failure.getMessage()).append(";  ");
126                }
127                return message.toString();
128            }
129    
130            public Collection getFailures() {
131                return lifecycleFailures;
132            }
133        }
134    }