2.7.6 REST Metadata

dubbo-common/src/main/java/org/apache/dubbo/common/convert/Converter.java

@@ -0,0 +1,91 @@
+/*
+ * 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.dubbo.common.convert;
+
+import org.apache.dubbo.common.extension.ExtensionLoader;
+import org.apache.dubbo.common.extension.SPI;
+import org.apache.dubbo.common.lang.Prioritized;
+
+import static org.apache.dubbo.common.extension.ExtensionLoader.getExtensionLoader;
+import static org.apache.dubbo.common.utils.ClassUtils.isAssignableFrom;
+import static org.apache.dubbo.common.utils.TypeUtils.findActualTypeArgument;
+
+/**
+ * A class to convert the source-typed value to the target-typed value
+ *
+ * @param <S> The source type
+ * @param <T> The target type
+ * @since 2.7.6
+ */
+@SPI
+@FunctionalInterface
+public interface Converter<S, T> extends Prioritized {
+
+    /**
+     * Accept the source type and target type or not
+     *
+     * @param sourceType the source type
+     * @param targetType the target type
+     * @return if accepted, return <code>true</code>, or <code>false</code>
+     */
+    default boolean accept(Class<?> sourceType, Class<?> targetType) {
+        return isAssignableFrom(sourceType, getSourceType()) && isAssignableFrom(targetType, getTargetType());
+    }
+
+    /**
+     * Convert the source-typed value to the target-typed value
+     *
+     * @param source the source-typed value
+     * @return the target-typed value
+     */
+    T convert(S source);
+
+    /**
+     * Get the source type
+     *
+     * @return non-null
+     */
+    default Class<S> getSourceType() {
+        return findActualTypeArgument(getClass(), Converter.class, 0);
+    }
+
+    /**
+     * Get the target type
+     *
+     * @return non-null
+     */
+    default Class<T> getTargetType() {
+        return findActualTypeArgument(getClass(), Converter.class, 1);
+    }
+
+    /**
+     * Get the Converter instance from {@link ExtensionLoader} with the specified source and target type
+     *
+     * @param sourceType the source type
+     * @param targetType the target type
+     * @return
+     * @see ExtensionLoader#getSupportedExtensionInstances()
+     */
+    static Converter<?, ?> getConverter(Class<?> sourceType, Class<?> targetType) {
+        return getExtensionLoader(Converter.class)
+                .getSupportedExtensionInstances()
+                .stream()
+                .filter(converter -> converter.accept(sourceType, targetType))
+                .findFirst()
+                .orElse(null);
+    }
+}

dubbo-common/src/main/java/org/apache/dubbo/common/convert/StringConverter.java

@@ -0,0 +1,27 @@
+/*
+ * 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.dubbo.common.convert;
+
+/**
+ * A class to covert {@link String} to the target-typed value
+ *
+ * @see Converter
+ * @since 2.7.6
+ */
+@FunctionalInterface
+public interface StringConverter<T> extends Converter<String, T> {
+}

dubbo-common/src/main/java/org/apache/dubbo/common/convert/StringToBooleanConverter.java

@@ -0,0 +1,38 @@
+/*
+ * 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.dubbo.common.convert;
+
+import static java.lang.Boolean.valueOf;
+import static org.apache.dubbo.common.utils.StringUtils.isNotEmpty;
+
+/**
+ * The class to convert {@link String} to {@link Boolean}
+ *
+ * @since 2.7.6
+ */
+public class StringToBooleanConverter implements StringConverter<Boolean> {
+
+    @Override
+    public Boolean convert(String source) {
+        return isNotEmpty(source) ? valueOf(source) : null;
+    }
+
+    @Override
+    public int getPriority() {
+        return NORMAL_PRIORITY + 5;
+    }
+}

dubbo-common/src/main/java/org/apache/dubbo/common/convert/StringToCharArrayConverter.java

@@ -0,0 +1,39 @@
+/*
+ * 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.dubbo.common.convert;
+
+
+import static org.apache.dubbo.common.utils.StringUtils.isNotEmpty;
+
+/**
+ * The class to convert {@link String} to <code>char[]</code>
+ *
+ * @since 2.7.6
+ */
+public class StringToCharArrayConverter implements StringConverter<char[]> {
+
+    @Override
+    public char[] convert(String source) {
+        return isNotEmpty(source) ? source.toCharArray() : null;
+    }
+
+
+    @Override
+    public int getPriority() {
+        return NORMAL_PRIORITY + 7;
+    }
+}

dubbo-common/src/main/java/org/apache/dubbo/common/convert/StringToCharacterConverter.java

@@ -0,0 +1,44 @@
+/*
+ * 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.dubbo.common.convert;
+
+import static org.apache.dubbo.common.utils.StringUtils.length;
+
+/**
+ * The class to convert {@link String} to {@link Character}
+ *
+ * @since 2.7.6
+ */
+public class StringToCharacterConverter implements StringConverter<Character> {
+
+    @Override
+    public Character convert(String source) {
+        int length = length(source);
+        if (length == 0) {
+            return null;
+        }
+        if (length > 1) {
+            throw new IllegalArgumentException("The source String is more than one character!");
+        }
+        return source.charAt(0);
+    }
+
+    @Override
+    public int getPriority() {
+        return NORMAL_PRIORITY + 8;
+    }
+}

dubbo-common/src/main/java/org/apache/dubbo/common/convert/StringToDoubleConverter.java

@@ -0,0 +1,39 @@
+/*
+ * 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.dubbo.common.convert;
+
+import static java.lang.Double.valueOf;
+import static org.apache.dubbo.common.utils.StringUtils.isNotEmpty;
+
+/**
+ * The class to convert {@link String} to {@link Double}
+ *
+ * @since 2.7.6
+ */
+public class StringToDoubleConverter implements StringConverter<Double> {
+
+    @Override
+    public Double convert(String source) {
+        return isNotEmpty(source) ? valueOf(source) : null;
+    }
+
+
+    @Override
+    public int getPriority() {
+        return NORMAL_PRIORITY + 3;
+    }
+}

dubbo-common/src/main/java/org/apache/dubbo/common/convert/StringToFloatConverter.java

@@ -0,0 +1,38 @@
+/*
+ * 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.dubbo.common.convert;
+
+import static java.lang.Float.valueOf;
+import static org.apache.dubbo.common.utils.StringUtils.isNotEmpty;
+
+/**
+ * The class to convert {@link String} to {@link Float}
+ *
+ * @since 2.7.6
+ */
+public class StringToFloatConverter implements StringConverter<Float> {
+
+    @Override
+    public Float convert(String source) {
+        return isNotEmpty(source) ? valueOf(source) : null;
+    }
+
+    @Override
+    public int getPriority() {
+        return NORMAL_PRIORITY + 4;
+    }
+}

dubbo-common/src/main/java/org/apache/dubbo/common/convert/StringToIntegerConverter.java

@@ -0,0 +1,38 @@
+/*
+ * 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.dubbo.common.convert;
+
+import static java.lang.Integer.valueOf;
+import static org.apache.dubbo.common.utils.StringUtils.isNotEmpty;
+
+/**
+ * The class to convert {@link String} to {@link Integer}
+ *
+ * @since 2.7.6
+ */
+public class StringToIntegerConverter implements StringConverter<Integer> {
+
+    @Override
+    public Integer convert(String source) {
+        return isNotEmpty(source) ? valueOf(source) : null;
+    }
+
+    @Override
+    public int getPriority() {
+        return NORMAL_PRIORITY;
+    }
+}