[website]Support multi version for swagger (apache#5032)

* Support multi version for admin rest api

* Support multi for functions, source and sinks rest api

* Default version is master

* generate swagger file for multi version

* Generate swagger json for multi api

* Add comment for copy file

* Generate swagger file only to master

site2/website/pages/en/admin-rest-api.js

@@ -6,13 +6,12 @@ const siteConfig = require(`${process.cwd()}/siteConfig.js`);
 
 class AdminRestApi extends React.Component {
   render() {
-    const swaggerUrl = `${siteConfig.baseUrl}swagger/swagger.json`
 
+    const swaggerUrl = `${siteConfig.baseUrl}swagger/swagger.json`
     return (
       <div className="pageContainer">
         <Container className="mainContainer documentContainer postContainer" >
-          <redoc spec-url={`${swaggerUrl}`} lazy-rendering="true"></redoc>
-          <script src="https://rebilly.github.io/ReDoc/releases/latest/redoc.min.js"></script>
+          <script base-url={`${swaggerUrl}`} src="js/getSwaggerByVersion.js"></script>
         </Container>
       </div>
     );

site2/website/pages/en/functions-rest-api.js

@@ -11,8 +11,7 @@ class FunctionsRestApi extends React.Component {
     return (
       <div className="pageContainer">
         <Container className="mainContainer documentContainer postContainer" >
-          <redoc spec-url={`${swaggerUrl}`} lazy-rendering="true"></redoc>
-          <script src="https://rebilly.github.io/ReDoc/releases/latest/redoc.min.js"></script>
+          <script base-url={`${swaggerUrl}`} src="js/getSwaggerByVersion.js"></script>
         </Container>
       </div>
     );

site2/website/pages/en/sink-rest-api.js

@@ -11,8 +11,7 @@ class SinkRestApi extends React.Component {
     return (
       <div className="pageContainer">
         <Container className="mainContainer documentContainer postContainer" >
-          <redoc spec-url={`${swaggerUrl}`} lazy-rendering="true"></redoc>
-          <script src="https://rebilly.github.io/ReDoc/releases/latest/redoc.min.js"></script>
+          <script base-url={`${swaggerUrl}`} src="js/getSwaggerByVersion.js"></script>
         </Container>
       </div>
     );

site2/website/pages/en/source-rest-api.js

@@ -11,8 +11,7 @@ class SourceRestApi extends React.Component {
     return (
       <div className="pageContainer">
         <Container className="mainContainer documentContainer postContainer" >
-          <redoc spec-url={`${swaggerUrl}`} lazy-rendering="true"></redoc>
-          <script src="https://rebilly.github.io/ReDoc/releases/latest/redoc.min.js"></script>
+          <script base-url={`${swaggerUrl}`} src="js/getSwaggerByVersion.js"></script>
         </Container>
       </div>
     );

site2/website/static/js/custom.js

@@ -64,17 +64,24 @@ window.addEventListener('load', function() {
     }
   });
 
+  const href = document.querySelector('a[href="/en/versions"]');
+  let version = href.textContent;
+
+  if (version === 'next') {
+    version = 'master'
+  }
+
   // setup rest api menu items in nav bar
   const restapis = document.querySelector("a[href='#restapis']").parentNode;
   const restapisMenu =
     '<li>' +
     '<a id="restapis-menu" href="#">REST APIs <span style="font-size: 0.75em">&nbsp;▼</span></a>' +
     '<div id="restapis-dropdown" class="hide">' +
       '<ul id="restapis-dropdown-items">' +
-        '<li><a href="/admin-rest-api">Admin REST API </a></li>' +
-        '<li><a href="/functions-rest-api">Functions </a></li>' +
-        '<li><a href="/source-rest-api">Sources </a></li>' +
-        '<li><a href="/sink-rest-api">Sinks </a></li>' +
+        '<li><a href="/admin-rest-api?version=' + version + '">Admin REST API </a></li>' +
+        '<li><a href="/functions-rest-api?version=' + version + '">Functions </a></li>' +
+        '<li><a href="/source-rest-api?version=' + version + '">Sources </a></li>' +
+        '<li><a href="/sink-rest-api?version=' + version + '">Sinks </a></li>' +
       '</ul>' +
     '</div>' +
     '</li>';

site2/website/static/js/getSwaggerByVersion.js

@@ -0,0 +1,24 @@
+function getSwaggerByVersion(){
+    var params = window.location.search
+    params = params.replace('?', '')
+    const paramsList = params.split('&')
+    var version = 'master'
+    for (var i in paramsList) {
+        var param = paramsList[i].split('=')
+        if (param[0] === 'version') {
+            version = param[1]
+        }
+    }
+    const wrapper = document.querySelector('.pageContainer .wrapper')
+    const redoc = document.createElement('redoc');
+    redoc.setAttribute('spec-url', '/swagger/' + version + '/swagger.json')
+    redoc.setAttribute('lazy-rendering', 'true')
+    const redocLink = document.createElement('script');
+    redocLink.setAttribute('src', 'https://rebilly.github.io/ReDoc/releases/latest/redoc.min.js')
+    const script = document.querySelector('.pageContainer .wrapper script')
+
+    wrapper.insertBefore(redoc, script)
+    wrapper.insertBefore(redocLink, script)
+
+}
+window.onload=getSwaggerByVersion

src/gen-swagger.sh

@@ -22,10 +22,11 @@ PULSAR_PATH=$(git rev-parse --show-toplevel)
 
 cd $PULSAR_PATH
 
-echo "Generating swagger json file ..."
+git checkout master
+echo "Generating swagger json file for master ..."
 mvn -am -pl pulsar-broker install -DskipTests -Pswagger
-echo "Swagger json file is generated."
+echo "Swagger json file is generated for master."
 
-cp pulsar-broker/target/docs/swagger*.json site2/website/static/swagger/
-echo "Copied swagger json file."
+cp pulsar-broker/target/docs/swagger*.json site2/website/static/swagger/master/
+echo "Copied swagger json file for master."