001/*
002 * Copyright (c) 2009 The openGion Project.
003 *
004 * Licensed under the Apache License, Version 2.0 (the "License");
005 * you may not use this file except in compliance with the License.
006 * You may obtain a copy of the License at
007 *
008 *     http://www.apache.org/licenses/LICENSE-2.0
009 *
010 * Unless required by applicable law or agreed to in writing, software
011 * distributed under the License is distributed on an "AS IS" BASIS,
012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
013 * either express or implied. See the License for the specific language
014 * governing permissions and limitations under the License.
015 */
016package org.opengion.plugin.column;
017
018import org.opengion.hayabusa.common.HybsSystem;
019import org.opengion.hayabusa.db.AbstractRenderer;
020import org.opengion.hayabusa.db.CellRenderer;
021import org.opengion.hayabusa.db.DBColumn;
022import org.opengion.fukurou.util.StringUtil;
023
024/**
025 * QRCODE ﾚﾝﾃﾞﾗｰは、ｶﾗﾑのﾃﾞｰﾀからQRｺｰﾄﾞを表示する場合に使用するｸﾗｽです。
026 * div 要素に、QRｺｰﾄﾞに変換する文字列を設定して、それを qrcode.js を使用して QRｺｰﾄﾞに
027 * 変換します。一旦、画像ﾌｧｲﾙを生成してから表示する方式とは異なり、canvas に直接描画しています。
028 * その後、img に変換することで、Webの印刷が出来るようにしています。
029 * ﾊﾟﾗﾒｰﾀは、img ﾀｸﾞに適用されます。
030 *
031 * 基本的な構造は、ﾃﾞｰﾀ設定用の div要素 と QR表示用のcanvas起動用のscript です。
032 *
033 *    <div id="div≪ｶﾗﾑ名≫" class="QRDATA" >≪値≫</div>
034 *    <canvas id="can≪ｶﾗﾑ名≫" class="QRCANVAS" style="display:none;" > </canvas>
035 *    <img src="" id="img≪ｶﾗﾑ名≫" class="QRIMG" ≪ﾊﾟﾗﾒｰﾀ≫ >
036 *    <script>qrView("≪ｶﾗﾑ名≫");</script>
037 *
038 * script に CDNｻｰﾋﾞｽ を使うと、無線環境(iPad等)ではものすごく遅くなったため、ﾛｰｶﾙに配置することにします。
039 * <script src="https://cdn.jsdelivr.net/npm/qrcode@latest/build/qrcode.min.js"><!-- --></script>
040 *
041 * これらは、使用する画面に、組み込んでください。
042 * <script src="{@SYS.JSP}/common/option/qrcode.min.js"><!-- --></script>
043 * <script src="{@SYS.JSP}/common/option/videocamera.js"><!-- --></script>
044 *
045 * @og.rev 7.4.2.1 (2021/05/21) 新規作成
046 * @og.group ﾃﾞｰﾀ表示
047 *
048 * @version  7.4
049 * @author   Kazuhiko Hasegawa
050 * @since    JDK11.0,
051 */
052public class Renderer_QRCODE extends AbstractRenderer {
053        /** このﾌﾟﾛｸﾞﾗﾑのVERSION文字列を設定します。 {@value} */
054        private static final String VERSION = "8.5.3.0 (2023/09/08)" ;
055
056        private static final String BASE_HTML = "<div id='div≪ｶﾗﾑ名≫' class='QRDATA' >≪値≫</div>"
057                                                                        + CR +  "<canvas id='can≪ｶﾗﾑ名≫' class='QRCANVAS' style='display:none;' > </canvas>"
058                                                                        + CR +  "<img src='' id='img≪ｶﾗﾑ名≫' class='QRIMG' ≪ﾊﾟﾗﾒｰﾀ≫ >"
059                                                                        + CR +  "<script>qrView('≪ｶﾗﾑ名≫');</script>" ;
060
061        private String  name;
062        private String  param;
063
064        /**
065         * ﾃﾞﾌｫﾙﾄｺﾝｽﾄﾗｸﾀｰ
066         *
067         * @og.rev 7.4.2.1 (2021/05/21) 新規作成
068         */
069        public Renderer_QRCODE() { super(); }           // これも、自動的に呼ばれるが、空のﾒｿｯﾄﾞを作成すると警告されるので、明示的にしておきます。
070
071        /**
072         * DBColumnｵﾌﾞｼﾞｪｸﾄを指定したprivateｺﾝｽﾄﾗｸﾀｰ。
073         *
074         * @og.rev 7.4.2.1 (2021/05/21) 新規作成
075         * @og.rev 8.5.3.0 (2023/09/08) DynamicAttributes対応
076         *
077         * @param       clm     DBColumnｵﾌﾞｼﾞｪｸﾄ
078         */
079        private Renderer_QRCODE( final DBColumn clm ) {
080                super();
081
082                name  = clm.getName();
083//              param = StringUtil.nvalAdd( clm.getRendererParam() ,
084//                                                                      clm.getRendererAttributes().get( "optionAttributes" ) );
085                // 8.5.3.0 (2023/09/08) optionAttributesの使い方が分からない為、optionAttributesのｾｯﾄを廃止
086                param = StringUtil.nval( clm.getRendererParam() , "" );
087        }
088
089        /**
090         * 各ｵﾌﾞｼﾞｪｸﾄから自分のｲﾝｽﾀﾝｽを返します。
091         * 自分自身をｷｬｯｼｭするのか、新たに作成するのかは、各ｻﾌﾞｸﾗｽの実装に
092         * まかされます。
093         *
094         * @og.rev 7.4.2.1 (2021/05/21) 新規作成
095         *
096         * @param       clm     DBColumnｵﾌﾞｼﾞｪｸﾄ
097         * @return      CellEditorｵﾌﾞｼﾞｪｸﾄ
098         * @og.rtnNotNull
099         */
100        public CellRenderer newInstance( final DBColumn clm ) {
101                return new Renderer_QRCODE( clm );
102        }
103
104        /**
105         * ﾃﾞｰﾀの表示用文字列を返します。
106         *
107         * @og.rev 7.4.2.1 (2021/05/21) 新規作成
108         *
109         * @param       value   入力値
110         * @return      ﾃﾞｰﾀの表示用文字列
111         * @og.rtnNotNull
112         */
113        @Override
114        public String getValue( final String value ) {
115                return makeCanvas( name, value );
116        }
117
118        /**
119         * ﾃﾞｰﾀの表示用文字列を返します。
120         *
121         * @og.rev 7.4.2.1 (2021/05/21) 新規作成
122         *
123         * @param       row             行番号
124         * @param       value   入力値
125         *
126         * @return      ﾃﾞｰﾀ表示用の文字列
127         * @og.rtnNotNull
128         */
129        @Override
130        public String getValue( final int row,final String value ) {
131                final String newName = name + HybsSystem.JOINT_STRING + row;
132                return makeCanvas( newName, value );
133        }
134
135        /**
136         * ﾃﾞｰﾀ出力用の文字列を作成します。
137         * ﾌｧｲﾙ等に出力する形式を想定しますので、HTMLﾀｸﾞを含まない
138         * ﾃﾞｰﾀを返します。
139         * 基本は、#getValue( String ) をそのまま返します。
140         *
141         * @og.rev 7.4.2.1 (2021/05/21) 新規作成
142         *
143         * @param       value   入力値
144         * @return      ﾃﾞｰﾀ出力用の文字列
145         * @og.rtnNotNull
146         * @see         #getValue( String )
147         */
148        @Override
149        public String getWriteValue( final String value ) {
150                return value == null ? "" : value;
151        }
152
153        /**
154         * ﾃﾞｰﾀの表示用文字列を返します。
155         *
156         * @og.rev 7.4.2.1 (2021/05/21) 新規作成
157         *
158         * @param       name    ｶﾗﾑ名
159         * @param       value   入力値 表示するﾌｧｲﾙのｱﾄﾞﾚｽ
160         * @return      ﾃﾞｰﾀ表示用の文字列
161         * @og.rtnNotNull
162         */
163        private String makeCanvas( final String name,final String value ) {
164                return BASE_HTML.replaceAll( "≪ｶﾗﾑ名≫" , name ).replaceAll( "≪ﾊﾟﾗﾒｰﾀ≫" , param ).replaceAll( "≪値≫" , value );
165        }
166}