AllocationFileQueuePlacementRule.java

/*
 * 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.hadoop.yarn.server.resourcemanager.scheduler.fair.allocationfile;


import org.apache.hadoop.util.Lists;

import java.io.PrintWriter;
import java.io.StringWriter;
import java.util.List;

/**
 * Helper class for {@link AllocationFileWriter} to manage
 * queue placement rules.
 */
public class AllocationFileQueuePlacementRule {
  public enum RuleName {
    DEFAULT("default"),
    SPECIFIED("specified"),
    REJECT("reject"),
    NESTED("nestedUserQueue"),
    PRIMARY_GROUP("primaryGroup");

    private String name;

    RuleName(String name) {
      this.name = name;
    }

    @Override
    public String toString() {
      return name;
    }
  }

  private RuleName name;
  private boolean create = true;
  private String queue;
  private List<AllocationFileQueuePlacementRule> nestedRules = Lists
      .newArrayList();

  public AllocationFileQueuePlacementRule(RuleName name) {
    this.name = name;
  }

  public AllocationFileQueuePlacementRule create(boolean shouldCreate) {
    this.create = shouldCreate;
    return this;
  }

  public AllocationFileQueuePlacementRule queue(String selectedQueue) {
    this.queue = selectedQueue;
    return this;
  }

  public AllocationFileQueuePlacementRule addNestedRule(
      AllocationFileQueuePlacementRule rule) {
    this.nestedRules.add(rule);
    return this;
  }

  public String render() {
    StringWriter sw = new StringWriter();
    PrintWriter pw = new PrintWriter(sw);
    addStartTag(pw);
    addNestedRules(pw);
    addEndTag(pw);
    pw.close();

    return sw.toString();
  }

  private void addStartTag(PrintWriter pw) {
    pw.print("<rule name=\"" + name.toString() + "\" create=\"" +
        String.valueOf(create) + "\"");
    if (queue != null) {
      pw.print("queue=\"" + queue + "\"");
    }
    pw.println(">");
  }

  private void addNestedRules(PrintWriter pw) {
    if (nestedRules != null && !nestedRules.isEmpty()) {
      for (AllocationFileQueuePlacementRule rule : nestedRules) {
        pw.println(rule.render());
      }
    }
  }

  private void addEndTag(PrintWriter pw) {
    pw.println("</rule>");
  }
}