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

akka.japi.pf.UnitMatch Maven / Gradle / Ivy

Go to download 

/*
 * Copyright (C) 2009-2020 Lightbend Inc. 
 */

package akka.japi.pf;

import scala.MatchError;
import scala.PartialFunction;
import scala.runtime.BoxedUnit;

/**
 * Version of {@link scala.PartialFunction} that can be built during runtime from Java. This is a
 * specialized version of {@link UnitMatch} to map java void methods to {@link
 * scala.runtime.BoxedUnit}.
 *
 * @param  the input type, that this PartialFunction will be applied to
 */
public class UnitMatch extends AbstractMatch {

  /**
   * Convenience function to create a {@link UnitPFBuilder} with the first case statement added.
   *
   * @param type a type to match the argument against
   * @param apply an action to apply to the argument if the type matches
   * @return a builder with the case statement added
   * @see UnitPFBuilder#match(Class, FI.UnitApply)
   */
  public static  UnitPFBuilder match(final Class
 type, FI.UnitApply
 apply) {
    return new UnitPFBuilder().match(type, apply);
  }

  /**
   * Convenience function to create a {@link UnitPFBuilder} with the first case statement added.
   * Should normally not be used.
   *
   * @see UnitPFBuilder#matchUnchecked(Class, FI.UnitApply)
   */
  public static UnitPFBuilder matchUnchecked(
      final Class type, final FI.UnitApply apply) {
    return new UnitPFBuilder().matchUnchecked(type, apply);
  }

  /**
   * Convenience function to create a {@link UnitPFBuilder} with the first case statement added.
   *
   * @param type a type to match the argument against
   * @param predicate a predicate that will be evaluated on the argument if the type matches
   * @param apply an action to apply to the argument if the type and predicate matches
   * @return a builder with the case statement added
   * @see UnitPFBuilder#match(Class, FI.TypedPredicate, FI.UnitApply)
   */
  public static  UnitPFBuilder match(
      final Class
 type, final FI.TypedPredicate
 predicate, final FI.UnitApply
 apply) {
    return new UnitPFBuilder().match(type, predicate, apply);
  }

  /**
   * Convenience function to create a {@link UnitPFBuilder} with the first case statement added.
   * Should normally not be used.
   *
   * @see UnitPFBuilder#matchUnchecked(Class, FI.TypedPredicate, FI.UnitApply)
   */
  public static  UnitPFBuilder matchUnchecked(
      final Class type, final FI.TypedPredicate predicate, final FI.UnitApply apply) {
    return new UnitPFBuilder().matchUnchecked(type, predicate, apply);
  }

  /**
   * Convenience function to create a {@link UnitPFBuilder} with the first case statement added.
   *
   * @param object the object to compare equals with
   * @param apply an action to apply to the argument if the object compares equal
   * @return a builder with the case statement added
   * @see UnitPFBuilder#matchEquals(Object, FI.UnitApply)
   */
  public static  UnitPFBuilder matchEquals(final P object, final FI.UnitApply
 apply) {
    return new UnitPFBuilder().matchEquals(object, apply);
  }

  /**
   * Convenience function to create a {@link UnitPFBuilder} with the first case statement added.
   *
   * @param object the object to compare equals with
   * @param predicate a predicate that will be evaluated on the argument the object compares equal
   * @param apply an action to apply to the argument if the object compares equal
   * @return a builder with the case statement added
   * @see UnitPFBuilder#matchEquals(Object, FI.UnitApply)
   */
  public static  UnitPFBuilder matchEquals(
      final P object, final FI.TypedPredicate
 predicate, final FI.UnitApply
 apply) {
    return new UnitPFBuilder().matchEquals(object, predicate, apply);
  }

  /**
   * Convenience function to create a {@link UnitPFBuilder} with the first case statement added.
   *
   * @param apply an action to apply to the argument
   * @return a builder with the case statement added
   * @see UnitPFBuilder#matchAny(FI.UnitApply)
   */
  public static  UnitPFBuilder matchAny(final FI.UnitApply apply) {
    return new UnitPFBuilder().matchAny(apply);
  }

  /**
   * Create a {@link UnitMatch} from the builder.
   *
   * @param builder a builder representing the partial function
   * @return a {@link UnitMatch} that can be reused
   */
  public static  UnitMatch create(UnitPFBuilder builder) {
    return new UnitMatch(builder.build());
  }

  private UnitMatch(PartialFunction statements) {
    super(statements);
  }

  /**
   * Convenience function to make the Java code more readable.
   *
   * 

   *
   * 

   *   UnitMatcher<X> matcher = UnitMatcher.create(...);
   *
   *   matcher.match(obj);
   * 

   *
   * @param i the argument to apply the match to
   * @throws scala.MatchError if there is no match
   */
  public void match(I i) throws MatchError {
    statements.apply(i);
  }
}
 















© 2015 - 2024 Weber Informatics LLC | Privacy Policy