| /******************************************************************************* |
| * Copyright (c) 2013 Oracle. All rights reserved. |
| * This program and the accompanying materials are made available under the |
| * terms of the Eclipse Public License 2.0, which accompanies this distribution |
| * and is available at https://www.eclipse.org/legal/epl-2.0/. |
| * |
| * Contributors: |
| * Oracle - initial API and implementation |
| ******************************************************************************/ |
| package org.eclipse.jpt.common.utility.internal.transformer; |
| |
| import org.eclipse.jpt.common.utility.internal.ObjectTools; |
| import org.eclipse.jpt.common.utility.transformer.Transformer; |
| |
| /** |
| * Wrap a transformer that takes an object of type <code>I</code> and returns |
| * an object of type <code>X</code>, converting it into a transformer that |
| * takes an object of type <code>I</code> and returns |
| * an object of type <code>O</code>. <em>Assume</em> the wrapped |
| * transformer returns only objects of type <code>O</code>. The result is a |
| * {@link ClassCastException} if this assumption is false. |
| * <p> |
| * This is like a {@link CastingTransformerWrapper} but with more restrictive type |
| * parameters. |
| * |
| * @param <I> input: the type of the object passed to the transformer and |
| * forwarded to the wrapped transformer |
| * @param <X> intermediate: the type of object returned by the wrapped |
| * transformer |
| * @param <O> output: the type of object returned by the transformer - this |
| * is the same object returned by the wrapped transformer, simply |
| * cast to <code>O</code> |
| * |
| * @see CastingTransformerWrapper |
| * @see UpcastingTransformerWrapper |
| */ |
| public class DowncastingTransformerWrapper<I, X, O extends X> |
| implements Transformer<I, O> |
| { |
| private final Transformer<? super I, ? extends X> transformer; |
| |
| |
| public DowncastingTransformerWrapper(Transformer<? super I, ? extends X> transformer) { |
| super(); |
| if (transformer == null) { |
| throw new NullPointerException(); |
| } |
| this.transformer = transformer; |
| } |
| |
| /** |
| * Cast the output and hope for the best. |
| */ |
| @SuppressWarnings("unchecked") |
| public O transform(I input) { |
| return (O) this.transformer.transform(input); |
| } |
| |
| @Override |
| public String toString() { |
| return ObjectTools.toString(this, this.transformer); |
| } |
| } |