/** * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the * specific language governing permissions and limitations under the License. * * Copyright 2012-2015 the original author or authors. */ package org.assertj.swing.launcher; import static org.assertj.core.util.Preconditions.checkNotNull; import static org.assertj.core.util.Strings.concat; import static org.assertj.core.util.Strings.quote; import static org.assertj.swing.util.Arrays.copyOf; import static org.fest.reflect.core.Reflection.method; import javax.annotation.Nonnull; import org.assertj.swing.exception.UnexpectedException; /** * <p> * Executes a Java application from a class that has a "main" method. * </p> * * <p> * The following example shows how to start an application without any arguments: * </p> * * <pre> * ApplicationLauncher.application(JavaApp.class).start(); * * // or * * ApplicationLauncher.{@link #application(String) application}("org.assertj.swing.application.JavaApp").{@link #start() start}(); * </pre> * * <p> * The following example shows how to start an application with arguments: * </p> * * <pre> * ApplicationLauncher.{@link #application(Class) application}(JavaApp.class).{@link #withArgs(String...) withArgs}("arg1", "arg2").{@link #start() start}(); * * // or * * ApplicationLauncher.{@link #application(String) application}("org.assertj.swing.application.JavaApp").{@link #withArgs(String...) withArgs}("arg1", "arg2").{@link #start() start}(); * </pre> * * @author Yvonne Wang */ public class ApplicationLauncher { /** * Starting point of the fluent interface. * * @param applicationTypeName the fully qualified name of the class containing the "main" method. * @return the created {@code ApplicationStarter}. * @throws UnexpectedException if the class specified in the given name cannot be loaded. */ public static @Nonnull ApplicationLauncher application(@Nonnull String applicationTypeName) { try { Class<?> applicationType = Thread.currentThread().getContextClassLoader().loadClass(applicationTypeName); return application(applicationType); } catch (ClassNotFoundException e) { throw new UnexpectedException(concat("Unable to load class ", quote(applicationTypeName)), e); } } /** * Starting point of the fluent interface. * * @param applicationType the class containing the "main" method. * @return the created {@code ApplicationStarter}. */ public static @Nonnull ApplicationLauncher application(@Nonnull Class<?> applicationType) { return new ApplicationLauncher(applicationType); } private final Class<?> applicationType; private String[] args = {}; private ApplicationLauncher(@Nonnull Class<?> applicationType) { this.applicationType = applicationType; } /** * Specifies the arguments to pass to the "main" method. Please note that the arguments to pass are specific to your * application. JVM-specific arguments are ignored (e.g. -Xms, -Xmx) * * @param newArgs the arguments to pass to the "main" method. * @return this {@code ApplicationStarter}. * @throws NullPointerException if {@code newArgs} is {@code null}. */ public @Nonnull ApplicationLauncher withArgs(@Nonnull String... newArgs) { args = copyOf(checkNotNull(newArgs)); return this; } /** * Starts the application. * * @throws org.fest.reflect.exception.ReflectionError if the "main" method cannot be invoked. */ public void start() { method("main").withParameterTypes(String[].class).in(applicationType).invoke(new Object[] { args }); } }