You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@freemarker.apache.org by "Siegfried Goeschl (Jira)" <ji...@apache.org> on 2020/07/02 14:17:00 UTC

[jira] [Comment Edited] (FREEMARKER-148) [freemarker-cli] Make usage of "DataSources" more "Freemarker" like

    [ https://issues.apache.org/jira/browse/FREEMARKER-148?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17150326#comment-17150326 ] 

Siegfried Goeschl edited comment on FREEMARKER-148 at 7/2/20, 2:16 PM:
-----------------------------------------------------------------------

With help from [~woonsan] I got it running

{code:java}
Support FreeMarker Directives
---------------------------------------------------------------------------
Has Content: ${DataSources?has_content?c}
Nr. of Documents: ${DataSources?size}

Use FTL Array-style Access
---------------------------------------------------------------------------
${DataSources[0].toString()}

Use FTL Map-style access
---------------------------------------------------------------------------
${DataSources["github-users.json"].toString()}
${DataSources["github-users.json"].name}

Get Document Names As Keys
---------------------------------------------------------------------------
<#list DataSources?keys as name>
    ${name}<#lt>
</#list>

Iterate Over Names & DataSources
---------------------------------------------------------------------------
<#list DataSources as name, dataSource>
    ${name} => ${dataSource}<#lt>
</#list>

Find DataSources By Group
---------------------------------------------------------------------------
<#list DataSources.findByGroup("default") as dataSource>
    ${dataSource}<#lt>
</#list>

Find DataSources By Wildcard
---------------------------------------------------------------------------
<#list DataSources.find("*.csv") as dataSource>
    ${dataSource}<#lt>
</#list>

Java Array-style access
---------------------------------------------------------------------------
${DataSources.first.toString()}
${DataSources.get(0).toString()}

Invoke Arbitrary Methods On DataSources
---------------------------------------------------------------------------
empty       : ${DataSources.empty?c}
isEmpty()   : ${DataSources.isEmpty()?c}
size()      : ${DataSources.size()}
close()     : ${DataSources.close()}worx
{code}

generates the following output 


{noformat}
Support FreeMarker Directives
---------------------------------------------------------------------------
Has Content: true
Nr. of Documents: 2

Use Array-style access
---------------------------------------------------------------------------
DataSource{name='github-users.json', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/json/github-users.json}

Use Map-style access
---------------------------------------------------------------------------
DataSource{name='github-users.json', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/json/github-users.json}
github-users.json

Get Document Names as keys
---------------------------------------------------------------------------
github-users.json
contract.csv

Iterate Over Names & DataSources
---------------------------------------------------------------------------
github-users.json => DataSource{name='github-users.json', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/json/github-users.json}
contract.csv => DataSource{name='contract.csv', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/csv/contract.csv}

Find DataSources By Group
---------------------------------------------------------------------------
DataSource{name='github-users.json', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/json/github-users.json}
DataSource{name='contract.csv', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/csv/contract.csv}

Find DataSources By Wildcard
---------------------------------------------------------------------------
DataSource{name='contract.csv', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/csv/contract.csv}

Java Array-style access
---------------------------------------------------------------------------
DataSource{name='github-users.json', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/json/github-users.json}
DataSource{name='github-users.json', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/json/github-users.json}

Invoke Arbitray Methods On DataSources
---------------------------------------------------------------------------
empty       : false
isEmpty()   : false
size()      : 2
close()     : worx
{noformat}




was (Author: sgoeschl):
With help from [~woonsan] I got it running

{code:java}
Support FreeMarker Directives
---------------------------------------------------------------------------
Has Content: ${DataSources?has_content?c}
Nr. of Documents: ${DataSources?size}

Use FTL Array-style Access
---------------------------------------------------------------------------
${DataSources[0].toString()}

Use FTL Map-style access
---------------------------------------------------------------------------
${DataSources["github-users.json"].toString()}
${DataSources["github-users.json"].name}

Get Document Names As Keys
---------------------------------------------------------------------------
<#list DataSources?keys as name>
    ${name}<#lt>
</#list>

Iterate Over Names & DataSources
---------------------------------------------------------------------------
<#list DataSources as name, dataSource>
    ${name} => ${dataSource}<#lt>
</#list>

Find DataSources By Group
---------------------------------------------------------------------------
<#list DataSources.findByGroup("default") as dataSource>
    ${dataSource}<#lt>
</#list>

Find DataSources By Wildcard
---------------------------------------------------------------------------
<#list DataSources.find("*.csv") as dataSource>
    ${dataSource}<#lt>
</#list>

Java Array-style access
---------------------------------------------------------------------------
${DataSources.first.toString()}
${DataSources.get(0).toString()}

Invoke Arbitrary Methods On DataSources
---------------------------------------------------------------------------
empty       : ${DataSources.empty?c}
isEmpty()   : ${DataSources.isEmpty()?c}
size()      : ${DataSources.size()}
close()     : ${DataSources.close()}worx
{code}

generates the following output 


{noformat}
Support FreeMarker Directives
---------------------------------------------------------------------------
Has Content: true
Nr. of Documents: 2

Use Array-style access
---------------------------------------------------------------------------
DataSource{name='github-users.json', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/json/github-users.json}

Use Map-style access
---------------------------------------------------------------------------
DataSource{name='github-users.json', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/json/github-users.json}
github-users.json

Get Document Names as keys
---------------------------------------------------------------------------
github-users.json
contract.csv

Iterate Over Names & DataSources
---------------------------------------------------------------------------
github-users.json => DataSource{name='github-users.json', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/json/github-users.json}
contract.csv => DataSource{name='contract.csv', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/csv/contract.csv}

Find DataSources By Group
---------------------------------------------------------------------------
DataSource{name='github-users.json', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/json/github-users.json}
DataSource{name='contract.csv', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/csv/contract.csv}

Find DataSources By Wildcard
---------------------------------------------------------------------------
DataSource{name='contract.csv', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/csv/contract.csv}

Java Array-style access
---------------------------------------------------------------------------
DataSource{name='github-users.json', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/json/github-users.json}
DataSource{name='github-users.json', group='default', uri=file:/Users/sgoeschl/work/github/apache/freemarker-generator/freemarker-generator-cli/examples/data/json/github-users.json}

Invoke Arbitray Methods On DataSources
---------------------------------------------------------------------------
empty       : false
isEmpty()   : false
size()      : 2
close()     : worx
{noformat}



> [freemarker-cli] Make usage of "DataSources" more "Freemarker" like
> -------------------------------------------------------------------
>
>                 Key: FREEMARKER-148
>                 URL: https://issues.apache.org/jira/browse/FREEMARKER-148
>             Project: Apache Freemarker
>          Issue Type: Task
>            Reporter: Siegfried Goeschl
>            Assignee: Siegfried Goeschl
>            Priority: Major
>
> "DataSources" is exposed to get/find documents - as suggested it would be nice to make the access more aligned with FreeMarker usage.
> The way to go is to wrap "DataSources" and expose "TemplateSequenceModel" and "TemplateHashModel".
> So accessing the first datasource would look like 
> {code:java}
> ${GsonTool.toJson(YamlTool.parse(DataSources[0]))}
> {code}
> instead of 
> {code:java}
> ${GsonTool.toJson(YamlTool.parse(DataSources.get(0)))}
> {code}



--
This message was sent by Atlassian Jira
(v8.3.4#803005)