JTBC-JSP版函數(shù)講解二

導(dǎo)航: 上一頁(yè)

• getString(String argString)

參數(shù):argString, 字符串

作用:返回該字符串，當(dāng)出現(xiàn)null值時(shí)返回空字符串。

• getSwitchOptions(String argKeys)

參數(shù):argKeys, 關(guān)鍵字

作用:按照關(guān)鍵字中設(shè)定的值，取出指定的選項(xiàng)，這些選項(xiàng)預(yù)存在網(wǎng)站根目錄下的 common/language/sel_switch.jtbc 文件中。

• htmlencode(String argString, String argType)

參數(shù):argString, 字符串 argType(可選), 類型

作用:將字符串進(jìn)行htmlencode編碼。

• inavigation(String argStrings)

參數(shù):argStrings, 復(fù)合參數(shù)型字符串(格式: "genre=articles;class=1" ...)

作用:按照指定的條件輸出導(dǎo)航。

復(fù)合參數(shù):

1. genre: 設(shè)定需要調(diào)用數(shù)據(jù)所屬的模塊名(設(shè)置成&hidden時(shí)隱藏)。
2. lng: 語(yǔ)言ID，調(diào)用這個(gè)語(yǔ)言下的記錄。
3. class: 類別的ID
4. genrelink: 模塊鏈接(設(shè)置成&hidden時(shí)隱藏鏈接)。

示例:

{$=inavigation("class={$-class}")} = 常用的有分類的默認(rèn)導(dǎo)航

• ireplace(String argXInfostr, String argXInfoType, String argVars)

參數(shù):argXInfostr, 路徑與節(jié)點(diǎn)字符串 argXInfoType, 類型字符串(lng,sel,tpl,cfg) argVars(可選), 自定義替換的變量

作用:按照給定的路徑與節(jié)點(diǎn)讀取.jtbc文件中的內(nèi)容。

示例:

{$=ireplace("default.channel_title", "lng")} = 調(diào)用當(dāng)前目錄下的 common/language/default.jtbc 中的 channel_title 節(jié)點(diǎn)的內(nèi)容

{$=ireplace("default.list", "tpl")} = 調(diào)用當(dāng)前目錄下的 common/template/default.jtbc 中的 list 節(jié)點(diǎn)的內(nèi)容

{$=ireplace("global.articles:default.list", "tpl")} = 調(diào)用全局目錄下的 articles/common/template/default.jtbc 中的 list 節(jié)點(diǎn)的內(nèi)容

{$=ireplace("global.articles:default.list", "tpl", "-a=1|-b=2")} = 調(diào)用全局目錄下的 articles/common/template/default.jtbc 
中的 list 節(jié)點(diǎn)的內(nèi)容，其中的{$-a}等于1{$-b}等于2

備注:

問(wèn)：如何根據(jù) argXInfostr 參數(shù)找到文件路徑？

答：先根據(jù) argXInfoType 參數(shù)確定目錄 lng,sel 屬于 common/language 目錄 tpl 屬于 common/template 目錄 cfg 屬于 common 目錄，再看 argXInfostr 參數(shù)，形如 default.list 表示 default.jtbc 中的 list 節(jié)點(diǎn)，形如 global.articles:default.list 表示 是全局目錄下的articles 目錄下的某個(gè)default.jtbc 中的 list節(jié)點(diǎn)，再根據(jù)前面的目錄可以得出 common/language/default.jtbc 與網(wǎng)站根目錄下的 articles/common/language/default.jtbc

問(wèn)：itake 與 ireplace 有什么不同？

答：itake 只負(fù)責(zé)取出數(shù)據(jù)，而 ireplace 在實(shí)現(xiàn) itake 功能的同時(shí)還會(huì)將模板中的 {$=格式} 的標(biāo)簽做相應(yīng)的解析

• isort(String argStrings)

參數(shù):argStrings, 復(fù)合參數(shù)型字符串(格式: "tpl=1;genre=articles" ...)

作用:按照指定的條件將分類數(shù)據(jù)按照指定的模板格式化輸出。

復(fù)合參數(shù):

1. tpl: 模板節(jié)點(diǎn)名或者模板路徑(如 1 表示模板取自 global.tpl_transfer.1，module.1 表示模板取自 module.1)。
2. genre: 設(shè)定需要調(diào)用數(shù)據(jù)所屬的模塊名。
3. lng: 語(yǔ)言ID，調(diào)用這個(gè)語(yǔ)言下的記錄。
4. fid: 父ID，只調(diào)用等于這個(gè)父ID的記錄。
5. vars: 預(yù)設(shè)變量，如果設(shè)置此值，在模板中將按照這些規(guī)則替換標(biāo)簽(如 vars=a=1|b=2 在模板中將可以使用 {$a}代表1 {$b}代表2)。
6. valids: 有效的ID，設(shè)定此值后只顯示屬于這個(gè)值里面的分類記錄。

示例:

{$=isort("genre=articles;tpl=s1")} = 調(diào)用文章(articles)第一級(jí)別的分類，按照預(yù)設(shè)的調(diào)用模板為s1的模板樣式格式化輸出

• itake(String argXInfostr, String argXInfoType, String argVars)

參數(shù):argXInfostr, 路徑與節(jié)點(diǎn)字符串 argXInfoType, 類型字符串(lng,sel,tpl,cfg) argVars(可選), 自定義替換的變量

作用:按照給定的路徑與節(jié)點(diǎn)讀取.jtbc文件中的內(nèi)容。

示例:

{$=itake("default.channel_title", "lng")} = 調(diào)用當(dāng)前目錄下的 common/language/default.jtbc 中的 channel_title 節(jié)點(diǎn)的內(nèi)容

{$=itake("default.list", "tpl")} = 調(diào)用當(dāng)前目錄下的 common/template/default.jtbc 中的 list 節(jié)點(diǎn)的內(nèi)容

{$=itake("global.articles:default.list", "tpl")} = 調(diào)用全局目錄下的 articles/common/template/default.jtbc 中的 list 節(jié)點(diǎn)的內(nèi)容

{$=itake("global.articles:default.list", "tpl", "-a=1|-b=2")} = 調(diào)用全局目錄下的 articles/common/template/default.jtbc 
中的 list 節(jié)點(diǎn)的內(nèi)容，其中的{$-a}等于1{$-b}等于2

備注:

問(wèn)：如何根據(jù) argXInfostr 參數(shù)找到文件路徑？

答：先根據(jù) argXInfoType 參數(shù)確定目錄 lng,sel 屬于 common/language 目錄 tpl 屬于 common/template 目錄 cfg 屬于 common 目錄，再看 argXInfostr 參數(shù)，形如 default.list 表示 default.jtbc 中的 list 節(jié)點(diǎn)，形如 global.articles:default.list 表示 是全局目錄下的 articles 目錄下的某個(gè) default.jtbc 中的 list 節(jié)點(diǎn)，再根據(jù)前面的目錄可以得出 common/language/default.jtbc 與 網(wǎng)站根目錄下的 articles/common/language/default.jtbc

• itransfer(String argStrings)

參數(shù):argStrings, 復(fù)合參數(shù)型字符串(格式: "tpl=1;type=new;topx=10" ...)

(常規(guī)調(diào)用)作用:按照指定的條件將數(shù)據(jù)庫(kù)中的數(shù)據(jù)按照指定的模板格式化輸出。

復(fù)合參數(shù):

1. tpl: 模板節(jié)點(diǎn)名或者模板路徑(如 1 表示模板取自 global.tpl_transfer.1，module.1 表示模板取自 module.1)。
2. tplstr: 模板字符串，當(dāng)設(shè)置此值時(shí)，模板直接使用這個(gè)字符串作為模板，如果設(shè)置tpl參數(shù)將不再有效。
3. type: 調(diào)用數(shù)據(jù)的類型，預(yù)設(shè)的有 new(按時(shí)間排序最新)、top(按ID號(hào)排序最新)、commendatory(推薦的)、up(上面的記錄)、down(下面的記錄)等。
4. genre: 設(shè)定需要調(diào)用數(shù)據(jù)所屬的模塊名。
5. ndatabase: 單獨(dú)設(shè)置調(diào)用的數(shù)據(jù)庫(kù)表名。
6. nfpre: 單獨(dú)設(shè)置調(diào)用的數(shù)據(jù)庫(kù)表中的字段前綴。
7. osql: 附加SQL語(yǔ)句。
8. osqlorder: 附加SQL排序語(yǔ)句(設(shè)定此值后預(yù)設(shè)的排序方式失效，以此設(shè)置為準(zhǔn))。
9. baseurl: 基地址。
10. vars: 預(yù)設(shè)變量，如果設(shè)置此值，在模板中將按照這些規(guī)則替換標(biāo)簽(如 vars=a=1|b=2 在模板中將可以使用 {$a}代表1 {$b}代表2)
11. topx: 調(diào)用數(shù)據(jù)的前X條記錄。
12. cls: 模糊類別編號(hào)，調(diào)用這個(gè)類別下的所有記錄（包括子類別）
13. class: 精確類別編號(hào)，調(diào)用這個(gè)類別下的所有記錄（不包括子類別）
14. lng: 語(yǔ)言ID，調(diào)用這個(gè)語(yǔ)言下的記錄
15. bid: 基準(zhǔn)ID，按照這個(gè)ID計(jì)算上與下(與type=up或者type=down配合使用)

示例:

{$=itransfer("genre=products;tpl=1;type=new;topx=10")} = 調(diào)用產(chǎn)品(products)模塊下的前10條最新的記錄，按照預(yù)設(shè)的調(diào)用模板為1的模板樣式格式化輸出

{$=itransfer("genre=products;tpl=2;type=commendatory;topx=10")} = 調(diào)用產(chǎn)品(products)模塊下的前10條最新推薦的記錄，按照預(yù)設(shè)的調(diào)用模板為2的模板樣式格式化輸出

• [method=sql](SQL語(yǔ)句)作用:

按照指定的SQL語(yǔ)句將數(shù)據(jù)庫(kù)中的數(shù)據(jù)按照指定的模板格式化輸出。

復(fù)合參數(shù):

1. sql: 需要查詢數(shù)據(jù)的SQL語(yǔ)句。
2. tpl: 模板節(jié)點(diǎn)名或者模板路徑(如 1 表示模板取自 global.tpl_transfer.1，module.1 表示模板取自 module.1)。
3. tplstr: 模板字符串，當(dāng)設(shè)置此值時(shí)，模板直接使用這個(gè)字符串作為模板，如果設(shè)置tpl參數(shù)將不再有效。
4. genre: 設(shè)定需要調(diào)用數(shù)據(jù)所屬的模塊名。
5. baseurl: 基地址。
6. vars: 預(yù)設(shè)變量，如果設(shè)置此值，在模板中將按照這些規(guī)則替換標(biāo)簽(如 vars=a=1|b=2 在模板中將可以使用 {$a}代表1 {$b}代表2)

示例:

{$=itransfer("method=sql;sql=select * from jtbc_aboutus;tpl=1")} = 調(diào)用數(shù)據(jù)庫(kù)表(jtbc_aboutus)中的所有記錄，按照預(yù)設(shè)的調(diào)用模板為1的模板樣式格式化輸出

• [method=itakes](JTBC文件)作用:

按照指定的參數(shù)將某個(gè)JTBC文件中的數(shù)據(jù)按照指定的模板格式化輸出。

復(fù)合參數(shù):

1. xinfostr: 文件代號(hào)。
2. xinfotype: 文件類型(cfg/lng/tpl)。
3. xinfolimit: 限制調(diào)用的名稱范圍以“,”間隔。
4. tpl: 模板節(jié)點(diǎn)名或者模板路徑(如 1 表示模板取自 global.tpl_transfer.1，module.1 表示模板取自 module.1)。
5. tplstr: 模板字符串，當(dāng)設(shè)置此值時(shí)，模板直接使用這個(gè)字符串作為模板，如果設(shè)置tpl參數(shù)將不再有效。
6. genre: 設(shè)定需要調(diào)用數(shù)據(jù)所屬的模塊名。
7. baseurl: 基地址。
8. vars: 預(yù)設(shè)變量，如果設(shè)置此值，在模板中將按照這些規(guī)則替換標(biāo)簽(如 vars=a=1|b=2 在模板中將可以使用 {$a}代表1 {$b}代表2)

示例:

{$=itransfer("method=itakes;xinfostr=global.lng_config.jtbc;xinfotype=lng;tpl=1")} = 調(diào)用網(wǎng)站根目錄下common/language/lng_config.jtbc文件中的所有記錄，按照預(yù)設(shè)的調(diào)用模板為1的模板樣式格式化輸出

• method=multigenre](多模塊)作用:

按照指定的多個(gè)模塊的參數(shù)將其所有的數(shù)據(jù)按照指定的模板格式化輸出。

復(fù)合參數(shù):

1. tpl: 模板節(jié)點(diǎn)名或者模板路徑(如 1 表示模板取自 global.tpl_transfer.1，module.1 表示模板取自 module.1)。
2. tplstr: 模板字符串，當(dāng)設(shè)置此值時(shí)，模板直接使用這個(gè)字符串作為模板，如果設(shè)置tpl參數(shù)將不再有效。
3. type: 調(diào)用數(shù)據(jù)的類型，預(yù)設(shè)的有 new(按時(shí)間排序最新)、commendatory(推薦的)等。
4. genre: 設(shè)定需要調(diào)用數(shù)據(jù)所屬的模塊名。
5. field: 字段列表(id,time默認(rèn)選擇，其他字段需枚舉)。
6. osql: 附加SQL語(yǔ)句(此處附加的SQL語(yǔ)句字段前綴為“un_”)。
7. osqlorder: 附加SQL排序語(yǔ)句(此處附加的SQL語(yǔ)句字段前綴為“un_”，設(shè)定此值后預(yù)設(shè)的排序方式失效，以此設(shè)置為準(zhǔn))。
8. baseurl: 基地址。
9. vars: 預(yù)設(shè)變量，如果設(shè)置此值，在模板中將按照這些規(guī)則替換標(biāo)簽(如 vars=a=1|b=2 在模板中將可以使用 {$a}代表1 {$b}代表2)
10. lng: 語(yǔ)言ID，調(diào)用這個(gè)語(yǔ)言下的記錄

示例:

{$=itransfer("method=multigenre;type=new;genre=articles&products;field=topic&content;tpl=1")} = 調(diào)用網(wǎng)站中的文章以及產(chǎn)品模塊的所有記錄，按照預(yù)設(shè)的調(diào)用模板為1的模板樣式格式化輸出