language export

[rotty3000]

• define a /messages/export resource
• generate
• impl
• add service access policy
• use language key
• buildLang
• rename
• format source
• put into the language cache

Don't forget to enable the feature flag:

feature.flag.LPD-27222=true

/*
 * This could get stashed into a lib somewhere convenient
 * (I didn't want to attach it to Liferay.Language because 
 * that's such a simple object)
 */
const fetchTranslations = async (keys) => {
    return await fetch(
        '/o/language/v1.0/messages/export?' + new URLSearchParams({
            languageId: Liferay.ThemeDisplay.getLanguageId()
        }), {
            body: JSON.stringify(keys),
            headers: {
                "Accept": "application/json",
                "Content-Type": "application/json"
            },
            method: 'POST'
        }
    ).then(
        r => r.json()
    ).then(
        r => r.items.reduce(
            (map, obj) => (map[obj.key] = obj.value, map), {}
        )
    );
};

// from here is user api...

// collect the keys somewhere in the app (maybe with tooling support)
let keys = [
    "800-by-600-pixels",
    "1024-by-768-pixels",
    "AUTHORIZATION_CODE",
    "AUTHORIZATION_CODE_PKCE",
    "AUTHORIZED_OAUTH2_SAP"
];

// lastly, early before rendering
Liferay.Language.put(await fetchTranslations(keys));

Test the api with curl:

curl http://localhost:8080/o/language/v1.0/messages/export?languageId=en_US \
  -s \
  --json '["800-by-600-pixels","1024-by-768-pixels","AUTHORIZATION_CODE","AUTHORIZATION_CODE_PKCE","AUTHORIZED_OAUTH2_SAP"]' | \
  jq 'reduce .items[] as $i ({}; .[$i.key] = $i.value)'

result should be:

{
  "800-by-600-pixels": "800 by 600 Pixels",
  "1024-by-768-pixels": "1024 by 768 Pixels",
  "AUTHORIZATION_CODE": "Authorization Code",
  "AUTHORIZATION_CODE_PKCE": "PKCE Extended Authorization Code",
  "AUTHORIZED_OAUTH2_SAP": "Service Access Policy for REST Requests Authorized by OAuth2"
}

[liferay-continuous-integration]

To conserve resources, the PR Tester does not automatically run for every pull.

If your code changes were already tested in another pull, reference that pull in this pull so the test results can be analyzed.

If your pull was never tested, comment "ci:test" to run the PR Tester for this pull.