/*
 * Copyright (c) 2009 The openGion Project.
 *
 * Licensed 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.opengion.plugin.column;

import org.opengion.fukurou.util.StringUtil;
import org.opengion.fukurou.util.TagBuffer;
import org.opengion.hayabusa.common.HybsSystem;
import org.opengion.hayabusa.db.AbstractRenderer;
import org.opengion.hayabusa.db.CellRenderer;
import org.opengion.hayabusa.db.DBColumn;

/**
 * IMAGE ﾚﾝﾃﾞﾗは、value で指定したﾌｧｲﾙをimgﾀｸﾞで表示する場合に
 * 使用するｸﾗｽです。
 * imgのｻｲｽﾞはﾚﾝﾃﾞﾗｰﾊﾟﾗﾒｰﾀに、設定したい属性を記述します。
 * 例えば、width='600px' height='450px' などです。
 * src属性はvalueを設定し、<del>name属性はｶﾗﾑ名(複数行の場合は、行番号付きの名前)</del>
 * alt属性は、そのままvalueを設定しておきます。
 * img の親には、div要素と class=&quot;Renderer_IMAGE&quot; を付与しておきます。
 *
 * &lt;div class=&quot;Renderer_IMAGE&quot;&gt;
 *     &lt;img src=&quot;valueの値&quot; alt=&quot;ｶﾗﾑ名&quot; ﾚﾝﾃﾞﾗｰﾊﾟﾗﾒｰﾀ &gt;
 * &lt;/div&gt;
 *
 * ｶﾗﾑの表示に必要な属性は、DBColumn ｵﾌﾞｼﾞｪｸﾄ より取り出します。
 * このｸﾗｽは、DBColumn ｵﾌﾞｼﾞｪｸﾄ毎に1つ作成されます。
 *
 * @og.rev 7.4.2.0 (2021/04/30) 新規作成
 * @og.group ﾃﾞｰﾀ表示
 *
 * @version     7.4
 * @author      Kazuhiko Hasegawa
 * @since       JDK11.0,
 */
public class Renderer_IMAGE extends AbstractRenderer {
        /** このﾌﾟﾛｸﾞﾗﾑのVERSION文字列を設定します。 {@value} */
        private static final String VERSION = "8.5.3.0 (2023/09/08)" ;

        private static final String DIV_ST = "<div class=\"Renderer_IMAGE\">";
        private static final String DIV_ED = "</div>";

        private String  name;
        private String  param;

        /**
         * ﾃﾞﾌｫﾙﾄｺﾝｽﾄﾗｸﾀｰ。
         * このｺﾝｽﾄﾗｸﾀｰで、基本ｵﾌﾞｼﾞｪｸﾄを作成します。
         *
         */
        public Renderer_IMAGE() { super(); }            // これも、自動的に呼ばれるが、空のﾒｿｯﾄﾞを作成すると警告されるので、明示的にしておきます。

        /**
         * DBColumnｵﾌﾞｼﾞｪｸﾄを指定したprivateｺﾝｽﾄﾗｸﾀｰ。
         *
         * @og.rev 7.4.2.0 (2021/04/30) 新規作成
         * @og.rev 8.5.3.0 (2023/09/08) DynamicAttributes対応
         *
         * @param       clm     DBColumnｵﾌﾞｼﾞｪｸﾄ
         */
        private Renderer_IMAGE( final DBColumn clm ) {
                // 6.4.1.1 (2016/01/16) PMD refactoring. It is a good practice to call super() in a constructor
                super();

                name  = clm.getName();

//              param = StringUtil.nval( clm.getRendererParam(), null );        // 空文字列はあえてnullにする。
//              param = StringUtil.nvalAdd( clm.getRendererParam() ,
//                                                                      clm.getRendererAttributes().get( "optionAttributes" ) );
                // 8.5.3.0 (2023/09/08) optionAttributesの使い方が分からない為、元に戻す
                param = StringUtil.nval( clm.getRendererParam(), null );        // 空文字列はあえてnullにする。
        }

        /**
         * 各ｵﾌﾞｼﾞｪｸﾄから自分のｲﾝｽﾀﾝｽを返します。
         * 自分自身をｷｬｯｼｭするのか、新たに作成するのかは、各ｻﾌﾞｸﾗｽの実装に
         * まかされます。
         *
         * @param       clm     DBColumnｵﾌﾞｼﾞｪｸﾄ
         * @return      CellEditorｵﾌﾞｼﾞｪｸﾄ
         * @og.rtnNotNull
         */
        public CellRenderer newInstance( final DBColumn clm ) {
                return new Renderer_IMAGE( clm );
        }

        /**
         * ﾃﾞｰﾀの表示用文字列を返します。
         *
         * @og.rev 7.4.2.0 (2021/04/30) 新規作成
         *
         * @param       value   入力値
         * @return      ﾃﾞｰﾀの表示用文字列
         * @og.rtnNotNull
         */
        @Override
        public String getValue( final String value ) {
                return makeImae( name, value );
        }

        /**
         * ﾃﾞｰﾀの表示用文字列を返します。
         *
         * @og.rev 7.4.2.0 (2021/04/30) 新規作成
         *
         * @param       row             行番号
         * @param       value   入力値
         * @return      ﾃﾞｰﾀ表示用の文字列
         * @og.rtnNotNull
         */
        @Override
        public String getValue( final int row,final String value ) {
                final String newName = name + HybsSystem.JOINT_STRING + row;
                return makeImae( newName, value );
        }

        /**
         * ﾃﾞｰﾀ出力用の文字列を作成します。
         * ﾌｧｲﾙ等に出力する形式を想定しますので、HTMLﾀｸﾞを含まない
         * ﾃﾞｰﾀを返します。
         * 基本は、#getValue( String ) をそのまま返します。
         *
         * @og.rev 7.4.2.0 (2021/04/30) 新規作成
         *
         * @param       value   入力値
         * @return      ﾃﾞｰﾀ出力用の文字列
         * @og.rtnNotNull
         * @see         #getValue( String )
         */
        @Override
        public String getWriteValue( final String value ) {
                return value == null ? "" : value;
        }

        /**
         * ﾃﾞｰﾀの表示用文字列を返します。
         *
         * @og.rev 7.4.2.0 (2021/04/30) 新規作成
         * @og.rev 8.5.3.0 (2023/09/08) HTML5廃止対応
         *
         * @param       name    ｶﾗﾑ名
         * @param       value   入力値 表示するﾌｧｲﾙのｱﾄﾞﾚｽ
         * @return      ﾃﾞｰﾀ表示用の文字列
         * @og.rtnNotNull
         */
        private String makeImae( final String name,final String value ) {
                return DIV_ST
                        +       new TagBuffer( "img" )
//                                      .add( "name"    , name  )                               // 8.5.3.0 (2023/09/08) Delete
                                        .add( "src"             , value )
//                                      .add( "alt"             , value )
                                        .add( "alt"             , name  )                               // 8.5.3.0 (2023/09/08) Modify
                                        .addOptions( param              )                               // ﾀｸﾞの属性として追加。nullの場合は、何もしない。
                                        .makeTag()
                        +       DIV_ED;
        }
}