docs/images/language-server-architecture.svg

<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentStyleType="text/css" height="639px" preserveAspectRatio="none" style="width:655px;height:639px;background:#FFFFFF;" version="1.1" viewBox="0 0 655 639" width="655px" zoomAndPan="magnify"><defs/><g><!--MD5=[1820a902234ceec44191f689ce368b3d]
cluster hosts--><g id="cluster_hosts"><rect fill="none" height="200" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:1.0;" width="634" x="7" y="7"/><text fill="#000000" font-family="sans-serif" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="40" x="304" y="23.5332">Hosts</text></g><!--MD5=[30e5c6eccaf2cf588d94672aced9a51a]
cluster browserHost--><g id="cluster_browserHost"><rect fill="none" height="116" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:1.0;" width="173" x="39" y="59"/><polygon fill="none" points="195,64,195,78,207,78,207,70,201,64,195,64" style="stroke:#181818;stroke-width:1.0;"/><line style="stroke:#181818;stroke-width:1.0;" x1="201" x2="201" y1="64" y2="70"/><line style="stroke:#181818;stroke-width:1.0;" x1="207" x2="201" y1="70" y2="70"/><text fill="#000000" font-family="sans-serif" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="95" x="78" y="75.5332">Browser Host</text></g><!--MD5=[d35b4d88c39987e1e4cabfb23e45e2ad]
cluster ideHost--><g id="cluster_ideHost"><rect fill="none" height="100" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:1.0;" width="373" x="244" y="67"/><polygon fill="none" points="600,72,600,86,612,86,612,78,606,72,600,72" style="stroke:#181818;stroke-width:1.0;"/><line style="stroke:#181818;stroke-width:1.0;" x1="606" x2="606" y1="72" y2="78"/><line style="stroke:#181818;stroke-width:1.0;" x1="612" x2="606" y1="78" y2="78"/><text fill="#000000" font-family="sans-serif" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="176" x="342.5" y="83.5332">Desktop Client Host (IDE)</text></g><!--MD5=[e2d4d4a82f9a5fb357734f394e1afe49]
cluster binary--><g id="cluster_binary"><rect fill="none" height="219.86" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:1.0;" width="185" x="458" y="413.5"/><polygon fill="none" points="626,418.5,626,432.5,638,432.5,638,424.5,632,418.5,626,418.5" style="stroke:#181818;stroke-width:1.0;"/><line style="stroke:#181818;stroke-width:1.0;" x1="632" x2="632" y1="418.5" y2="424.5"/><line style="stroke:#181818;stroke-width:1.0;" x1="638" x2="632" y1="424.5" y2="424.5"/><text fill="#000000" font-family="sans-serif" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="169" x="466" y="430.0332">Language Server Binary</text></g><!--MD5=[27d751aa3e059f7a8948f85c83478d41]
cluster languageServer--><g id="cluster_languageServer"><path d="M56.5,281 L178.5,281 A3.75,3.75 0 0 1 181,283.5 L188,304.6094 L415.5,304.6094 A2.5,2.5 0 0 1 418,307.1094 L418,492.86 A2.5,2.5 0 0 1 415.5,495.36 L56.5,495.36 A2.5,2.5 0 0 1 54,492.86 L54,283.5 A2.5,2.5 0 0 1 56.5,281 " fill="none" style="stroke:#000000;stroke-width:1.5;"/><line style="stroke:#000000;stroke-width:1.5;" x1="54" x2="188" y1="304.6094" y2="304.6094"/><text fill="#000000" font-family="sans-serif" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="121" x="58" y="297.5332">Language Server</text></g><!--MD5=[ae30fff176e17453002fca8aceeaf877]
entity browserLspClient--><g id="elem_browserLspClient"><rect fill="#F1F1F1" height="47.6094" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="106" x="82" y="103"/><rect fill="#F1F1F1" height="10" style="stroke:#181818;stroke-width:0.5;" width="15" x="168" y="108"/><rect fill="#F1F1F1" height="2" style="stroke:#181818;stroke-width:0.5;" width="4" x="166" y="110"/><rect fill="#F1F1F1" height="2" style="stroke:#181818;stroke-width:0.5;" width="4" x="166" y="114"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="66" x="97" y="137.5332">LSP Client</text></g><!--MD5=[dcf44090b591465409b6b92ec3893884]
entity ideLspClient--><g id="elem_ideLspClient"><rect fill="#F1F1F1" height="47.6094" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="106" x="260" y="103"/><rect fill="#F1F1F1" height="10" style="stroke:#181818;stroke-width:0.5;" width="15" x="346" y="108"/><rect fill="#F1F1F1" height="2" style="stroke:#181818;stroke-width:0.5;" width="4" x="344" y="110"/><rect fill="#F1F1F1" height="2" style="stroke:#181818;stroke-width:0.5;" width="4" x="344" y="114"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="66" x="275" y="137.5332">LSP Client</text></g><!--MD5=[b625c170a1a5e0e5f15a9c28af75d8c8]
entity ideExtension--><g id="elem_ideExtension"><rect fill="#F1F1F1" height="47.6094" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="127" x="473.5" y="103"/><rect fill="#F1F1F1" height="10" style="stroke:#181818;stroke-width:0.5;" width="15" x="580.5" y="108"/><rect fill="#F1F1F1" height="2" style="stroke:#181818;stroke-width:0.5;" width="4" x="578.5" y="110"/><rect fill="#F1F1F1" height="2" style="stroke:#181818;stroke-width:0.5;" width="4" x="578.5" y="114"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="87" x="488.5" y="137.5332">IDE Extension</text></g><g id="elem_GMN11"><path d="M482.5,550.36 L482.5,609.4147 L607.5,609.4147 L607.5,560.36 L597.5,550.36 L482.5,550.36 " fill="#FEFFDD" style="stroke:#181818;stroke-width:0.5;"/><path d="M597.5,550.36 L597.5,560.36 L607.5,560.36 L597.5,550.36 " fill="#FEFFDD" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="94" x="488.5" y="568.8551">Can contain one</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="100" x="488.5" y="585.2067">or more language</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="41" x="488.5" y="601.5582">servers</text></g><!--MD5=[177f1e8b63227931587b5e3f7ea896ca]
entity languageService--><g id="elem_languageService"><rect fill="#F1F1F1" height="47.6094" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="155" x="238.5" y="417.86"/><rect fill="#F1F1F1" height="10" style="stroke:#181818;stroke-width:0.5;" width="15" x="373.5" y="422.86"/><rect fill="#F1F1F1" height="2" style="stroke:#181818;stroke-width:0.5;" width="4" x="371.5" y="424.86"/><rect fill="#F1F1F1" height="2" style="stroke:#181818;stroke-width:0.5;" width="4" x="371.5" y="428.86"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="115" x="253.5" y="452.3932">Language Service</text></g><g id="elem_GMN16"><path d="M78.5,412.36 L78.5,471.4147 L203.5,471.4147 L203.5,422.36 L193.5,412.36 L78.5,412.36 " fill="#FEFFDD" style="stroke:#181818;stroke-width:0.5;"/><path d="M193.5,412.36 L193.5,422.36 L203.5,422.36 L193.5,412.36 " fill="#FEFFDD" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="94" x="84.5" y="430.8551">Can contain one</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="100" x="84.5" y="447.2067">or more language</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="47" x="84.5" y="463.5582">services</text></g><!--MD5=[45547ca831433324dc0dc22ae9c2bd22]
link binary to GMN11--><g id="link_binary_GMN11"><path d="M537.01,442.96 C537.18,445.84 541.02,511.13 543.31,550.15 " fill="none" id="binary-GMN11" style="stroke:#181818;stroke-width:1.0;stroke-dasharray:7.0,7.0;"/></g><!--MD5=[19ef04b3d4183cc1bad48536cb44ed55]
link languageServer to GMN16--><g id="link_languageServer_GMN16"><path d="M146,310.45 C145.89,313.19 143.54,374.48 142.1,412.05 " fill="none" id="languageServer-GMN16" style="stroke:#181818;stroke-width:1.0;stroke-dasharray:7.0,7.0;"/></g><!--MD5=[14ffffb7c850ecd360dfecc22a160c10]
link browserHost to languageServer--><g id="link_browserHost_languageServer"><path d="M48.1312,175.3625 C50.72,201.2675 57.265,232.895 73,257 C78.2525,265.045 85.2425,272.2056 92.8203,278.4384 C93.7675,279.2175 94.724,279.9821 95.6873,280.7322 " fill="none" id="browserHost-to-languageServer" style="stroke:#181818;stroke-width:1.0;"/><polygon fill="#181818" points="95.6873,280.7322,91.0431,272.047,91.742,277.6605,86.1285,278.3595,95.6873,280.7322" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="43" x="81" y="237.4951">creates</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="57" x="74" y="253.8467">and hosts</text></g><!--MD5=[5be476d0f5381306f122c1a5423d49f2]
link browserLspClient to languageServer--><g id="link_browserLspClient_languageServer"><path d="M136.74,156.47 C138.265,181.475 140.53,218.6325 142.4388,249.9363 C142.9159,257.7622 143.3709,265.2223 143.7864,272.0351 C143.8903,273.7384 143.9917,275.4011 144.0904,277.019 C144.1397,277.828 144.1884,278.6258 144.2363,279.4117 C144.2603,279.8047 144.2841,280.1948 144.3077,280.5818 " fill="none" id="browserLspClient-languageServer" style="stroke:#181818;stroke-width:1.0;"/><polygon fill="#181818" points="144.3077,280.5818,147.7523,271.355,144.0033,275.5911,139.7671,271.8421,144.3077,280.5818" style="stroke:#181818;stroke-width:1.0;"/><polygon fill="#181818" points="136.42,151.21,132.9925,160.4432,136.7337,156.2002,140.9767,159.9413,136.42,151.21" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="77" x="148.5" y="237.4951">LSP Protocol</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="88" x="143" y="253.8467">communication</text></g><!--MD5=[e22c5a7138b000d24ceb7a2403c9c8c6]
reverse link ideLspClient to ideExtension--><g id="link_ideLspClient_ideExtension"><path d="M371.43,127 C402.64,127 441.12,127 473.13,127 " fill="none" id="ideLspClient-backto-ideExtension" style="stroke:#181818;stroke-width:1.0;"/><polygon fill="#181818" points="366.08,127,375.08,131,371.08,127,375.08,123,366.08,127" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="55" x="392.25" y="104.4951">Registers</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="71" x="384.25" y="120.8467">LSP Stream</text></g><!--MD5=[8096257b8953450e5e0e6ce4964313f1]
link ideExtension to binary--><g id="link_ideExtension_binary"><path d="M537,151.01 C537,186.57 537,257.3425 537,320.05 C537,351.4038 537,380.7413 537,402.6528 C537,405.3918 537,408.0147 537,410.511 C537,411.1351 537,411.7512 537,412.3593 C537,412.6634 537,412.9654 537,413.2654 " fill="none" id="ideExtension-to-binary" style="stroke:#181818;stroke-width:1.0;"/><polygon fill="#181818" points="537,413.2654,541,404.2654,537,408.2654,533,404.2654,537,413.2654" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="56" x="538" y="314.8551">Launches</text></g><!--MD5=[2e4a72afa26d277a46d37d81d2a64be8]
reverse link languageServer to binary--><g id="link_languageServer_binary"><path d="M418.5884,399.2742 C418.8107,399.3499 419.0331,399.4257 419.2557,399.5016 C419.7009,399.6533 420.1466,399.8052 420.5928,399.9575 C424.1625,401.1752 427.7645,402.409 431.3792,403.6517 C438.6086,406.137 445.8887,408.6573 453.063,411.1541 C454.8565,411.7782 456.6435,412.4009 458.4214,413.0212 C458.8659,413.1763 459.3098,413.3312 459.7531,413.486 " fill="none" id="languageServer-backto-binary" style="stroke:#181818;stroke-width:1.0;"/><polygon fill="#181818" points="418.5884,399.2742,425.8182,405.9622,423.3214,400.8862,428.3974,398.3894,418.5884,399.2742" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="43" x="374" y="362.8551">creates</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="57" x="367" y="379.2067">and hosts</text></g><!--MD5=[65fd9e293c2b5c266df29f86e405ddad]
link ideLspClient to languageServer--><g id="link_ideLspClient_languageServer"><path d="M302.64,155.76 C290.95,184.05 269.63,227.81 240,257 C231.655,265.2225 221.7244,272.5087 211.4939,278.8216 C210.8545,279.2161 210.2139,279.6069 209.5725,279.9938 C209.2518,280.1873 208.9308,280.3798 208.6097,280.5713 C208.4492,280.6671 208.2886,280.7627 208.128,280.858 " fill="none" id="ideLspClient-languageServer" style="stroke:#181818;stroke-width:1.0;"/><polygon fill="#181818" points="208.128,280.858,217.9092,279.7059,212.4281,278.3067,213.8272,272.8256,208.128,280.858" style="stroke:#181818;stroke-width:1.0;"/><polygon fill="#181818" points="304.57,151.01,297.4773,157.8433,302.6885,155.6425,304.8893,160.8537,304.57,151.01" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="77" x="271.5" y="237.4951">LSP Protocol</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="88" x="266" y="253.8467">communication</text></g><!--MD5=[223355fd8e2d97f9594a51d3c785f967]
@startuml

    rectangle hosts as "Hosts" {
        artifact browserHost as "Browser Host"  {
            component browserLspClient as "LSP Client"
        }

        artifact ideHost as "Desktop Client Host (IDE)"  {
            component ideLspClient as "LSP Client"
            component ideExtension as "IDE Extension"
        }
    }

    artifact binary as "Language Server Binary"  {
        note bottom of binary
            Can contain one 
            or more language 
            servers
        end note
    }

    package languageServer as "Language Server" {
        component languageService as "Language Service"

        note bottom of languageServer
            Can contain one 
            or more language 
            services
        end note
    }

    browserHost -> languageServer : creates\nand hosts
    browserLspClient <-> languageServer : LSP Protocol\ncommunication
    
    ideExtension -left-> ideLspClient : Registers\nLSP Stream
    ideExtension -down- -> binary : Launches
    binary -left-> languageServer : creates\nand hosts

    ideLspClient <- -> languageServer : LSP Protocol\ncommunication


@enduml

PlantUML version 1.2022.7(Mon Aug 22 10:01:30 PDT 2022)
(GPL source distribution)
Java Runtime: Java(TM) SE Runtime Environment
JVM: Java HotSpot(TM) Client VM
Default Encoding: Cp1252
Language: en
Country: US
--></g></svg>