You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

372 lines
44 KiB

  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta http-equiv="X-UA-Compatible" content="IE=edge">
  6. <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=no">
  7. <meta name="apple-mobile-web-app-capable" content="yes">
  8. <meta name="apple-mobile-web-app-status-bar-style" content="black">
  9. <meta name="mobile-web-app-capable" content="yes">
  10. <title>
  11. Week 3 - Message Brokers - HackMD
  12. </title>
  13. <link rel="icon" type="image/png" href="https://hackmd.io/favicon.png">
  14. <link rel="apple-touch-icon" href="https://hackmd.io/apple-touch-icon.png">
  15. <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha256-916EbMg70RQy9LHiGkXzG8hSg9EdNy97GazNG/aiY1w=" crossorigin="anonymous" />
  16. <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" integrity="sha256-eZrrJcwDc/3uDhsdt61sL2oOBY362qM3lon1gyExkL0=" crossorigin="anonymous" />
  17. <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/ionicons/2.0.1/css/ionicons.min.css" integrity="sha256-3iu9jgsy9TpTwXKb7bNQzqWekRX7pPK+2OLj3R922fo=" crossorigin="anonymous" />
  18. <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/octicons/3.5.0/octicons.min.css" integrity="sha256-QiWfLIsCT02Sdwkogf6YMiQlj4NE84MKkzEMkZnMGdg=" crossorigin="anonymous" />
  19. <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.5.1/themes/prism.min.css" integrity="sha256-vtR0hSWRc3Tb26iuN2oZHt3KRUomwTufNIf5/4oeCyg=" crossorigin="anonymous" />
  20. <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@hackmd/emojify.js@2.1.0/dist/css/basic/emojify.min.css" integrity="sha256-UOrvMOsSDSrW6szVLe8ZDZezBxh5IoIfgTwdNDgTjiU=" crossorigin="anonymous" />
  21. <style>
  22. @import url(https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,500,500i|Source+Code+Pro:300,400,500|Source+Sans+Pro:300,300i,400,400i,600,600i|Source+Serif+Pro&subset=latin-ext);.hljs{background:#fff;color:#333;display:block;overflow-x:auto;padding:.5em}.hljs-comment,.hljs-meta{color:#969896}.hljs-emphasis,.hljs-quote,.hljs-string,.hljs-strong,.hljs-template-variable,.hljs-variable{color:#df5000}.hljs-keyword,.hljs-selector-tag,.hljs-type{color:#a71d5d}.hljs-attribute,.hljs-bullet,.hljs-literal,.hljs-number,.hljs-symbol{color:#0086b3}.hljs-built_in,.hljs-builtin-name{color:#005cc5}.hljs-name,.hljs-section{color:#63a35c}.hljs-tag{color:#333}.hljs-attr,.hljs-selector-attr,.hljs-selector-class,.hljs-selector-id,.hljs-selector-pseudo,.hljs-title{color:#795da3}.hljs-addition{background-color:#eaffea;color:#55a532}.hljs-deletion{background-color:#ffecec;color:#bd2c00}.hljs-link{text-decoration:underline}.markdown-body{word-wrap:break-word;font-size:16px;line-height:1.5}.markdown-body:after,.markdown-body:before{content:"";display:table}.markdown-body:after{clear:both}.markdown-body>:first-child{margin-top:0!important}.markdown-body>:last-child{margin-bottom:0!important}.markdown-body a:not([href]){color:inherit;text-decoration:none}.markdown-body .absent{color:#c00}.markdown-body .anchor{float:left;line-height:1;margin-left:-20px;padding-right:4px}.markdown-body .anchor:focus{outline:none}.markdown-body blockquote,.markdown-body dl,.markdown-body ol,.markdown-body p,.markdown-body pre,.markdown-body table,.markdown-body ul{margin-bottom:16px;margin-top:0}.markdown-body hr{background-color:#e7e7e7;border:0;height:.25em;margin:24px 0;padding:0}.markdown-body blockquote{border-left:.25em solid #ddd;color:#777;font-size:16px;padding:0 1em}.markdown-body blockquote>:first-child{margin-top:0}.markdown-body blockquote>:last-child{margin-bottom:0}.markdown-body kbd,.popover kbd{background-color:#fcfcfc;border:1px solid;border-color:#ccc #ccc #bbb;border-radius:3px;box-shadow:inset 0 -1px 0 #bbb;color:#555;display:inline-block;font-size:11px;line-height:10px;padding:3px 5px;vertical-align:middle}.markdown-body .loweralpha{list-style-type:lower-alpha}.markdown-body h1,.markdown-body h2,.markdown-body h3,.markdown-body h4,.markdown-body h5,.markdown-body h6{font-weight:600;line-height:1.25;margin-bottom:16px;margin-top:24px}.markdown-body h1 .octicon-link,.markdown-body h2 .octicon-link,.markdown-body h3 .octicon-link,.markdown-body h4 .octicon-link,.markdown-body h5 .octicon-link,.markdown-body h6 .octicon-link{color:#000;vertical-align:middle;visibility:hidden}.markdown-body h1:hover .anchor,.markdown-body h2:hover .anchor,.markdown-body h3:hover .anchor,.markdown-body h4:hover .anchor,.markdown-body h5:hover .anchor,.markdown-body h6:hover .anchor{text-decoration:none}.markdown-body h1:hover .anchor .octicon-link,.markdown-body h2:hover .anchor .octicon-link,.markdown-body h3:hover .anchor .octicon-link,.markdown-body h4:hover .anchor .octicon-link,.markdown-body h5:hover .anchor .octicon-link,.markdown-body h6:hover .anchor .octicon-link{visibility:visible}.markdown-body h1 code,.markdown-body h1 tt,.markdown-body h2 code,.markdown-body h2 tt,.markdown-body h3 code,.markdown-body h3 tt,.markdown-body h4 code,.markdown-body h4 tt,.markdown-body h5 code,.markdown-body h5 tt,.markdown-body h6 code,.markdown-body h6 tt{font-size:inherit}.markdown-body h1{font-size:2em}.markdown-body h1,.markdown-body h2{border-bottom:1px solid #eee;padding-bottom:.3em}.markdown-body h2{font-size:1.5em}.markdown-body h3{font-size:1.25em}.markdown-body h4{font-size:1em}.markdown-body h5{font-size:.875em}.markdown-body h6{color:#777;font-size:.85em}.markdown-body ol,.markdown-body ul{padding-left:2em}.markdown-body ol.no-list,.markdown-body ul.no-list{list-style-type:none;padding:0}.markdown-body ol ol,.markdown-body ol ul,.markdown-body ul ol,.markdown-body ul ul{margin-bottom:0;margin-top:0}.markdown-body li>p{margin-top:16px}.markdown-body li+li{padding-top:.25em}.markdown-body dl{padding:0}.markdown-body dl dt{font-size:1em;font-style:italic;font-weight:700;margin-top:16px;padding:0}.markdown-body dl dd{margin-bottom:16px;padding:0 16px}.markdown-body table{display:block;overflow:auto;width:100%;word-break:normal;word-break:keep-all}.markdown-body table th{font-weight:700}.markdown-body table td,.markdown-body table th{border:1px solid #ddd;padding:6px 13px}.markdown-body table tr{background-color:#fff;border-top:1px solid #ccc}.markdown-body table tr:nth-child(2n){background-color:#f8f8f8}.markdown-body img{background-color:#fff;box-sizing:initial;max-width:100%}.markdown-body img[align=right]{padding-left:20px}.markdown-body img[align=left]{padding-right:20px}.markdown-body .emoji{background-color:initial;max-width:none;vertical-align:text-top}.markdown-body span.frame{display:block;overflow:hidden}.markdown-body span.frame>span{border:1px solid #ddd;display:block;float:left;margin:13px 0 0;overflow:hidden;padding:7px;width:auto}.markdown-body span.frame span img{display:block;float:left}.markdown-body span.frame span span{clear:both;color:#333;display:block;padding:5px 0 0}.markdown-body span.align-center{clear:both;display:block;overflow:hidden}.markdown-body span.align-center>span{display:block;margin:13px auto 0;overflow:hidden;text-align:center}.markdown-body span.align-center span img{margin:0 auto;text-align:center}.markdown-body span.align-right{clear:both;display:block;overflow:hidden}.markdown-body span.align-right>span{display:block;margin:13px 0 0;overflow:hidden;text-align:right}.markdown-body span.align-right span img{margin:0;text-align:right}.markdown-body span.float-left{display:block;float:left;margin-right:13px;overflow:hidden}.markdown-body span.float-left span{margin:13px 0 0}.markdown-body span.float-right{display:block;float:right;margin-left:13px;overflow:hidden}.markdown-body span.float-right>span{display:block;margin:13px auto 0;overflow:hidden;text-align:right}.markdown-body code,.markdown-body tt{background-color:#0000000a;border-radius:3px;font-size:85%;margin:0;padding:.2em 0}.markdown-body code:after,.markdown-body code:before,.markdown-body tt:after,.markdown-body tt:before{content:"\00a0";letter-spacing:-.2em}.markdown-body code br,.markdown-body tt br{display:none}.markdown-body del code{text-decoration:inherit}.markdown-body pre{word-wrap:normal}.markdown-body pre>code{background:#0000;border:0;font-size:100%;margin:0;padding:0;white-space:pre;word-break:normal}.markdown-body .highlight{margin-bottom:16px}.markdown-body .highlight pre{margin-bottom:0;word-break:normal}.markdown-body .highlight pre,.markdown-body pre{background-color:#f7f7f7;border-radius:3px;font-size:85%;line-height:1.45;overflow:auto;padding:16px}.markdown-body pre code,.markdown-body pre tt{word-wrap:normal;background-color:initial;border:0;display:inline;line-height:inherit;margin:0;max-width:auto;overflow:visible;padding:0}.markdown-body pre code:after,.markdown-body pre code:before,.markdown-body pre tt:after,.markdown-body pre tt:before{content:normal}.markdown-body .csv-data td,.markdown-body .csv-data th{font-size:12px;line-height:1;overflow:hidden;padding:5px;text-align:left;white-space:nowrap}.markdown-body .csv-data .blob-line-num{background:#fff;border:0;padding:10px 8px 9px;text-align:right}.markdown-body .csv-data tr{border-top:0}.markdown-body .csv-data th{background:#f8f8f8;border-top:0;font-weight:700}.news .alert .markdown-body blockquote{border:0;padding:0 0 0 40px}.activity-tab .news .alert .commits,.activity-tab .news .markdown-body blockquote{padding-left:0}.task-list-item{list-style-type:none}.task-list-item label{font-weight:400}.task-list-item.enabled label{cursor:pointer}.task-list-item+.task-list-item{margin-top:3px}.task-list-item-checkbox{cursor:default!important;float:left;margin:.31em 0 .2em -1.3em!important;vertical-align:middle}.markdown-body{max-width:758px;overflow:visible!important;padding-bottom:40px;padding-top:40px;position:relative}.markdown-body .emoji{vertical-align:top}.markdown-body pre{border:inherit!important}.markdown-body code{color:inherit!important}.markdown-body pre code .wrapper{display:-moz-inline-flex;display:-ms-inline-flex;display:-o-inline-flex;display:inline-flex}.markdown-body pre code .gutter{float:left;overflow:hidden;-webkit-user-select:none;user-select:none}.markdown-body pre code .gutter.linenumber{border-right:3px solid #6ce26c!important;box-sizing:initial;color:#afafaf!important;cursor:default;display:inline-block;min-width:20px;padding:0 8px 0 0;position:relative;text-align:right;z-index:4}.markdown-body pre code .gutter.linenumber>span:before{content:attr(data-linenumber)}.markdown-body pre code .code{float:left;margin:0 0 0 16px}.markdown-body .gist .line-numbers{border-bottom:none;border-left:none;border-top:none}.markdown-body .gist .line-data{border:none}.markdown-body .gist table{border-collapse:inherit!important;border-spacing:0}.markdown-body code[data-gist-id]{background:none;padding:0}.markdown-body code[data-gist-id]:after,.markdown-body code[data-gist-id]:before{content:""}.markdown-body code[data-gist-id] .blob-num{border:unset}.markdown-body code[data-gist-id] table{margin-bottom:unset;overflow:unset}.markdown-body code[data-gist-id] table tr{background:unset}.markdown-body[dir=rtl] pre{direction:ltr}.markdown-body[dir=rtl] code{direction:ltr;unicode-bidi:embed}.markdown-body .alert>p:last-child{margin-bottom:0}.markdown-body pre.abc,.markdown-body pre.flow-chart,.markdown-body pre.graphviz,.markdown-body pre.mermaid,.markdown-body pre.sequence-diagram,.markdown-body pre.vega{background-color:inherit;border-radius:0;overflow:visible;text-align:center;white-space:inherit}.markdown-body pre.abc>code,.markdown-body pre.flow-chart>code,.markdown-body pre.graphviz>code,.markdown-body pre.mermaid>code,.markdown-body pre.sequence-diagram>code,.markdown-body pre.vega>code{text-align:left}.markdown-body pre.abc>svg,.markdown-body pre.flow-chart>svg,.markdown-body pre.graphviz>svg,.markdown-body pre.mermaid>svg,.markdown-body pre.sequence-diagram>svg,.markdown-body pre.vega>svg{height:100%;max-width:100%}.markdown-body pre>code.wrap{word-wrap:break-word;white-space:pre-wrap;white-space:-moz-pre-wrap;white-space:-pre-wrap;white-space:-o-pre-wrap}.markdown-body .alert>p:last-child,.markdown-body .alert>ul:last-child{margin-bottom:0}.markdown-body summary{display:list-item}.markdown-body summary:focus{outline:none}.markdown-body details summary{cursor:pointer}.markdown-body details:not([open])>:not(summary){display:none}.markdown-body figure{margin:1em 40px}.markdown-body .mark,.markdown-body mark{background-color:#fff1a7}.vimeo,.youtube{background-color:#000;background-position:50%;background-repeat:no-repeat;background-size:contain;cursor:pointer;display:table;overflow:hidden;text-align:center}.vimeo,.youtube{position:relative;width:100%}.youtube{padding-bottom:56.25%}.vimeo img{object-fit:contain;width:100%;z-index:0}.youtube img{object-fit:cover;z-index:0}.vimeo iframe,.youtube iframe,.youtube img{height:100%;left:0;position:absolute;top:0;width:100%}.vimeo iframe,.youtube iframe{vertical-align:middle;z-index:1}.vimeo .icon,.youtube .icon{color:#fff;height:auto;left:50%;opacity:.3;position:absolute;top:50%;transform:translate(-50%,-50%);transition:opacity .2s;width:auto;z-index:0}.vimeo:hover .icon,.youtube:hover .icon{opacity:.6;transition:opacity .2s}.slideshare .inner,.speakerdeck .inner{position:relative;width:100%}.slideshare .inner iframe,.speakerdeck .inner iframe{bottom:0;height:100%;left:0;position:absolute;right:0;top:0;width:100%}.figma{display:table;padding-bottom:56.25%;position:relative;width:100%}.figma iframe{border:1px solid #eee;bottom:0;height:100%;left:0;position:absolute;right:0;top:0;width:100%}.markmap-container{height:300px}.markmap-container>svg{height:100%;width:100%}.MJX_Assistive_MathML{display:none}#MathJax_Message{z-index:1000!important}.ui-infobar{color:#777;margin:25px auto -25px;max-width:760px;position:relative;z-index:2}.toc .invisable-node{list-style-type:none}.ui-toc{bottom:20px;position:fixed;z-index:998}.ui-toc.both-mode{margin-left:8px}.ui-toc.both-mode .ui-toc-label{border-bottom-left-radius:0;border-top-left-radius:0;height:40px;padding:10px 4px}.ui-toc-label{background-color:#e6e6e6;border:none;color:#868686;transition:opacity .2s}.ui-toc .open .ui-toc-label{color:#fff;opacity:1;transition:opacity .2s}.ui-toc-label:focus{background-color:#ccc;color:#000;opacity:.3}.ui-toc-label:hover{background-color:#ccc;opacity:1;transition:opacity .2s}.ui-toc-dropdown{margin-bottom:20px;margin-top:20px;max-height:70vh;max-width:45vw;overflow:auto;padding-left:10px;padding-right:10px;text-align:inherit;width:25vw}.ui-toc-dropdown>.toc{max-height:calc(70vh - 100px);overflow:auto}.ui-toc-dropdown[dir=rtl] .nav{letter-spacing:.0029em;padding-right:0}.ui-toc-dropdown a{overflow:hidden;text-overflow:ellipsis;white-space:pre}.ui-toc-dropdown .nav>li>a{color:#767676;display:block;font-size:13px;font-weight:500;padding:4px 20px}.ui-toc-dropdown .nav>li:first-child:last-child>ul,.ui-toc-dropdown .toc.expand ul{display:block}.ui-toc-dropdown .nav>li>a:focus,.ui-toc-dropdown .nav>li>a:hover{background-color:initial;border-left:1px solid #000;color:#000;padding-left:19px;text-decoration:none}.ui-toc-dropdown[dir=rtl] .nav>li>a:focus,.ui-toc-dropdown[dir=rtl] .nav>li>a:hover{border-left:none;border-right:1px solid #000;padding-right:19px}.ui-toc-dropdown .nav>.active:focus>a,.ui-toc-dropdown .nav>.active:hover>a,.ui-toc-dropdown .nav>.active>a{background-color:initial;border-left:2px solid #000;color:#000;font-weight:700;padding-left:18px}.ui-toc-dropdown[dir=rtl] .nav>.active:focus>a,.ui-toc-dropdown[dir=rtl] .nav>.active:hover>a,.ui-toc-dropdown[dir=rtl] .nav>.active>a{border-left:none;border-right:2px solid #000;padding-right:18px}.ui-toc-dropdown .nav .nav{display:none;padding-bottom:10px}.ui-toc-dropdown .nav>.active>ul{display:block}.ui-toc-dropdown .nav .nav>li>a{font-size:12px;font-weight:400;padding-bottom:1px;padding-left:30px;padding-top:1px}.ui-toc-dropdown[dir=rtl] .nav .nav>li>a{padding-right:30px}.ui-toc-dropdown .nav .nav>li>ul>li>a{font-size:12px;font-weight:400;padding-bottom:1px;padding-left:40px;padding-top:1px}.ui-toc-dropdown[dir=rtl] .nav .nav>li>ul>li>a{padding-right:40px}.ui-toc-dropdown .nav .nav>li>a:focus,.ui-toc-dropdown .nav .nav>li>a:hover{padding-left:29px}.ui-toc-dropdown[dir=rtl] .nav .nav>li>a:focus,.ui-toc-dropdown[dir=rtl] .nav .nav>li>a:hover{padding-right:29px}.ui-toc-dropdown .nav .nav>li>ul>li>a:focus,.ui-toc-dropdown .nav .nav>li>ul>li>a:hover{padding-left:39px}.ui-toc-dropdown[dir=rtl] .nav .nav>li>ul>li>a:focus,.ui-toc-dropdown[dir=rtl] .nav .nav>li>ul>li>a:hover{padding-right:39px}.ui-toc-dropdown .nav .nav>.active:focus>a,.ui-toc-dropdown .nav .nav>.active:hover>a,.ui-toc-dropdown .nav .nav>.active>a{font-weight:500;padding-left:28px}.ui-toc-dropdown[dir=rtl] .nav .nav>.active:focus>a,.ui-toc-dropdown[dir=rtl] .nav .nav>.active:hover>a,.ui-toc-dropdown[dir=rtl] .nav .nav>.active>a{padding-right:28px}.ui-toc-dropdown .nav .nav>.active>.nav>.active:focus>a,.ui-toc-dropdown .nav .nav>.active>.nav>.active:hover>a,.ui-toc-dropdown .nav .nav>.active>.nav>.active>a{font-weight:500;padding-left:38px}.ui-toc-dropdown[dir=rtl] .nav .nav>.active>.nav>.active:focus>a,.ui-toc-dropdown[dir=rtl] .nav .nav>.active>.nav>.active:hover>a,.ui-toc-dropdown[dir=rtl] .nav .nav>.active>.nav>.active>a{padding-right:38px}.markdown-body{font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Helvetica Neue,Helvetica,Roboto,Arial,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol}html[lang^=ja] .markdown-body{font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Helvetica Neue,Helvetica,Roboto,Arial,Hiragino Kaku Gothic Pro,ヒラギノ角ゴ Pro W3,Osaka,Meiryo,メイリオ,MS Gothic,MS ゴシック,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol}html[lang=zh-tw] .markdown-body{font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Helvetica Neue,Helvetica,Roboto,Arial,PingFang TC,Microsoft JhengHei,微軟正黑,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol}html[lang=zh-cn] .markdown-body{font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Helvetica Neue,Helvetica,Roboto,Arial,PingFang SC,Microsoft YaHei,微软雅黑,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol}html .markdown-body[lang^=ja]{font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Helvetica Neue,Helvetica,Roboto,Arial,Hiragino Kaku Gothic Pro,ヒラギノ角ゴ Pro W3,Osaka,Meiryo,メイリオ,MS Gothic,MS ゴシック,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol}html .markdown-body[lang=zh-tw]{font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Helvetica Neue,Helvetica,Roboto,Arial,PingFang TC,Microsoft JhengHei,微軟正黑,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol}html .markdown-body[lang=zh-cn]{font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Helvetica Neue,Helvetica,Roboto,Arial,PingFang SC,Microsoft YaHei,微软雅黑,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol}html[lang^=ja] .ui-toc-dropdown{font-family:Source Sans Pro,Helvetica,Arial,Meiryo UI,MS PGothic,MS Pゴシック,sans-serif}html[lang=zh-tw] .ui-toc-dropdown{font-family:Source Sans Pro,Helvetica,Arial,Microsoft JhengHei UI,微軟正黑UI,sans-serif}html[lang=zh-cn] .ui-toc-dropdown{font-family:Source Sans Pro,Helvetica,Arial,Microsoft YaHei UI,微软雅黑UI,sans-serif}html .ui-toc-dropdown[lang^=ja]{font-family:Source Sans Pro,Helvetica,Arial,Meiryo UI,MS PGothic,MS Pゴシック,sans-serif}html .ui-toc-dropdown[lang=zh-tw]{font-family:Source Sans Pro,Helvetica,Arial,Microsoft JhengHei UI,微軟正黑UI,sans-serif}html .ui-toc-dropdown[lang=zh-cn]{font-family:Source Sans Pro,Helvetica,Arial,Microsoft YaHei UI,微软雅黑UI,sans-serif}.ui-affix-toc{max-height:70vh;max-width:15vw;overflow:auto;position:fixed;top:0}.back-to-top,.expand-toggle,.go-to-bottom{color:#999;display:block;font-size:12px;font-weight:500;margin-left:10px;margin-top:10px;padding:4px 10px}.back-to-top:focus,.back-to-top:hover,.expand-toggle:focus,.expand-toggle:hover,.go-to-bottom:focus,.go-to-bottom:hover{color:#563d7c;text-decoration:none}.back-to-top,.go-to-bottom{margin-top:0}.ui-user-icon{background-position:50%;background-repeat:no-repeat;background-size:cover;border-radius:50%;display:block;height:20px;margin-bottom:2px;margin-right:5px;margin-top:2px;width:20px}.ui-user-icon.small{display:inline-block;height:18px;margin:0 0 .2em;vertical-align:middle;width:18px}.ui-infobar>small>span{line-height:22px}.ui-infobar>small .dropdown{display:inline-block}.ui-infobar>small .dropdown a:focus,.ui-infobar>small .dropdown a:hover{text-decoration:none}.ui-more-info{color:#888;cursor:pointer;vertical-align:middle}.ui-more-info .fa{font-size:16px}.ui-connectedGithub,.ui-published-note{color:#888}.ui-connectedGithub{line-height:23px;white-space:nowrap}.ui-connectedGithub a.file-path{color:#888;padding-left:22px;text-decoration:none}.ui-connectedGithub a.file-path:active,.ui-connectedGithub a.file-path:hover{color:#888;text-decoration:underline}.ui-connectedGithub .fa{font-size:20px}.ui-published-note .fa{font-size:20px;vertical-align:top}.unselectable{-webkit-user-select:none;-o-user-select:none;user-select:none}.selectable{-webkit-user-select:text;-o-user-select:text;user-select:text}.inline-spoiler-section{cursor:pointer}.inline-spoiler-section .spoiler-text{background-color:#333;border-radius:2px}.inline-spoiler-section .spoiler-text>*{opacity:0}.inline-spoiler-section .spoiler-img{filter:blur(10px)}.inline-spoiler-section.raw{background-color:#333;border-radius:2px}.inline-spoiler-section.raw>*{opacity:0}.inline-spoiler-section.unveil{cursor:auto}.inline-spoiler-section.unveil .spoiler-text{background-color:#3333331a}.inline-spoiler-section.unveil .spoiler-text>*{opacity:1}.inline-spoiler-section.unveil .spoiler-img{filter:none}@media print{blockquote,div,img,pre,table{page-break-inside:avoid!important}a[href]:after{font-size:12px!important}}.markdown-body.slides{color:#222;position:relative;z-index:1}.markdown-body.slides:before{background-color:currentColor;bottom:0;box-shadow:0 0 0 50vw;content:"";display:block;left:0;position:absolute;right:0;top:0;z-index:-1}.markdown-body.slides section[data-markdown]{background-color:#fff;margin-bottom:1.5em;position:relative;text-align:center}.markdown-body.slides section[data-markdown] code{text-align:left}.markdown-body.slides section[data-markdown]:before{content:"";display:block;padding-bottom:56.23%}.markdown-body.slides section[data-markdown]>div:first-child{left:1em;max-height:100%;overflow:hidden;position:absolute;right:1em;top:50%;transform:translateY(-50%)}.markdown-body.slides section[data-markdown]>ul{display:inline-block}.markdown-body.slides>section>section+section:after{border:3px solid #777;content:"";height:1.5em;position:absolute;right:1em;top:-1.5em}.site-ui-font{font-family:Source Sans Pro,Helvetica,Arial,sans-serif}html[lang^=ja] .site-ui-font{font-family:Source Sans Pro,Helvetica,Arial,Hiragino Kaku Gothic Pro,ヒラギノ角ゴ Pro W3,Osaka,Meiryo,メイリオ,MS Gothic,MS ゴシック,sans-serif}html[lang=zh-tw] .site-ui-font{font-family:Source Sans Pro,Helvetica,Arial,PingFang TC,Microsoft JhengHei,微軟正黑,sans-serif}html[lang=zh-cn] .site-ui-font{font-family:Source Sans Pro,Helvetica,Arial,PingFang SC,Microsoft YaHei,微软雅黑,sans-serif}body{font-smoothing:subpixel-antialiased!important;-webkit-font-smoothing:subpixel-antialiased!important;-moz-osx-font-smoothing:auto!important;-webkit-overflow-scrolling:touch;font-family:Source Sans Pro,Helvetica,Arial,sans-serif;letter-spacing:.025em}html[lang^=ja] body{font-family:Source Sans Pro,Helvetica,Arial,Hiragino Kaku Gothic Pro,ヒラギノ角ゴ Pro W3,Osaka,Meiryo,メイリオ,MS Gothic,MS ゴシック,sans-serif}html[lang=zh-tw] body{font-family:Source Sans Pro,Helvetica,Arial,PingFang TC,Microsoft JhengHei,微軟正黑,sans-serif}html[lang=zh-cn] body{font-family:Source Sans Pro,Helvetica,Arial,PingFang SC,Microsoft YaHei,微软雅黑,sans-serif}abbr[title]{border-bottom:none;text-decoration:underline;-webkit-text-decoration:underline dotted;text-decoration:underline dotted}abbr[data-original-title],abbr[title]{cursor:help}body.modal-open{overflow-y:auto;padding-right:0!important}svg{text-shadow:none}
  23. </style>
  24. <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
  25. <!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
  26. <!--[if lt IE 9]>
  27. <script src="https://cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv.min.js" integrity="sha256-3Jy/GbSLrg0o9y5Z5n1uw0qxZECH7C6OQpVBgNFYa0g=" crossorigin="anonymous"></script>
  28. <script src="https://cdnjs.cloudflare.com/ajax/libs/respond.js/1.4.2/respond.min.js" integrity="sha256-g6iAfvZp+nDQ2TdTR/VVKJf3bGro4ub5fvWSWVRi2NE=" crossorigin="anonymous"></script>
  29. <script src="https://cdnjs.cloudflare.com/ajax/libs/es5-shim/4.5.9/es5-shim.min.js" integrity="sha256-8E4Is26QH0bD52WoQpcB+R/tcWQtpzlCojrybUd7Mxo=" crossorigin="anonymous"></script>
  30. <![endif]-->
  31. </head>
  32. <body>
  33. <div id="doc" class="markdown-body container-fluid comment-inner comment-enabled" data-hard-breaks="true"><h1 id="Week-3---Message-Brokers" data-id="Week-3---Message-Brokers"><a class="anchor hidden-xs" href="#Week-3---Message-Brokers" title="Week-3---Message-Brokers"><span class="octicon octicon-link"></span></a><span>Week 3 - Message Brokers</span></h1><blockquote>
  34. <p><span>Distributed Systems and Network Programming - Spring 2023</span></p>
  35. </blockquote><h2 id="Overview" data-id="Overview"><a class="anchor hidden-xs" href="#Overview" title="Overview"><span class="octicon octicon-link"></span></a><span>Overview</span></h2><p><span>Your task for this lab is to use </span><a href="https://rabbitmq.com/" target="_blank" rel="noopener"><span>RabbitMQ</span></a><span> as a message broker for a pollution monitoring system.</span></p><ul>
  36. <li><span>A sensor </span><strong><span>(publisher)</span></strong><span> collects CO</span><sub><span>2</span></sub><span> levels in the environment and sends the obtained values to a server.</span></li>
  37. <li><span>The server </span><strong><span>(subscriber)</span></strong><span> processes these values and indicates if CO</span><sub><span>2</span></sub><span> levels are abnormal.</span></li>
  38. </ul><h2 id="System-Architecture" data-id="System-Architecture"><a class="anchor hidden-xs" href="#System-Architecture" title="System-Architecture"><span class="octicon octicon-link"></span></a><span>System Architecture</span></h2><h3 id="Architecture-diagram" data-id="Architecture-diagram"><a class="anchor hidden-xs" href="#Architecture-diagram" title="Architecture-diagram"><span class="octicon octicon-link"></span></a><strong><span>Architecture diagram</span></strong></h3><p><img src="https://user-images.githubusercontent.com/40727318/229937239-2c27b9f4-e484-4eb9-b174-768ed8102b75.svg" alt="diagram" loading="lazy"></p><h3 id="Directory-structure" data-id="Directory-structure"><a class="anchor hidden-xs" href="#Directory-structure" title="Directory-structure"><span class="octicon octicon-link"></span></a><strong><span>Directory structure</span></strong></h3><pre><code class="bash hljs">.
  39. ├── docker-compose.yml
  40. ├── publishers
  41. │ ├── sensor.py
  42. │ └── control-tower.py
  43. └── subscribers
  44. ├── receiver.py
  45. └── reporter.py
  46. </code></pre><h3 id="Publishers" data-id="Publishers"><a class="anchor hidden-xs" href="#Publishers" title="Publishers"><span class="octicon octicon-link"></span></a><strong><span>Publishers</span></strong></h3><ul>
  47. <li>
  48. <p><strong><span>Sensor (</span><code>sensor.py</code><span>)</span></strong></p>
  49. <ul>
  50. <li><span>Reads user input (an integer) representing the current level of CO</span><sub><span>2</span></sub><span>.</span></li>
  51. <li><span>Sends the value along with the current time to the server in JSON format.</span>
  52. <ul>
  53. <li><span>Values should be sent to the CO2 queue for processing only by the receiver</span></li>
  54. </ul>
  55. </li>
  56. <li><span>Example message: </span><code>{"time": "2023-04-03 17:19:29", "value": 500}</code></li>
  57. </ul>
  58. </li>
  59. <li>
  60. <p><strong><span>Control tower (</span><code>control-tower.py</code><span>)</span></strong></p>
  61. <ul>
  62. <li><span>Takes user input (a string) representing a query to the reporter.</span></li>
  63. <li><span>The query can either be </span><code>current</code><span> or </span><code>average</code>
  64. <ul>
  65. <li><code>current</code><span>: asks for the current CO</span><sub><span>2</span></sub><span> level.</span></li>
  66. <li><code>average</code><span>: asks for the average of all collected values since the system started.</span></li>
  67. </ul>
  68. </li>
  69. </ul>
  70. </li>
  71. </ul><h3 id="Subscribers" data-id="Subscribers"><a class="anchor hidden-xs" href="#Subscribers" title="Subscribers"><span class="octicon octicon-link"></span></a><strong><span>Subscribers</span></strong></h3><ul>
  72. <li><strong><span>Receiver (</span><code>receiver.py</code><span>)</span></strong>
  73. <ul>
  74. <li><span>Listens for messages from the sensor.</span></li>
  75. <li><span>Extracts the received JSON data and appends it to a file (e.g., </span><code>receiver.log</code><span>).</span></li>
  76. <li><span>Checks the received (latest) CO</span><sub><span>2</span></sub><span> value</span>
  77. <ul>
  78. <li><span>If the value is larger than </span><code>500</code><span>, the server prints a </span><code>WARNING</code><span> message.</span></li>
  79. <li><span>Otherwise, print </span><code>OK</code></li>
  80. </ul>
  81. </li>
  82. </ul>
  83. </li>
  84. <li><strong><span>Reporter (</span><code>reporter.py</code><span>)</span></strong>
  85. <ul>
  86. <li><span>Listens for messages (queries) from the control tower.</span></li>
  87. <li><span>Prints the answer upon receiving a query for </span><code>current</code><span> or </span><code>average</code><span>.</span></li>
  88. <li><span>The answer can be calculated based on the data from </span><code>receiver.log</code></li>
  89. </ul>
  90. </li>
  91. </ul><h3 id="Message-Broker-RabbitMQ-Server" data-id="Message-Broker-RabbitMQ-Server"><a class="anchor hidden-xs" href="#Message-Broker-RabbitMQ-Server" title="Message-Broker-RabbitMQ-Server"><span class="octicon octicon-link"></span></a><span>Message Broker (RabbitMQ Server)</span></h3><ul>
  92. <li><span>The broker is maintaining one or more message queues.</span></li>
  93. <li><span>Producers push messages to queues for consumers to receive.</span></li>
  94. <li><span>An exchange controls which messages should be routed to which queues and how it’s done.</span>
  95. <ul>
  96. <li><span>Multiple exchange types exist, use the </span><code>topic</code><span> exchange type which allows routing messages to different queues based on a wildcard (</span><code>*</code><span>) routing pattern.</span></li>
  97. </ul>
  98. </li>
  99. <li><span>A binding connects the exchange to a certain queue, the diagram above shows which queues should be bound to the exchange and the routing patterns to use.</span></li>
  100. </ul><h2 id="Task" data-id="Task"><a class="anchor hidden-xs" href="#Task" title="Task"><span class="octicon octicon-link"></span></a><span>Task</span></h2><ol>
  101. <li>
  102. <p><span>Run RabbitMQ in a docker container using </span><a href="https://docs.docker.com/compose/install/" target="_blank" rel="noopener"><span>docker-compose</span></a><span> by executing the following command in the same directory as </span><code>docker-compose.yml</code><span> file.</span></p>
  103. <pre><code class="bash hljs">docker-compose up
  104. </code></pre>
  105. </li>
  106. <li>
  107. <p><span>The Web UI should be available at </span><a href="http://localhost:15672/" target="_blank" rel="noopener"><span>http://localhost:15672/</span></a></p>
  108. <ul>
  109. <li><span>You can see default login credentials (</span><code>rabbit:1234</code><span>) in the compose file.</span></li>
  110. </ul>
  111. </li>
  112. <li>
  113. <p><span>Install </span><a href="https://pypi.org/project/pika/" target="_blank" rel="noopener"><code>pika</code></a><span>, the Python library for interacting with RabbitMQ.</span></p>
  114. <ul>
  115. <li><span>It’s recommended to create a virtual environment instead of installing </span><code>pika</code><span> globally.</span></li>
  116. <li><span>You can do so by running the following commands (you may need to install </span><code>python3-venv</code><span>)</span><pre><code class="bash hljs">python -m venv venv
  117. <span class="hljs-built_in">source</span> venv/bin/activate
  118. pip install pika
  119. </code></pre>
  120. </li>
  121. </ul>
  122. </li>
  123. <li>
  124. <p><span>Implement the system components as described above. Refer to </span><a href="https://www.rabbitmq.com/tutorials/tutorial-three-python.html" target="_blank" rel="noopener"><span>this tutorial</span></a><span> and </span><a href="https://pika.readthedocs.io/en/stable/index.html" target="_blank" rel="noopener"><span>pika documentation</span></a><span> for help.</span></p>
  125. <ul>
  126. <li><span>Connect to RabbitMQ server at </span><code>localhost</code><span> and create a channel.</span></li>
  127. <li><span>Use </span><code>amq.topic</code><span> exchange, or create your own exchange of type </span><code>topic</code></li>
  128. <li><span>Send sensor values with a routing key starting with </span><code>co2</code><span> (e.g., </span><code>co2.sensor</code><span>)</span></li>
  129. <li><span>Send control queries with a routing key starting with </span><code>rep</code><span> (e.g., </span><code>rep.current</code><span> and </span><code>rep.average</code><span>)</span></li>
  130. <li><span>Configure the receiver to listen for </span><code>co2.*</code><span> and the reporter to listen for </span><code>rep.*</code></li>
  131. <li><span>Don’t forget to </span><code>ack</code><span> the received messages so that they do not remain in the queue.</span></li>
  132. </ul>
  133. </li>
  134. <li>
  135. <p><span>Submit a single ZIP archive named </span><code>NameSurname.zip</code><span> with </span><code>publishers</code><span> and </span><code>subscribers</code><span> directories inside.</span></p>
  136. </li>
  137. </ol><h2 id="Example-Run" data-id="Example-Run"><a class="anchor hidden-xs" href="#Example-Run" title="Example-Run"><span class="octicon octicon-link"></span></a><span>Example Run</span></h2><pre><code class="bash hljs">$ python publishers/sensor.py
  138. Enter CO2 level: 499
  139. Enter CO2 level: 500
  140. Enter CO2 level: 501
  141. Enter CO2 level: 500
  142. </code></pre><pre><code class="bash hljs">$ python subscribers/receiver.py
  143. [*] Waiting <span class="hljs-keyword">for</span> CO2 data. Press CTRL+C to <span class="hljs-built_in">exit</span>
  144. 2023-04-03 17:19:29: OK
  145. 2023-04-03 17:20:02: OK
  146. 2023-04-03 17:21:05: WARNING
  147. 2023-04-03 17:22:08: OK
  148. </code></pre><hr><pre><code class="bash hljs">$ python publishers/control-tower.py
  149. Enter Query: current
  150. Enter Query: average
  151. </code></pre><pre><code class="bash hljs">$ python subscribers/reporter.py
  152. [*] Waiting <span class="hljs-keyword">for</span> queries from the control tower. Press CTRL+C to <span class="hljs-built_in">exit</span>
  153. 2023-04-03 17:19:30: Latest CO2 level is 499
  154. 2023-04-03 17:23:02: Average CO2 level is 500.0
  155. </code></pre><h2 id="Checklist" data-id="Checklist"><a class="anchor hidden-xs" href="#Checklist" title="Checklist"><span class="octicon octicon-link"></span></a><span>Checklist</span></h2><ul class="contains-task-list">
  156. <li class="task-list-item enabled"><input class="task-list-item-checkbox" type="checkbox" disabled="disabled"><span> A single submitted file </span><code>NameSurname.zip</code><span> with the following content inside:</span><pre><code class="bash hljs">.
  157. ├── publishers
  158. │ ├── sensor.py
  159. │ └── control-tower.py
  160. └── subscribers
  161. ├── receiver.py
  162. └── reporter.py
  163. </code></pre>
  164. </li>
  165. <li class="task-list-item enabled"><input class="task-list-item-checkbox" type="checkbox" disabled="disabled"><span> Publisher scripts correctly read and process user input.</span></li>
  166. <li class="task-list-item enabled"><input class="task-list-item-checkbox" type="checkbox" disabled="disabled"><span> Subscriber scripts only receive intended messages.</span></li>
  167. <li class="task-list-item enabled"><input class="task-list-item-checkbox" type="checkbox" disabled="disabled"><span> Receiver correctly processes sensor values and prints timestamped </span><code>WARNING</code><span> or </span><code>OK</code><span> messages accordingly.</span></li>
  168. <li class="task-list-item enabled"><input class="task-list-item-checkbox" type="checkbox" disabled="disabled"><span> Reporter correctly processes control tower queries and prints the required answers.</span></li>
  169. <li class="task-list-item enabled"><input class="task-list-item-checkbox" type="checkbox" disabled="disabled"><span> The code does not use any external dependencies (apart from </span><a href="https://pypi.org/project/pika/" target="_blank" rel="noopener"><code>pika</code></a><span>)</span></li>
  170. <li class="task-list-item enabled"><input class="task-list-item-checkbox" type="checkbox" disabled="disabled"><span> The source code is the author’s original work. Both parties will be penalized for detected plagiarism.</span></li>
  171. </ul></div>
  172. <div class="ui-toc dropup unselectable hidden-print" style="display:none;">
  173. <div class="pull-right dropdown">
  174. <a id="tocLabel" class="ui-toc-label btn btn-default" data-toggle="dropdown" href="#" role="button" aria-haspopup="true" aria-expanded="false" title="Table of content">
  175. <i class="fa fa-bars"></i>
  176. </a>
  177. <ul id="ui-toc" class="ui-toc-dropdown dropdown-menu" aria-labelledby="tocLabel">
  178. <div class="toc"><ul class="nav">
  179. <li><a href="#Week-3---Message-Brokers" title="Week 3 - Message Brokers">Week 3 - Message Brokers</a><ul class="nav">
  180. <li><a href="#Overview" title="Overview">Overview</a></li>
  181. <li><a href="#System-Architecture" title="System Architecture">System Architecture</a><ul class="nav">
  182. <li><a href="#Architecture-diagram" title="Architecture diagram">Architecture diagram</a></li>
  183. <li><a href="#Directory-structure" title="Directory structure">Directory structure</a></li>
  184. <li><a href="#Publishers" title="Publishers">Publishers</a></li>
  185. <li><a href="#Subscribers" title="Subscribers">Subscribers</a></li>
  186. <li><a href="#Message-Broker-RabbitMQ-Server" title="Message Broker (RabbitMQ Server)">Message Broker (RabbitMQ Server)</a></li>
  187. </ul>
  188. </li>
  189. <li><a href="#Task" title="Task">Task</a></li>
  190. <li><a href="#Example-Run" title="Example Run">Example Run</a></li>
  191. <li><a href="#Checklist" title="Checklist">Checklist</a></li>
  192. </ul>
  193. </li>
  194. </ul>
  195. </div><div class="toc-menu"><a class="expand-toggle" href="#">Expand all</a><a class="back-to-top" href="#">Back to top</a><a class="go-to-bottom" href="#">Go to bottom</a></div>
  196. </ul>
  197. </div>
  198. </div>
  199. <div id="ui-toc-affix" class="ui-affix-toc ui-toc-dropdown unselectable hidden-print" data-spy="affix" style="top:17px;display:none;" null null>
  200. <div class="toc"><ul class="nav">
  201. <li><a href="#Week-3---Message-Brokers" title="Week 3 - Message Brokers">Week 3 - Message Brokers</a><ul class="nav">
  202. <li><a href="#Overview" title="Overview">Overview</a></li>
  203. <li><a href="#System-Architecture" title="System Architecture">System Architecture</a><ul class="nav">
  204. <li><a href="#Architecture-diagram" title="Architecture diagram">Architecture diagram</a></li>
  205. <li><a href="#Directory-structure" title="Directory structure">Directory structure</a></li>
  206. <li><a href="#Publishers" title="Publishers">Publishers</a></li>
  207. <li><a href="#Subscribers" title="Subscribers">Subscribers</a></li>
  208. <li><a href="#Message-Broker-RabbitMQ-Server" title="Message Broker (RabbitMQ Server)">Message Broker (RabbitMQ Server)</a></li>
  209. </ul>
  210. </li>
  211. <li><a href="#Task" title="Task">Task</a></li>
  212. <li><a href="#Example-Run" title="Example Run">Example Run</a></li>
  213. <li><a href="#Checklist" title="Checklist">Checklist</a></li>
  214. </ul>
  215. </li>
  216. </ul>
  217. </div><div class="toc-menu"><a class="expand-toggle" href="#">Expand all</a><a class="back-to-top" href="#">Back to top</a><a class="go-to-bottom" href="#">Go to bottom</a></div>
  218. </div>
  219. <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.1.1/jquery.min.js" integrity="sha256-hVVnYaiADRTO2PzUGmuLJr8BLUSjGIZsDYGmIJLv2b8=" crossorigin="anonymous"></script>
  220. <script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha256-U5ZEeKfGNOja007MMD3YBI0A3OSZOQbeG6z2f2Y0hu8=" crossorigin="anonymous" defer></script>
  221. <script src="https://cdnjs.cloudflare.com/ajax/libs/gist-embed/2.6.0/gist-embed.min.js" integrity="sha256-KyF2D6xPIJUW5sUDSs93vWyZm+1RzIpKCexxElmxl8g=" crossorigin="anonymous" defer></script>
  222. <script>
  223. var markdown = $(".markdown-body");
  224. //smooth all hash trigger scrolling
  225. function smoothHashScroll() {
  226. var hashElements = $("a[href^='#']").toArray();
  227. for (var i = 0; i < hashElements.length; i++) {
  228. var element = hashElements[i];
  229. var $element = $(element);
  230. var hash = element.hash;
  231. if (hash) {
  232. $element.on('click', function (e) {
  233. // store hash
  234. var hash = this.hash;
  235. if ($(hash).length <= 0) return;
  236. // prevent default anchor click behavior
  237. e.preventDefault();
  238. // animate
  239. $('body, html').stop(true, true).animate({
  240. scrollTop: $(hash).offset().top
  241. }, 100, "linear", function () {
  242. // when done, add hash to url
  243. // (default click behaviour)
  244. window.location.hash = hash;
  245. });
  246. });
  247. }
  248. }
  249. }
  250. smoothHashScroll();
  251. var toc = $('.ui-toc');
  252. var tocAffix = $('.ui-affix-toc');
  253. var tocDropdown = $('.ui-toc-dropdown');
  254. //toc
  255. tocDropdown.click(function (e) {
  256. e.stopPropagation();
  257. });
  258. var enoughForAffixToc = true;
  259. function generateScrollspy() {
  260. $(document.body).scrollspy({
  261. target: ''
  262. });
  263. $(document.body).scrollspy('refresh');
  264. if (enoughForAffixToc) {
  265. toc.hide();
  266. tocAffix.show();
  267. } else {
  268. tocAffix.hide();
  269. toc.show();
  270. }
  271. $(document.body).scroll();
  272. }
  273. function windowResize() {
  274. //toc right
  275. var paddingRight = parseFloat(markdown.css('padding-right'));
  276. var right = ($(window).width() - (markdown.offset().left + markdown.outerWidth() - paddingRight));
  277. toc.css('right', right + 'px');
  278. //affix toc left
  279. var newbool;
  280. var rightMargin = (markdown.parent().outerWidth() - markdown.outerWidth()) / 2;
  281. //for ipad or wider device
  282. if (rightMargin >= 133) {
  283. newbool = true;
  284. var affixLeftMargin = (tocAffix.outerWidth() - tocAffix.width()) / 2;
  285. var left = markdown.offset().left + markdown.outerWidth() - affixLeftMargin;
  286. tocAffix.css('left', left + 'px');
  287. } else {
  288. newbool = false;
  289. }
  290. if (newbool != enoughForAffixToc) {
  291. enoughForAffixToc = newbool;
  292. generateScrollspy();
  293. }
  294. }
  295. $(window).resize(function () {
  296. windowResize();
  297. });
  298. $(document).ready(function () {
  299. windowResize();
  300. generateScrollspy();
  301. });
  302. //remove hash
  303. function removeHash() {
  304. window.location.hash = '';
  305. }
  306. var backtotop = $('.back-to-top');
  307. var gotobottom = $('.go-to-bottom');
  308. backtotop.click(function (e) {
  309. e.preventDefault();
  310. e.stopPropagation();
  311. if (scrollToTop)
  312. scrollToTop();
  313. removeHash();
  314. });
  315. gotobottom.click(function (e) {
  316. e.preventDefault();
  317. e.stopPropagation();
  318. if (scrollToBottom)
  319. scrollToBottom();
  320. removeHash();
  321. });
  322. var toggle = $('.expand-toggle');
  323. var tocExpand = false;
  324. checkExpandToggle();
  325. toggle.click(function (e) {
  326. e.preventDefault();
  327. e.stopPropagation();
  328. tocExpand = !tocExpand;
  329. checkExpandToggle();
  330. })
  331. function checkExpandToggle () {
  332. var toc = $('.ui-toc-dropdown .toc');
  333. var toggle = $('.expand-toggle');
  334. if (!tocExpand) {
  335. toc.removeClass('expand');
  336. toggle.text('Expand all');
  337. } else {
  338. toc.addClass('expand');
  339. toggle.text('Collapse all');
  340. }
  341. }
  342. function scrollToTop() {
  343. $('body, html').stop(true, true).animate({
  344. scrollTop: 0
  345. }, 100, "linear");
  346. }
  347. function scrollToBottom() {
  348. $('body, html').stop(true, true).animate({
  349. scrollTop: $(document.body)[0].scrollHeight
  350. }, 100, "linear");
  351. }
  352. </script>
  353. </body>
  354. </html>