| /* |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you 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 org.apache.reef.io.data.output; |
| |
| import org.apache.reef.driver.context.ServiceConfiguration; |
| import org.apache.reef.evaluator.context.events.ContextStop; |
| import org.apache.reef.tang.Configuration; |
| import org.apache.reef.tang.Tang; |
| import org.apache.reef.tang.annotations.Name; |
| import org.apache.reef.tang.annotations.NamedParameter; |
| import org.apache.reef.tang.annotations.Parameter; |
| import org.apache.reef.tang.annotations.Unit; |
| import org.apache.reef.task.events.TaskStart; |
| import org.apache.reef.wake.EventHandler; |
| |
| import javax.inject.Inject; |
| import java.io.IOException; |
| import java.util.logging.Level; |
| import java.util.logging.Logger; |
| |
| /** |
| * A service class of the task output service. |
| * The file output service provides an output stream, |
| * through which tasks write their output to a file |
| * without considering the current runtime |
| * and collision with other tasks. |
| */ |
| @Unit |
| public final class TaskOutputService implements OutputService { |
| private static final Logger LOG = Logger.getLogger(TaskOutputService.class.getName()); |
| |
| /** |
| * Output stream provider object through which tasks create output streams. |
| */ |
| private final TaskOutputStreamProvider taskOutputStreamProvider; |
| |
| /** |
| * Path of the directory where output files are created. |
| */ |
| private final String outputPath; |
| |
| /** |
| * Service constructor - instantiated via TANG. |
| * |
| * @param taskOutputStreamProvider Output stream provider object through which tasks create file output streams. |
| * @param outputPath Path of the directory where output files are created. |
| */ |
| @Inject |
| private TaskOutputService( |
| final TaskOutputStreamProvider taskOutputStreamProvider, |
| @Parameter(OutputPath.class) final String outputPath) { |
| this.taskOutputStreamProvider = taskOutputStreamProvider; |
| this.outputPath = outputPath; |
| } |
| |
| /** |
| * Provides a service configuration for the output service. |
| * |
| * @return service configuration. |
| */ |
| @Override |
| public Configuration getServiceConfiguration() { |
| |
| final Configuration partialServiceConf = ServiceConfiguration.CONF |
| .set(ServiceConfiguration.SERVICES, taskOutputStreamProvider.getClass()) |
| .set(ServiceConfiguration.ON_CONTEXT_STOP, ContextStopHandler.class) |
| .set(ServiceConfiguration.ON_TASK_STARTED, TaskStartHandler.class) |
| .build(); |
| |
| return Tang.Factory.getTang() |
| .newConfigurationBuilder(partialServiceConf) |
| .bindImplementation(OutputStreamProvider.class, taskOutputStreamProvider.getClass()) |
| .bindImplementation(TaskOutputStreamProvider.class, taskOutputStreamProvider.getClass()) |
| .bindNamedParameter(OutputPath.class, outputPath) |
| .build(); |
| } |
| |
| /** |
| * Handles the ContextStop event: Close the output stream provider. |
| */ |
| private final class ContextStopHandler implements EventHandler<ContextStop> { |
| @Override |
| public void onNext(final ContextStop contextStop) { |
| LOG.log(Level.INFO, "Context stopped, close the OutputStreamProvider."); |
| try { |
| taskOutputStreamProvider.close(); |
| } catch (final IOException e) { |
| throw new RuntimeException(e); |
| } |
| } |
| } |
| |
| /** |
| * Handles the TaskStart event: Set the task id to the output stream provider. |
| */ |
| private final class TaskStartHandler implements EventHandler<TaskStart> { |
| @Override |
| public void onNext(final TaskStart taskStart) { |
| LOG.log(Level.INFO, String.format("Task %s started, create the OutputStreamProvider.", taskStart.getId())); |
| taskOutputStreamProvider.setTaskId(taskStart.getId()); |
| } |
| } |
| |
| /** |
| * Path of the directory where output files are created. |
| */ |
| @NamedParameter(doc = "Path of the directory where output files are created") |
| public static final class OutputPath implements Name<String> { |
| } |
| } |