All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.thebuzzmedia.exiftool.process.command.CommandBuilder Maven / Gradle / Ivy

There is a newer version: 3.0.1
Show newest version
/**
 * Copyright 2011 The Buzz Media, LLC
 * Copyright 2015 Mickael Jeanroy 
 *
 * 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.
 */

package com.thebuzzmedia.exiftool.process.command;

import com.thebuzzmedia.exiftool.process.Command;

import java.util.ArrayList;
import java.util.List;

import static com.thebuzzmedia.exiftool.commons.lang.PreConditions.notBlank;
import static com.thebuzzmedia.exiftool.commons.lang.PreConditions.notEmpty;

/**
 * Command builder.
 * This builder should be used to create immutable instance of {@link com.thebuzzmedia.exiftool.process.Command}.
 */
public class CommandBuilder {

	/**
	 * Get new builder.
	 *
	 * 
* * Note: Use {@link #builder(String, int)} to optimize the creation of the argument list. * * @param executable Executable value. * @return The new builder. * @throws NullPointerException If executable is null. * @throws IllegalArgumentException If executable is empty or blank. */ public static CommandBuilder builder(String executable) { return builder(executable, 10); } /** * Get new builder. * * @param executable Executable value. * @param nbArgs The expected number of arguments. * @return The new builder. * @throws NullPointerException If executable is null. * @throws IllegalArgumentException If executable is empty or blank. */ public static CommandBuilder builder(String executable, int nbArgs) { return new CommandBuilder(executable, nbArgs); } /** * Command Line Executable. */ private final String executable; /** * Command Line Arguments (will be appended next to the executable value). */ private final List arguments; /** * Create builder. * * @param executable Executable value. * @throws NullPointerException If executable is {@code null}. * @throws IllegalArgumentException If executable is empty or blank. */ private CommandBuilder(String executable, int size) { this.executable = notBlank(executable, "Command line executable should be defined"); this.arguments = new ArrayList<>(size); } /** * Add new argument to the command line. * * @param arg First argument. * @param args Next optional arguments. * @return The builder. * @throws NullPointerException If one of the arguments is {@code null}. * @throws IllegalArgumentException If one of the arguments is empty or blank. */ public CommandBuilder addArgument(String arg, String... args) { add(arg); if (args.length > 0) { for (String a : args) { add(a); } } return this; } /** * Add all arguments to the command line. * * @param arguments All arguments. * @return The builder. * @throws NullPointerException If arguments is {@code null}. * @throws IllegalArgumentException If arguments is empty. */ public CommandBuilder addAll(Iterable arguments) { notEmpty(arguments, "Arguments should not be empty"); for (String arg : arguments) { add(arg); } return this; } /** * Build the command line. * * @return Command Line instance. */ public Command build() { return new DefaultCommand(executable, arguments); } private void add(String arg) { this.arguments.add(notBlank(arg, "Command line argument should be defined if set")); } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy