com.google.refine.expr.functions.strings.Decode Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of main Show documentation

OpenRefine is a free, open source power tool for working with messy data and improving it

There is a newer version: 3.8.2


package com.google.refine.expr.functions.strings;

import java.util.Properties;

import com.google.common.io.BaseEncoding;

import com.google.refine.expr.EvalError;
import com.google.refine.grel.ControlFunctionRegistry;
import com.google.refine.grel.EvalErrorMessage;
import com.google.refine.grel.Function;
import com.google.refine.grel.FunctionDescription;

public class Decode implements Function {

    /**
     * Decodes a string using a given encoding. Encodings include Base16, Base32Hex, Base32, Base64, and Base64Url.
     *
     * @param args
     *            Arguments to the function.
     * @return The decoded string.
     */
    @Override
    public Object call(Properties bindings, Object[] args) {
        if (args.length == 2) {
            if (args[0] instanceof String && args[1] instanceof String) {
                String encoding = (String) args[1];
                String string = (String) args[0];
                switch (encoding) {
                    case "base16":
                        return new String(BaseEncoding.base16().decode(string));
                    case "base32hex":
                        return new String(BaseEncoding.base32Hex().decode(string));
                    case "base32":
                        return new String(BaseEncoding.base32().decode(string));
                    case "base64":
                        return new String(BaseEncoding.base64().decode(string));
                    case "base64url":
                        return new String(BaseEncoding.base64Url().decode(string));
                    default:
                        // encoding);
                        return new EvalError(EvalErrorMessage.unknown_encoding(ControlFunctionRegistry.getFunctionName(this), encoding));
                }
            }
        }
        // an encoding.");
        return new EvalError(EvalErrorMessage.expects_one_string_and_encoding(ControlFunctionRegistry.getFunctionName(this)));
    }

    @Override
    public String getDescription() {
        return FunctionDescription.str_decode();
    }

    @Override
    public String getParams() {
        return "string s, string encoding";
    }

    @Override
    public String getReturns() {
        return "string";
    }
}