summaryrefslogtreecommitdiffstats
path: root/generate-uml-snapshot.sh
diff options
context:
space:
mode:
authorKeong Lim <keong.lim@huawei.com>2019-05-17 15:29:58 +1000
committerKeong Lim <keong.lim@huawei.com>2019-05-31 13:45:53 +1000
commitcae9c8df0bfdbc22cdbca4624a0bc4f9555ad5f2 (patch)
tree10e17448288c2f1dbf75256e998f16562c34eeac /generate-uml-snapshot.sh
parent749dea32a7c883a1418008135ba15cdca9901c30 (diff)
AAI-2441 Swagger to document AAI schema PlantUML
Use Swagger template to generate a file close to PlantUML diagram format from the AAI schema (OXM file) Run generate-uml-snapshot.sh to massage it to complete the set of class diagrams with compositions and another set of diagrams with EdgeRule relationships Add the generated plantuml text files Ignore the /plantuml/backups/ files Change-Id: I7ef8363095bf1adcf0f7ad792051b4e593683609 Issue-ID: AAI-2441 Signed-off-by: Keong Lim <keong.lim@huawei.com>
Diffstat (limited to 'generate-uml-snapshot.sh')
-rw-r--r--generate-uml-snapshot.sh142
1 files changed, 142 insertions, 0 deletions
diff --git a/generate-uml-snapshot.sh b/generate-uml-snapshot.sh
new file mode 100644
index 0000000..235f5a1
--- /dev/null
+++ b/generate-uml-snapshot.sh
@@ -0,0 +1,142 @@
+#!/bin/sh
+
+# time ./generate-uml-snapshot.sh 2>&1 | tee log-generate-uml-snapshot.txt
+
+set -x
+
+# start in aai/schema-service repo
+STARTDIR=`pwd`
+git status
+
+# modify templates
+if [ -f ${STARTDIR}/aai-schema-gen/src/main/resources/swagger.html.ftl -a -f ${STARTDIR}/aai-schema-gen/src/main/resources/swagger.plantuml.ftl ] ; then
+ cp ${STARTDIR}/aai-schema-gen/src/main/resources/swagger.plantuml.ftl ${STARTDIR}/aai-schema-gen/src/main/resources/swagger.html.ftl
+ mvn --offline -DskipTests process-classes
+ git status
+fi
+
+# $ find aai-schema/src/main -name "aai_swagger_*.html"
+# aai-schema/src/main/resources/onap/aai_swagger_html/aai_swagger_v10.html
+# aai-schema/src/main/resources/onap/aai_swagger_html/aai_swagger_v11.html
+# aai-schema/src/main/resources/onap/aai_swagger_html/aai_swagger_v12.html
+# aai-schema/src/main/resources/onap/aai_swagger_html/aai_swagger_v13.html
+# aai-schema/src/main/resources/onap/aai_swagger_html/aai_swagger_v14.html
+# aai-schema/src/main/resources/onap/aai_swagger_html/aai_swagger_v15.html
+# aai-schema/src/main/resources/onap/aai_swagger_html/aai_swagger_v16.html
+
+
+mkdir -p ${STARTDIR}/plantuml/backups
+cp ${STARTDIR}/aai-schema/src/main/resources/onap/aai_swagger_html/aai_swagger_*.html ${STARTDIR}/plantuml/
+
+cd ${STARTDIR}/plantuml/
+
+# OXM transformation - class names
+for f in aai_swagger_*.html ; do mv $f `basename $f | sed 's/\.html//'`.plantuml ; done
+
+# pre-clean
+sed -i.bak0 -s 's/\/{[^\/]*}//g' aai_swagger_*.plantuml
+sed -i.bak1 -s 's/\/relationship[^\/]*//g' aai_swagger_*.plantuml
+
+grep -c "^class.*\/" aai_swagger_*.plantuml
+RET=$?
+COUNT=0
+while [ ${RET} -eq 0 ] ; do
+ COUNT=$(( COUNT + 1 ))
+ echo Replacing ${COUNT}...
+ sed -i.bak2-${COUNT} -s 's/^class \/\([^\/]*\)/class \1\nclass /' aai_swagger_*.plantuml
+ grep -c "^class.*\/" aai_swagger_*.plantuml
+ RET=$?
+done
+
+# unique without sorting
+for f in aai_swagger_*.plantuml ; do
+ cp ${f} ${f}.bak3
+ awk '!a[$0]++' ${f}.bak3 > ${f}
+done
+
+# OXM transformation - compositions
+sed -i.bak4 -s 's/^\//"/g' aai_swagger_*.plantuml
+
+grep -c "^\".*\/.*\/" aai_swagger_*.plantuml
+RET=$?
+COUNT=0
+while [ ${RET} -eq 0 ] ; do
+ COUNT=$(( COUNT + 1 ))
+ echo Replacing ${COUNT}...
+ sed -i.bak5-${COUNT} -s 's/^"[^\/]*\/\([^\/]*\)\//"\1\//' aai_swagger_*.plantuml
+ grep -c "^\".*\/.*\/" aai_swagger_*.plantuml
+ RET=$?
+done
+
+sed -i.bak6 -s 's/^"\([^\/]*\)\/\([^\/]*\)/"\1" *-- "\2"/' aai_swagger_*.plantuml
+
+# post-clean
+sed -i.bak7 -s '/^class $/d' aai_swagger_*.plantuml
+sed -i.bak8 -s '/^Note: Convert/d' aai_swagger_*.plantuml
+
+# unique without sorting
+for f in aai_swagger_*.plantuml ; do
+ cp ${f} ${f}.bak9
+ awk '!a[$0]++' ${f}.bak9 > ${f}
+done
+
+
+# $ find aai-schema/src/main -name "DbEdgeRules*.json"
+# aai-schema/src/main/resources/onap/dbedgerules/v10/DbEdgeRules_v10.json
+# aai-schema/src/main/resources/onap/dbedgerules/v11/DbEdgeRules_esr_v11.json
+# aai-schema/src/main/resources/onap/dbedgerules/v11/DbEdgeRules_v11.json
+# aai-schema/src/main/resources/onap/dbedgerules/v12/DbEdgeRules_esr_v12.json
+# aai-schema/src/main/resources/onap/dbedgerules/v12/DbEdgeRules_hpa_v12.json
+# aai-schema/src/main/resources/onap/dbedgerules/v12/DbEdgeRules_v12.json
+# aai-schema/src/main/resources/onap/dbedgerules/v13/DbEdgeRules_esr_v13.json
+# aai-schema/src/main/resources/onap/dbedgerules/v13/DbEdgeRules_hpa_v13.json
+# aai-schema/src/main/resources/onap/dbedgerules/v13/DbEdgeRules_v13.json
+# aai-schema/src/main/resources/onap/dbedgerules/v14/DbEdgeRules_ccvpn_v14.json
+# aai-schema/src/main/resources/onap/dbedgerules/v14/DbEdgeRules_esr_v14.json
+# aai-schema/src/main/resources/onap/dbedgerules/v14/DbEdgeRules_hpa_v14.json
+# aai-schema/src/main/resources/onap/dbedgerules/v14/DbEdgeRules_pnp_v14.json
+# aai-schema/src/main/resources/onap/dbedgerules/v14/DbEdgeRules_v14.json
+# aai-schema/src/main/resources/onap/dbedgerules/v15/DbEdgeRules_ccvpn_v15.json
+# aai-schema/src/main/resources/onap/dbedgerules/v15/DbEdgeRules_esr_v15.json
+# aai-schema/src/main/resources/onap/dbedgerules/v15/DbEdgeRules_hpa_v15.json
+# aai-schema/src/main/resources/onap/dbedgerules/v15/DbEdgeRules_pnp_v15.json
+# aai-schema/src/main/resources/onap/dbedgerules/v15/DbEdgeRules_v15.json
+# aai-schema/src/main/resources/onap/dbedgerules/v16/DbEdgeRules_bbs_v16.json
+# aai-schema/src/main/resources/onap/dbedgerules/v16/DbEdgeRules_ccvpn_v16.json
+# aai-schema/src/main/resources/onap/dbedgerules/v16/DbEdgeRules_esr_v16.json
+# aai-schema/src/main/resources/onap/dbedgerules/v16/DbEdgeRules_hpa_v16.json
+# aai-schema/src/main/resources/onap/dbedgerules/v16/DbEdgeRules_pnp_v16.json
+# aai-schema/src/main/resources/onap/dbedgerules/v16/DbEdgeRules_v16.json
+# aai-schema/src/main/resources/onap/dbedgerules/v8/DbEdgeRules_v8.json
+# aai-schema/src/main/resources/onap/dbedgerules/v9/DbEdgeRules_v9.json
+
+# EdgeRule transformation
+for g in v16 v15 v14 v13 v12 v11 ; do
+ cat ${STARTDIR}/aai-schema/src/main/resources/onap/dbedgerules/${g}/DbEdgeRules*_${g}.json >> ${STARTDIR}/plantuml/aai_edgerules_${g}.plantuml
+done
+
+for f in v16 v15 v14 v13 v12 v11 ; do
+ cp aai_edgerules_${f}.plantuml aai_edgerules_${f}.plantuml.bak1
+ echo "@startuml" > aai_edgerules_${f}.plantuml
+ echo "title ${f} Active and Available Inventory EdgeRule Relationships" >> aai_edgerules_${f}.plantuml
+ awk -F \" '/"from"/ { from = $4 } /"to"/ { to = $4 } /"label"/ { label = $4 ; print "\"" from "\" -- \"" to "\" : " label " >" }' aai_edgerules_${f}.plantuml.bak1 | sort -u >> aai_edgerules_${f}.plantuml
+ echo "@enduml" >> aai_edgerules_${f}.plantuml
+done
+
+sed -i.bak2 -s '/inventory.BelongsTo/d' aai_edgerules_*.plantuml
+sed -i.bak3 -s 's/: \(.*\.\)/: /' aai_edgerules_*.plantuml
+
+# save backups and restore originals
+cd ${STARTDIR}
+mv ${STARTDIR}/plantuml/*.bak* ${STARTDIR}/plantuml/backups
+ls -alR ${STARTDIR}/plantuml
+git status
+
+if [ -f ${STARTDIR}/aai-schema-gen/src/main/resources/swagger.html.ftl -a -f ${STARTDIR}/aai-schema-gen/src/main/resources/swagger.plantuml.ftl ] ; then
+ git checkout ${STARTDIR}/aai-schema-gen/src/main/resources/swagger.plantuml.ftl ${STARTDIR}/aai-schema-gen/src/main/resources/swagger.html.ftl
+ # mvn --offline -DskipTests process-classes
+ git status
+fi
+
+ls -al ${STARTDIR}/plantuml
+