[{"data":1,"prerenderedAt":1683},["ShallowReactive",2],{"navigation_docs":3,"-standard-library-http":377,"-standard-library-http-surround":1678},[4,39,114,144,184,244,293,362],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":6},"Getting Started",false,"\u002Fgetting-started","1.getting-started",[10,15,20,25,30,35],{"title":11,"path":12,"stem":13,"icon":14},"Learning Path","\u002Fgetting-started\u002Flearning-path","1.getting-started\u002F1.learning-path","i-lucide-map",{"title":16,"path":17,"stem":18,"icon":19},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F2.introduction","i-lucide-house",{"title":21,"path":22,"stem":23,"icon":24},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F3.installation","i-lucide-download",{"title":26,"path":27,"stem":28,"icon":29},"Your First Program","\u002Fgetting-started\u002Ffirst-program","1.getting-started\u002F4.first-program","i-lucide-play",{"title":31,"path":32,"stem":33,"icon":34},"Modules and Dependencies","\u002Fgetting-started\u002Fmodules-and-dependencies","1.getting-started\u002F5.modules-and-dependencies","i-lucide-package-open",{"title":36,"path":37,"stem":38,"icon":34},"Advanced Modules","\u002Fgetting-started\u002Fadvanced-modules","1.getting-started\u002F6.advanced-modules",{"title":40,"path":41,"stem":42,"children":43,"page":6},"Fundamentals","\u002Ffundamentals","2.fundamentals",[44,49,54,59,64,69,74,79,84,89,94,99,104,109],{"title":45,"path":46,"stem":47,"icon":48},"Program Structure","\u002Ffundamentals\u002Fprogram-structure","2.fundamentals\u002F1.program-structure","i-lucide-workflow",{"title":50,"path":51,"stem":52,"icon":53},"Structs and Methods","\u002Ffundamentals\u002Fstructs-and-methods","2.fundamentals\u002F10.structs-and-methods","i-lucide-box",{"title":55,"path":56,"stem":57,"icon":58},"Interfaces","\u002Ffundamentals\u002Finterfaces","2.fundamentals\u002F11.interfaces","i-lucide-plug",{"title":60,"path":61,"stem":62,"icon":63},"Error Handling","\u002Ffundamentals\u002Ferrors","2.fundamentals\u002F12.errors","i-lucide-triangle-alert",{"title":65,"path":66,"stem":67,"icon":68},"Defined Types and Type Aliases","\u002Ffundamentals\u002Fdefined-types","2.fundamentals\u002F13.defined-types","i-lucide-tags",{"title":70,"path":71,"stem":72,"icon":73},"Generics","\u002Ffundamentals\u002Fgenerics","2.fundamentals\u002F14.generics","i-lucide-blocks",{"title":75,"path":76,"stem":77,"icon":78},"Project Structure","\u002Ffundamentals\u002Fproject-structure","2.fundamentals\u002F2.project-structure","i-lucide-folder-tree",{"title":80,"path":81,"stem":82,"icon":83},"Project Layout","\u002Ffundamentals\u002Fproject-layout","2.fundamentals\u002F3.project-layout","i-lucide-layout",{"title":85,"path":86,"stem":87,"icon":88},"Variables and Data Types","\u002Ffundamentals\u002Fvariables-and-types","2.fundamentals\u002F4.variables-and-types","i-lucide-variable",{"title":90,"path":91,"stem":92,"icon":93},"Functions","\u002Ffundamentals\u002Ffunctions","2.fundamentals\u002F5.functions","i-lucide-braces",{"title":95,"path":96,"stem":97,"icon":98},"Control Statements","\u002Ffundamentals\u002Fcontrol-statements","2.fundamentals\u002F6.control-statements","i-lucide-git-branch",{"title":100,"path":101,"stem":102,"icon":103},"Pointers","\u002Ffundamentals\u002Fpointers","2.fundamentals\u002F7.pointers","i-lucide-mouse-pointer-2",{"title":105,"path":106,"stem":107,"icon":108},"Arrays and Slices","\u002Ffundamentals\u002Farrays-and-slices","2.fundamentals\u002F8.arrays-and-slices","i-lucide-list",{"title":110,"path":111,"stem":112,"icon":113},"Maps","\u002Ffundamentals\u002Fmaps","2.fundamentals\u002F9.maps","i-lucide-table-properties",{"title":115,"path":116,"stem":117,"children":118,"page":6},"Concurrency","\u002Fconcurrency","3.concurrency",[119,124,129,134,139],{"title":120,"path":121,"stem":122,"icon":123},"Concurrency Model","\u002Fconcurrency\u002Fconcurrency-model","3.concurrency\u002F1.concurrency-model","i-lucide-network",{"title":125,"path":126,"stem":127,"icon":128},"Goroutines","\u002Fconcurrency\u002Fgoroutines","3.concurrency\u002F2.goroutines","i-lucide-git-fork",{"title":130,"path":131,"stem":132,"icon":133},"Channels","\u002Fconcurrency\u002Fchannels","3.concurrency\u002F3.channels","i-lucide-arrow-left-right",{"title":135,"path":136,"stem":137,"icon":138},"Select and Cancellation","\u002Fconcurrency\u002Fselect-and-cancellation","3.concurrency\u002F4.select-and-cancellation","i-lucide-circle-stop",{"title":140,"path":141,"stem":142,"icon":143},"Synchronization","\u002Fconcurrency\u002Fsynchronization","3.concurrency\u002F5.synchronization","i-lucide-lock-keyhole",{"title":145,"path":146,"stem":147,"children":148,"page":6},"Standard Library","\u002Fstandard-library","4.standard-library",[149,154,159,164,169,174,179],{"title":150,"path":151,"stem":152,"icon":153},"Standard Library Overview","\u002Fstandard-library\u002Foverview","4.standard-library\u002F1.overview","i-lucide-library",{"title":155,"path":156,"stem":157,"icon":158},"Text and Formatting","\u002Fstandard-library\u002Ftext-and-formatting","4.standard-library\u002F2.text-and-formatting","i-lucide-text",{"title":160,"path":161,"stem":162,"icon":163},"Files and JSON","\u002Fstandard-library\u002Ffiles-and-json","4.standard-library\u002F3.files-and-json","i-lucide-file-json",{"title":165,"path":166,"stem":167,"icon":168},"HTTP Clients and Servers","\u002Fstandard-library\u002Fhttp","4.standard-library\u002F4.http","i-lucide-server",{"title":170,"path":171,"stem":172,"icon":173},"Testing","\u002Fstandard-library\u002Ftesting","4.standard-library\u002F5.testing","i-lucide-flask-conical",{"title":175,"path":176,"stem":177,"icon":178},"Command-Line Tools and Configuration","\u002Fstandard-library\u002Fcommand-line-and-configuration","4.standard-library\u002F6.command-line-and-configuration","i-lucide-terminal-square",{"title":180,"path":181,"stem":182,"icon":183},"Structured Logging","\u002Fstandard-library\u002Fstructured-logging","4.standard-library\u002F7.structured-logging","i-lucide-scroll-text",{"title":185,"path":186,"stem":187,"children":188,"page":6},"Backend Development","\u002Fbackend-development","5.backend-development",[189,194,199,204,209,214,219,224,229,234,239],{"title":190,"path":191,"stem":192,"icon":193},"Backend Roadmap","\u002Fbackend-development\u002Fbackend-roadmap","5.backend-development\u002F1.backend-roadmap","i-lucide-route",{"title":195,"path":196,"stem":197,"icon":198},"Graceful Shutdown","\u002Fbackend-development\u002Fgraceful-shutdown","5.backend-development\u002F10.graceful-shutdown","i-lucide-power",{"title":200,"path":201,"stem":202,"icon":203},"Production Checklist","\u002Fbackend-development\u002Fproduction-checklist","5.backend-development\u002F11.production-checklist","i-lucide-clipboard-check",{"title":205,"path":206,"stem":207,"icon":208},"HTTP API Design","\u002Fbackend-development\u002Fhttp-api-design","5.backend-development\u002F2.http-api-design","i-lucide-waypoints",{"title":210,"path":211,"stem":212,"icon":213},"Middleware","\u002Fbackend-development\u002Fmiddleware","5.backend-development\u002F3.middleware","i-lucide-layers-3",{"title":215,"path":216,"stem":217,"icon":218},"Validation","\u002Fbackend-development\u002Fvalidation","5.backend-development\u002F4.validation","i-lucide-list-checks",{"title":220,"path":221,"stem":222,"icon":223},"Application Wiring","\u002Fbackend-development\u002Fapplication-wiring","5.backend-development\u002F5.application-wiring","i-lucide-cable",{"title":225,"path":226,"stem":227,"icon":228},"Observability","\u002Fbackend-development\u002Fobservability","5.backend-development\u002F6.observability","i-lucide-activity",{"title":230,"path":231,"stem":232,"icon":233},"Database SQL","\u002Fbackend-development\u002Fdatabase-sql","5.backend-development\u002F7.database-sql","i-lucide-database",{"title":235,"path":236,"stem":237,"icon":238},"Transactions","\u002Fbackend-development\u002Ftransactions","5.backend-development\u002F8.transactions","i-lucide-repeat-2",{"title":240,"path":241,"stem":242,"icon":243},"Authentication and Authorization","\u002Fbackend-development\u002Fauthentication","5.backend-development\u002F9.authentication","i-lucide-shield-check",{"title":245,"path":246,"stem":247,"children":248,"page":6},"Advanced Go","\u002Fadvanced-go","6.advanced-go",[249,254,259,264,269,274,278,283,288],{"title":250,"path":251,"stem":252,"icon":253},"Advanced Go Roadmap","\u002Fadvanced-go\u002Fadvanced-roadmap","6.advanced-go\u002F1.advanced-roadmap","i-lucide-brain-circuit",{"title":255,"path":256,"stem":257,"icon":258},"Reflection","\u002Fadvanced-go\u002Freflection","6.advanced-go\u002F2.reflection","i-lucide-scan-search",{"title":260,"path":261,"stem":262,"icon":263},"Memory and Garbage Collection","\u002Fadvanced-go\u002Fmemory-and-garbage-collection","6.advanced-go\u002F3.memory-and-garbage-collection","i-lucide-memory-stick",{"title":265,"path":266,"stem":267,"icon":268},"Benchmarking and Profiling","\u002Fadvanced-go\u002Fbenchmarking-and-profiling","6.advanced-go\u002F4.benchmarking-and-profiling","i-lucide-gauge",{"title":270,"path":271,"stem":272,"icon":273},"Advanced Testing and Fuzzing","\u002Fadvanced-go\u002Fadvanced-testing-and-fuzzing","6.advanced-go\u002F5.advanced-testing-and-fuzzing","i-lucide-microscope",{"title":275,"path":276,"stem":277,"icon":48},"Advanced Concurrency","\u002Fadvanced-go\u002Fadvanced-concurrency","6.advanced-go\u002F6.advanced-concurrency",{"title":279,"path":280,"stem":281,"icon":282},"Unsafe and C Boundaries","\u002Fadvanced-go\u002Funsafe-and-cgo","6.advanced-go\u002F7.unsafe-and-cgo","i-lucide-radiation",{"title":284,"path":285,"stem":286,"icon":287},"Package and API Design","\u002Fadvanced-go\u002Fpackage-and-api-design","6.advanced-go\u002F8.package-and-api-design","i-lucide-boxes",{"title":289,"path":290,"stem":291,"icon":292},"Distributed Reliability","\u002Fadvanced-go\u002Fdistributed-reliability","6.advanced-go\u002F9.distributed-reliability","i-lucide-cloud-cog",{"title":294,"path":295,"stem":296,"children":297,"page":6},"Projects","\u002Fprojects","7.projects",[298,316,332,347],{"title":299,"path":300,"stem":301,"children":302,"icon":305},"CLI Task Manager","\u002Fprojects\u002Fcli-task-manager","7.projects\u002F1.cli-task-manager\u002Findex",[303,306,311],{"title":304,"path":300,"stem":301,"icon":305},"Project — CLI Task Manager","i-lucide-list-todo",{"title":307,"path":308,"stem":309,"icon":310},"CLI — Domain and Storage","\u002Fprojects\u002Fcli-task-manager\u002Fdomain-and-storage","7.projects\u002F1.cli-task-manager\u002F1.domain-and-storage","i-lucide-save",{"title":312,"path":313,"stem":314,"icon":315},"CLI — Commands and Tests","\u002Fprojects\u002Fcli-task-manager\u002Fcommands-and-tests","7.projects\u002F1.cli-task-manager\u002F2.commands-and-tests","i-lucide-terminal",{"title":317,"path":318,"stem":319,"children":320,"icon":323},"Concurrent URL Checker","\u002Fprojects\u002Fconcurrent-url-checker","7.projects\u002F2.concurrent-url-checker\u002Findex",[321,324,328],{"title":322,"path":318,"stem":319,"icon":323},"Project — Concurrent URL Checker","i-lucide-radar",{"title":325,"path":326,"stem":327,"icon":128},"URL Checker — Worker Pipeline","\u002Fprojects\u002Fconcurrent-url-checker\u002Fworker-pipeline","7.projects\u002F2.concurrent-url-checker\u002F1.worker-pipeline",{"title":329,"path":330,"stem":331,"icon":173},"URL Checker — Cancellation and Tests","\u002Fprojects\u002Fconcurrent-url-checker\u002Fcancellation-and-tests","7.projects\u002F2.concurrent-url-checker\u002F2.cancellation-and-tests",{"title":333,"path":334,"stem":335,"children":336},"File-backed API","\u002Fprojects\u002Ffile-backed-api","7.projects\u002F3.file-backed-api\u002Findex",[337,339,343],{"title":338,"path":334,"stem":335},"File-backed notes API",{"title":340,"path":341,"stem":342},"File store and concurrency","\u002Fprojects\u002Ffile-backed-api\u002Ffile-store-and-concurrency","7.projects\u002F3.file-backed-api\u002F1.file-store-and-concurrency",{"title":344,"path":345,"stem":346},"HTTP layer and tests","\u002Fprojects\u002Ffile-backed-api\u002Fhttp-and-tests","7.projects\u002F3.file-backed-api\u002F2.http-and-tests",{"title":348,"path":349,"stem":350,"children":351},"Production REST API","\u002Fprojects\u002Fproduction-rest-api","7.projects\u002F4.production-rest-api\u002Findex",[352,354,358],{"title":353,"path":349,"stem":350},"Production REST API capstone",{"title":355,"path":356,"stem":357},"Persistence and authentication","\u002Fprojects\u002Fproduction-rest-api\u002Fpersistence-and-auth","7.projects\u002F4.production-rest-api\u002F1.persistence-and-auth",{"title":359,"path":360,"stem":361},"Operations and release","\u002Fprojects\u002Fproduction-rest-api\u002Foperations-and-release","7.projects\u002F4.production-rest-api\u002F2.operations-and-release",{"title":363,"path":364,"stem":365,"children":366,"page":6},"Meta","\u002Fmeta","99.meta",[367,372],{"title":368,"path":369,"stem":370,"icon":371},"About","\u002Fmeta\u002Fabout","99.meta\u002F1.about","i-lucide-info",{"title":373,"path":374,"stem":375,"icon":376},"Acknowledgements","\u002Fmeta\u002Facknowledgements","99.meta\u002F2.acknowledgements","i-lucide-heart-handshake",{"id":378,"title":165,"body":379,"description":1670,"extension":1671,"links":1672,"meta":1673,"navigation":1674,"path":166,"seo":1675,"stem":167,"__hash__":1677},"docs\u002F4.standard-library\u002F4.http.md",{"type":380,"value":381,"toc":1659},"minimark",[382,389,394,407,416,420,521,524,538,542,812,823,827,1027,1038,1041,1079,1082,1086,1089,1273,1277,1460,1463,1466,1470,1473,1592,1595,1599,1602,1622,1634,1638,1649,1652,1655],[383,384],"learning-lesson-meta",{"description":385,"difficulty":386,"prerequisites":387,"time":388},"Build bounded HTTP clients and servers with explicit resource ownership.","Intermediate","Files, JSON, contexts, and errors","50 minutes",[390,391,393],"h2",{"id":392},"what-you-will-learn","What you will learn",[395,396,397,401,404],"ul",{},[398,399,400],"li",{},"write handlers and configure servers;",[398,402,403],{},"make bounded client requests and close response bodies;",[398,405,406],{},"shut a server down gracefully;",[408,409,410,411,415],"p",{},"The ",[412,413,414],"code",{},"net\u002Fhttp"," package contains both an HTTP server and an HTTP client. You can build useful network services without installing a web framework.",[390,417,419],{"id":418},"your-first-handler","Your first handler",[421,422,427],"pre",{"className":423,"code":424,"language":425,"meta":426,"style":426},"language-go shiki shiki-themes solarized-light material-theme one-dark-pro","func greet(w http.ResponseWriter, r *http.Request) {\n    fmt.Fprintln(w, \"Hello from Go\")\n}\n","go","",[412,428,429,483,515],{"__ignoreMap":426},[430,431,434,438,442,446,450,454,457,460,463,466,469,472,474,477,480],"span",{"class":432,"line":433},"line",1,[430,435,437],{"class":436},"sEOdo","func",[430,439,441],{"class":440},"sisdC"," greet",[430,443,445],{"class":444},"shFME","(",[430,447,449],{"class":448},"syre3","w",[430,451,453],{"class":452},"snwKR"," http",[430,455,456],{"class":444},".",[430,458,459],{"class":452},"ResponseWriter",[430,461,462],{"class":444},",",[430,464,465],{"class":448}," r",[430,467,468],{"class":436}," *",[430,470,471],{"class":452},"http",[430,473,456],{"class":444},[430,475,476],{"class":452},"Request",[430,478,479],{"class":444},")",[430,481,482],{"class":444}," {\n",[430,484,486,490,492,495,497,499,501,505,509,512],{"class":432,"line":485},2,[430,487,489],{"class":488},"s45-6","    fmt",[430,491,456],{"class":444},[430,493,494],{"class":440},"Fprintln",[430,496,445],{"class":444},[430,498,449],{"class":488},[430,500,462],{"class":444},[430,502,504],{"class":503},"sED5a"," \"",[430,506,508],{"class":507},"sVazx","Hello from Go",[430,510,511],{"class":503},"\"",[430,513,514],{"class":444},")\n",[430,516,518],{"class":432,"line":517},3,[430,519,520],{"class":444},"}\n",[408,522,523],{},"A handler receives:",[395,525,526,532],{},[398,527,528,531],{},[412,529,530],{},"http.ResponseWriter",", used to build the response;",[398,533,534,537],{},[412,535,536],{},"*http.Request",", containing the method, URL, headers, body, and request context.",[390,539,541],{"id":540},"create-a-server","Create a server",[421,543,545],{"className":423,"code":544,"language":425,"meta":426,"style":426},"func main() {\n    mux := http.NewServeMux()\n    mux.HandleFunc(\"GET \u002Fgreet\", greet)\n\n    server := &http.Server{\n        Addr:              \":8080\",\n        Handler:           mux,\n        ReadHeaderTimeout: 5 * time.Second,\n    }\n\n    log.Println(\"listening on http:\u002F\u002Flocalhost:8080\")\n    if err := server.ListenAndServe(); err != nil && !errors.Is(err, http.ErrServerClosed) {\n        log.Fatal(err)\n    }\n}\n",[412,546,547,559,578,602,609,630,650,663,687,693,698,720,785,802,807],{"__ignoreMap":426},[430,548,549,551,554,557],{"class":432,"line":433},[430,550,437],{"class":436},[430,552,553],{"class":440}," main",[430,555,556],{"class":444},"()",[430,558,482],{"class":444},[430,560,561,564,568,570,572,575],{"class":432,"line":485},[430,562,563],{"class":488},"    mux",[430,565,567],{"class":566},"su2KV"," :=",[430,569,453],{"class":488},[430,571,456],{"class":444},[430,573,574],{"class":440},"NewServeMux",[430,576,577],{"class":444},"()\n",[430,579,580,582,584,587,589,591,594,596,598,600],{"class":432,"line":517},[430,581,563],{"class":488},[430,583,456],{"class":444},[430,585,586],{"class":440},"HandleFunc",[430,588,445],{"class":444},[430,590,511],{"class":503},[430,592,593],{"class":507},"GET \u002Fgreet",[430,595,511],{"class":503},[430,597,462],{"class":444},[430,599,441],{"class":488},[430,601,514],{"class":444},[430,603,605],{"class":432,"line":604},4,[430,606,608],{"emptyLinePlaceholder":607},true,"\n",[430,610,612,615,617,620,622,624,627],{"class":432,"line":611},5,[430,613,614],{"class":488},"    server",[430,616,567],{"class":566},[430,618,619],{"class":436}," &",[430,621,471],{"class":452},[430,623,456],{"class":444},[430,625,626],{"class":452},"Server",[430,628,629],{"class":444},"{\n",[430,631,633,636,639,642,645,647],{"class":432,"line":632},6,[430,634,635],{"class":488},"        Addr",[430,637,638],{"class":444},":",[430,640,641],{"class":503},"              \"",[430,643,644],{"class":507},":8080",[430,646,511],{"class":503},[430,648,649],{"class":444},",\n",[430,651,653,656,658,661],{"class":432,"line":652},7,[430,654,655],{"class":488},"        Handler",[430,657,638],{"class":444},[430,659,660],{"class":488},"           mux",[430,662,649],{"class":444},[430,664,666,669,671,675,677,680,682,685],{"class":432,"line":665},8,[430,667,668],{"class":488},"        ReadHeaderTimeout",[430,670,638],{"class":444},[430,672,674],{"class":673},"sAJzr"," 5",[430,676,468],{"class":436},[430,678,679],{"class":488}," time",[430,681,456],{"class":444},[430,683,684],{"class":488},"Second",[430,686,649],{"class":444},[430,688,690],{"class":432,"line":689},9,[430,691,692],{"class":444},"    }\n",[430,694,696],{"class":432,"line":695},10,[430,697,608],{"emptyLinePlaceholder":607},[430,699,701,704,706,709,711,713,716,718],{"class":432,"line":700},11,[430,702,703],{"class":488},"    log",[430,705,456],{"class":444},[430,707,708],{"class":440},"Println",[430,710,445],{"class":444},[430,712,511],{"class":503},[430,714,715],{"class":507},"listening on http:\u002F\u002Flocalhost:8080",[430,717,511],{"class":503},[430,719,514],{"class":444},[430,721,723,727,730,732,735,737,740,743,745,749,753,756,759,762,764,767,769,772,774,776,778,781,783],{"class":432,"line":722},12,[430,724,726],{"class":725},"s7Bcg","    if",[430,728,729],{"class":488}," err",[430,731,567],{"class":566},[430,733,734],{"class":488}," server",[430,736,456],{"class":444},[430,738,739],{"class":440},"ListenAndServe",[430,741,742],{"class":444},"();",[430,744,729],{"class":488},[430,746,748],{"class":747},"sRBoR"," !=",[430,750,752],{"class":751},"sp8Z5"," nil",[430,754,755],{"class":747}," &&",[430,757,758],{"class":747}," !",[430,760,761],{"class":488},"errors",[430,763,456],{"class":444},[430,765,766],{"class":440},"Is",[430,768,445],{"class":444},[430,770,771],{"class":488},"err",[430,773,462],{"class":444},[430,775,453],{"class":488},[430,777,456],{"class":444},[430,779,780],{"class":488},"ErrServerClosed",[430,782,479],{"class":444},[430,784,482],{"class":444},[430,786,788,791,793,796,798,800],{"class":432,"line":787},13,[430,789,790],{"class":488},"        log",[430,792,456],{"class":444},[430,794,795],{"class":440},"Fatal",[430,797,445],{"class":444},[430,799,771],{"class":488},[430,801,514],{"class":444},[430,803,805],{"class":432,"line":804},14,[430,806,692],{"class":444},[430,808,810],{"class":432,"line":809},15,[430,811,520],{"class":444},[408,813,814,815,818,819,822],{},"Using your own ",[412,816,817],{},"ServeMux"," keeps dependencies explicit. A configured ",[412,820,821],{},"http.Server"," lets you set timeouts and later perform graceful shutdown.",[390,824,826],{"id":825},"return-json","Return JSON",[421,828,830],{"className":423,"code":829,"language":425,"meta":426,"style":426},"func status(w http.ResponseWriter, r *http.Request) {\n    response := struct {\n        Status string `json:\"status\"`\n    }{Status: \"ok\"}\n\n    w.Header().Set(\"Content-Type\", \"application\u002Fjson\")\n    if err := json.NewEncoder(w).Encode(response); err != nil {\n        log.Println(\"encode response:\", err)\n    }\n}\n",[412,831,832,865,877,895,914,918,954,996,1019,1023],{"__ignoreMap":426},[430,833,834,836,839,841,843,845,847,849,851,853,855,857,859,861,863],{"class":432,"line":433},[430,835,437],{"class":436},[430,837,838],{"class":440}," status",[430,840,445],{"class":444},[430,842,449],{"class":448},[430,844,453],{"class":452},[430,846,456],{"class":444},[430,848,459],{"class":452},[430,850,462],{"class":444},[430,852,465],{"class":448},[430,854,468],{"class":436},[430,856,471],{"class":452},[430,858,456],{"class":444},[430,860,476],{"class":452},[430,862,479],{"class":444},[430,864,482],{"class":444},[430,866,867,870,872,875],{"class":432,"line":485},[430,868,869],{"class":488},"    response",[430,871,567],{"class":566},[430,873,874],{"class":436}," struct",[430,876,482],{"class":444},[430,878,879,882,886,889,892],{"class":432,"line":517},[430,880,881],{"class":488},"        Status",[430,883,885],{"class":884},"sF6sA"," string",[430,887,888],{"class":503}," `",[430,890,891],{"class":507},"json:\"status\"",[430,893,894],{"class":503},"`\n",[430,896,897,900,903,905,907,910,912],{"class":432,"line":604},[430,898,899],{"class":444},"    }{",[430,901,902],{"class":488},"Status",[430,904,638],{"class":444},[430,906,504],{"class":503},[430,908,909],{"class":507},"ok",[430,911,511],{"class":503},[430,913,520],{"class":444},[430,915,916],{"class":432,"line":611},[430,917,608],{"emptyLinePlaceholder":607},[430,919,920,923,925,928,931,934,936,938,941,943,945,947,950,952],{"class":432,"line":632},[430,921,922],{"class":488},"    w",[430,924,456],{"class":444},[430,926,927],{"class":440},"Header",[430,929,930],{"class":444},"().",[430,932,933],{"class":440},"Set",[430,935,445],{"class":444},[430,937,511],{"class":503},[430,939,940],{"class":507},"Content-Type",[430,942,511],{"class":503},[430,944,462],{"class":444},[430,946,504],{"class":503},[430,948,949],{"class":507},"application\u002Fjson",[430,951,511],{"class":503},[430,953,514],{"class":444},[430,955,956,958,960,962,965,967,970,972,974,977,980,982,985,988,990,992,994],{"class":432,"line":652},[430,957,726],{"class":725},[430,959,729],{"class":488},[430,961,567],{"class":566},[430,963,964],{"class":488}," json",[430,966,456],{"class":444},[430,968,969],{"class":440},"NewEncoder",[430,971,445],{"class":444},[430,973,449],{"class":488},[430,975,976],{"class":444},").",[430,978,979],{"class":440},"Encode",[430,981,445],{"class":444},[430,983,984],{"class":488},"response",[430,986,987],{"class":444},");",[430,989,729],{"class":488},[430,991,748],{"class":747},[430,993,752],{"class":751},[430,995,482],{"class":444},[430,997,998,1000,1002,1004,1006,1008,1011,1013,1015,1017],{"class":432,"line":665},[430,999,790],{"class":488},[430,1001,456],{"class":444},[430,1003,708],{"class":440},[430,1005,445],{"class":444},[430,1007,511],{"class":503},[430,1009,1010],{"class":507},"encode response:",[430,1012,511],{"class":503},[430,1014,462],{"class":444},[430,1016,729],{"class":488},[430,1018,514],{"class":444},[430,1020,1021],{"class":432,"line":689},[430,1022,692],{"class":444},[430,1024,1025],{"class":432,"line":695},[430,1026,520],{"class":444},[408,1028,1029,1030,1033,1034,1037],{},"Set headers before calling ",[412,1031,1032],{},"WriteHeader"," or writing the body. The first body write sends status ",[412,1035,1036],{},"200 OK"," automatically.",[408,1039,1040],{},"For an error response:",[421,1042,1044],{"className":423,"code":1043,"language":425,"meta":426,"style":426},"http.Error(w, \"invalid request\", http.StatusBadRequest)\n",[412,1045,1046],{"__ignoreMap":426},[430,1047,1048,1050,1052,1055,1057,1059,1061,1063,1066,1068,1070,1072,1074,1077],{"class":432,"line":433},[430,1049,471],{"class":488},[430,1051,456],{"class":444},[430,1053,1054],{"class":440},"Error",[430,1056,445],{"class":444},[430,1058,449],{"class":488},[430,1060,462],{"class":444},[430,1062,504],{"class":503},[430,1064,1065],{"class":507},"invalid request",[430,1067,511],{"class":503},[430,1069,462],{"class":444},[430,1071,453],{"class":488},[430,1073,456],{"class":444},[430,1075,1076],{"class":488},"StatusBadRequest",[430,1078,514],{"class":444},[408,1080,1081],{},"Do not expose internal error details or secrets to clients.",[390,1083,1085],{"id":1084},"read-request-data-carefully","Read request data carefully",[408,1087,1088],{},"Request bodies come from the network and must be treated as untrusted input. Limit body size, decode into a known struct, reject malformed data, and validate business rules separately.",[421,1090,1092],{"className":423,"code":1091,"language":425,"meta":426,"style":426},"r.Body = http.MaxBytesReader(w, r.Body, 1\u003C\u003C20) \u002F\u002F 1 MiB\n\ndecoder := json.NewDecoder(r.Body)\ndecoder.DisallowUnknownFields()\n\nvar input CreateLessonRequest\nif err := decoder.Decode(&input); err != nil {\n    http.Error(w, \"invalid JSON\", http.StatusBadRequest)\n    return\n}\n",[412,1093,1094,1143,1147,1171,1182,1186,1197,1232,1264,1269],{"__ignoreMap":426},[430,1095,1096,1099,1101,1104,1107,1109,1111,1114,1116,1118,1120,1122,1124,1126,1128,1131,1134,1137,1139],{"class":432,"line":433},[430,1097,1098],{"class":488},"r",[430,1100,456],{"class":444},[430,1102,1103],{"class":488},"Body",[430,1105,1106],{"class":566}," =",[430,1108,453],{"class":488},[430,1110,456],{"class":444},[430,1112,1113],{"class":440},"MaxBytesReader",[430,1115,445],{"class":444},[430,1117,449],{"class":488},[430,1119,462],{"class":444},[430,1121,465],{"class":488},[430,1123,456],{"class":444},[430,1125,1103],{"class":488},[430,1127,462],{"class":444},[430,1129,1130],{"class":673}," 1",[430,1132,1133],{"class":747},"\u003C\u003C",[430,1135,1136],{"class":673},"20",[430,1138,479],{"class":444},[430,1140,1142],{"class":1141},"sJsHy"," \u002F\u002F 1 MiB\n",[430,1144,1145],{"class":432,"line":485},[430,1146,608],{"emptyLinePlaceholder":607},[430,1148,1149,1152,1154,1156,1158,1161,1163,1165,1167,1169],{"class":432,"line":517},[430,1150,1151],{"class":488},"decoder",[430,1153,567],{"class":566},[430,1155,964],{"class":488},[430,1157,456],{"class":444},[430,1159,1160],{"class":440},"NewDecoder",[430,1162,445],{"class":444},[430,1164,1098],{"class":488},[430,1166,456],{"class":444},[430,1168,1103],{"class":488},[430,1170,514],{"class":444},[430,1172,1173,1175,1177,1180],{"class":432,"line":604},[430,1174,1151],{"class":488},[430,1176,456],{"class":444},[430,1178,1179],{"class":440},"DisallowUnknownFields",[430,1181,577],{"class":444},[430,1183,1184],{"class":432,"line":611},[430,1185,608],{"emptyLinePlaceholder":607},[430,1187,1188,1191,1194],{"class":432,"line":632},[430,1189,1190],{"class":436},"var",[430,1192,1193],{"class":488}," input",[430,1195,1196],{"class":452}," CreateLessonRequest\n",[430,1198,1199,1202,1204,1206,1209,1211,1214,1216,1219,1222,1224,1226,1228,1230],{"class":432,"line":652},[430,1200,1201],{"class":725},"if",[430,1203,729],{"class":488},[430,1205,567],{"class":566},[430,1207,1208],{"class":488}," decoder",[430,1210,456],{"class":444},[430,1212,1213],{"class":440},"Decode",[430,1215,445],{"class":444},[430,1217,1218],{"class":436},"&",[430,1220,1221],{"class":488},"input",[430,1223,987],{"class":444},[430,1225,729],{"class":488},[430,1227,748],{"class":747},[430,1229,752],{"class":751},[430,1231,482],{"class":444},[430,1233,1234,1237,1239,1241,1243,1245,1247,1249,1252,1254,1256,1258,1260,1262],{"class":432,"line":665},[430,1235,1236],{"class":488},"    http",[430,1238,456],{"class":444},[430,1240,1054],{"class":440},[430,1242,445],{"class":444},[430,1244,449],{"class":488},[430,1246,462],{"class":444},[430,1248,504],{"class":503},[430,1250,1251],{"class":507},"invalid JSON",[430,1253,511],{"class":503},[430,1255,462],{"class":444},[430,1257,453],{"class":488},[430,1259,456],{"class":444},[430,1261,1076],{"class":488},[430,1263,514],{"class":444},[430,1265,1266],{"class":432,"line":689},[430,1267,1268],{"class":725},"    return\n",[430,1270,1271],{"class":432,"line":695},[430,1272,520],{"class":444},[390,1274,1276],{"id":1275},"make-a-client-request","Make a client request",[421,1278,1280],{"className":423,"code":1279,"language":425,"meta":426,"style":426},"client := &http.Client{Timeout: 10 * time.Second}\n\nreq, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil)\nif err != nil {\n    return err\n}\n\nresp, err := client.Do(req)\nif err != nil {\n    return err\n}\ndefer resp.Body.Close()\n",[412,1281,1282,1319,1323,1366,1378,1386,1390,1394,1419,1431,1437,1441],{"__ignoreMap":426},[430,1283,1284,1287,1289,1291,1293,1295,1298,1301,1304,1306,1309,1311,1313,1315,1317],{"class":432,"line":433},[430,1285,1286],{"class":488},"client",[430,1288,567],{"class":566},[430,1290,619],{"class":436},[430,1292,471],{"class":452},[430,1294,456],{"class":444},[430,1296,1297],{"class":452},"Client",[430,1299,1300],{"class":444},"{",[430,1302,1303],{"class":488},"Timeout",[430,1305,638],{"class":444},[430,1307,1308],{"class":673}," 10",[430,1310,468],{"class":436},[430,1312,679],{"class":488},[430,1314,456],{"class":444},[430,1316,684],{"class":488},[430,1318,520],{"class":444},[430,1320,1321],{"class":432,"line":485},[430,1322,608],{"emptyLinePlaceholder":607},[430,1324,1325,1328,1330,1332,1334,1336,1338,1341,1343,1346,1348,1350,1352,1355,1357,1360,1362,1364],{"class":432,"line":517},[430,1326,1327],{"class":488},"req",[430,1329,462],{"class":444},[430,1331,729],{"class":488},[430,1333,567],{"class":566},[430,1335,453],{"class":488},[430,1337,456],{"class":444},[430,1339,1340],{"class":440},"NewRequestWithContext",[430,1342,445],{"class":444},[430,1344,1345],{"class":488},"ctx",[430,1347,462],{"class":444},[430,1349,453],{"class":488},[430,1351,456],{"class":444},[430,1353,1354],{"class":488},"MethodGet",[430,1356,462],{"class":444},[430,1358,1359],{"class":488}," url",[430,1361,462],{"class":444},[430,1363,752],{"class":751},[430,1365,514],{"class":444},[430,1367,1368,1370,1372,1374,1376],{"class":432,"line":604},[430,1369,1201],{"class":725},[430,1371,729],{"class":488},[430,1373,748],{"class":747},[430,1375,752],{"class":751},[430,1377,482],{"class":444},[430,1379,1380,1383],{"class":432,"line":611},[430,1381,1382],{"class":725},"    return",[430,1384,1385],{"class":488}," err\n",[430,1387,1388],{"class":432,"line":632},[430,1389,520],{"class":444},[430,1391,1392],{"class":432,"line":652},[430,1393,608],{"emptyLinePlaceholder":607},[430,1395,1396,1399,1401,1403,1405,1408,1410,1413,1415,1417],{"class":432,"line":665},[430,1397,1398],{"class":488},"resp",[430,1400,462],{"class":444},[430,1402,729],{"class":488},[430,1404,567],{"class":566},[430,1406,1407],{"class":488}," client",[430,1409,456],{"class":444},[430,1411,1412],{"class":440},"Do",[430,1414,445],{"class":444},[430,1416,1327],{"class":488},[430,1418,514],{"class":444},[430,1420,1421,1423,1425,1427,1429],{"class":432,"line":689},[430,1422,1201],{"class":725},[430,1424,729],{"class":488},[430,1426,748],{"class":747},[430,1428,752],{"class":751},[430,1430,482],{"class":444},[430,1432,1433,1435],{"class":432,"line":695},[430,1434,1382],{"class":725},[430,1436,1385],{"class":488},[430,1438,1439],{"class":432,"line":700},[430,1440,520],{"class":444},[430,1442,1443,1446,1449,1451,1453,1455,1458],{"class":432,"line":722},[430,1444,1445],{"class":725},"defer",[430,1447,1448],{"class":488}," resp",[430,1450,456],{"class":444},[430,1452,1103],{"class":488},[430,1454,456],{"class":444},[430,1456,1457],{"class":440},"Close",[430,1459,577],{"class":444},[408,1461,1462],{},"Always close a successful response body. Check the status code before decoding the response.",[408,1464,1465],{},"Reuse clients instead of creating one for every request. A client manages connection pooling internally.",[390,1467,1469],{"id":1468},"graceful-shutdown","Graceful shutdown",[408,1471,1472],{},"When the process receives a shutdown signal, stop accepting new requests and give active requests time to finish:",[421,1474,1476],{"className":423,"code":1475,"language":425,"meta":426,"style":426},"ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)\ndefer cancel()\n\nif err := server.Shutdown(ctx); err != nil {\n    log.Println(\"shutdown:\", err)\n}\n",[412,1477,1478,1524,1532,1536,1565,1588],{"__ignoreMap":426},[430,1479,1480,1482,1484,1487,1489,1492,1494,1497,1499,1502,1504,1507,1510,1512,1515,1518,1520,1522],{"class":432,"line":433},[430,1481,1345],{"class":488},[430,1483,462],{"class":444},[430,1485,1486],{"class":488}," cancel",[430,1488,567],{"class":566},[430,1490,1491],{"class":488}," context",[430,1493,456],{"class":444},[430,1495,1496],{"class":440},"WithTimeout",[430,1498,445],{"class":444},[430,1500,1501],{"class":488},"context",[430,1503,456],{"class":444},[430,1505,1506],{"class":440},"Background",[430,1508,1509],{"class":444},"(),",[430,1511,1308],{"class":673},[430,1513,1514],{"class":436},"*",[430,1516,1517],{"class":488},"time",[430,1519,456],{"class":444},[430,1521,684],{"class":488},[430,1523,514],{"class":444},[430,1525,1526,1528,1530],{"class":432,"line":485},[430,1527,1445],{"class":725},[430,1529,1486],{"class":440},[430,1531,577],{"class":444},[430,1533,1534],{"class":432,"line":517},[430,1535,608],{"emptyLinePlaceholder":607},[430,1537,1538,1540,1542,1544,1546,1548,1551,1553,1555,1557,1559,1561,1563],{"class":432,"line":604},[430,1539,1201],{"class":725},[430,1541,729],{"class":488},[430,1543,567],{"class":566},[430,1545,734],{"class":488},[430,1547,456],{"class":444},[430,1549,1550],{"class":440},"Shutdown",[430,1552,445],{"class":444},[430,1554,1345],{"class":488},[430,1556,987],{"class":444},[430,1558,729],{"class":488},[430,1560,748],{"class":747},[430,1562,752],{"class":751},[430,1564,482],{"class":444},[430,1566,1567,1569,1571,1573,1575,1577,1580,1582,1584,1586],{"class":432,"line":611},[430,1568,703],{"class":488},[430,1570,456],{"class":444},[430,1572,708],{"class":440},[430,1574,445],{"class":444},[430,1576,511],{"class":503},[430,1578,1579],{"class":507},"shutdown:",[430,1581,511],{"class":503},[430,1583,462],{"class":444},[430,1585,729],{"class":488},[430,1587,514],{"class":444},[430,1589,1590],{"class":432,"line":632},[430,1591,520],{"class":444},[408,1593,1594],{},"Production shutdown code should also coordinate background goroutines and close owned resources.",[390,1596,1598],{"id":1597},"practice","Practice",[408,1600,1601],{},"Build an in-memory lesson API with:",[395,1603,1604,1610,1616,1619],{},[398,1605,1606,1609],{},[412,1607,1608],{},"GET \u002Flessons"," to return all lessons;",[398,1611,1612,1615],{},[412,1613,1614],{},"POST \u002Flessons"," to validate and add one lesson;",[398,1617,1618],{},"JSON responses and appropriate status codes;",[398,1620,1621],{},"a mutex protecting the shared slice.",[1623,1624,1625],"accordion",{},[1626,1627,1630,1631,1633],"accordion-item",{"icon":1628,"label":1629},"i-lucide-lightbulb","Show solution","Use a handler that validates method, size, content, and input; write headers before the body; and return stable errors. Configure server timeouts, propagate request contexts, and always close a successful client response body. Use ",[412,1632,1550],{}," with a bounded context.",[390,1635,1637],{"id":1636},"summary","Summary",[395,1639,1640,1643,1646],{},[398,1641,1642],{},"HTTP handlers translate transport details to domain operations.",[398,1644,1645],{},"Servers and clients need explicit size, time, and resource limits.",[398,1647,1648],{},"Graceful shutdown stops admission before waiting for active work.",[1650,1651],"learning-lesson-complete",{},[1653,1654],"learning-lesson-navigation",{"next":171,"nextTitle":170,"previous":161,"previousTitle":160},[1656,1657,1658],"style",{},"html pre.shiki code .sEOdo, html code.shiki .sEOdo{--shiki-light:#859900;--shiki-default:#89DDFF;--shiki-dark:#C678DD}html pre.shiki code .sisdC, html code.shiki .sisdC{--shiki-light:#268BD2;--shiki-default:#82AAFF;--shiki-dark:#61AFEF}html pre.shiki code .shFME, html code.shiki .shFME{--shiki-light:#657B83;--shiki-default:#89DDFF;--shiki-dark:#ABB2BF}html pre.shiki code .syre3, html code.shiki .syre3{--shiki-light:#657B83;--shiki-light-font-style:inherit;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#E06C75;--shiki-dark-font-style:italic}html pre.shiki code .snwKR, html code.shiki .snwKR{--shiki-light:#CB4B16;--shiki-default:#FFCB6B;--shiki-dark:#E5C07B}html pre.shiki code .s45-6, html code.shiki .s45-6{--shiki-light:#268BD2;--shiki-default:#EEFFFF;--shiki-dark:#E06C75}html pre.shiki code .sED5a, html code.shiki .sED5a{--shiki-light:#2AA198;--shiki-default:#89DDFF;--shiki-dark:#98C379}html pre.shiki code .sVazx, html code.shiki .sVazx{--shiki-light:#2AA198;--shiki-default:#C3E88D;--shiki-dark:#98C379}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .su2KV, html code.shiki .su2KV{--shiki-light:#859900;--shiki-default:#89DDFF;--shiki-dark:#E5C07B}html pre.shiki code .sAJzr, html code.shiki .sAJzr{--shiki-light:#D33682;--shiki-default:#F78C6C;--shiki-dark:#D19A66}html pre.shiki code .s7Bcg, html code.shiki .s7Bcg{--shiki-light:#859900;--shiki-light-font-style:inherit;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#C678DD;--shiki-dark-font-style:inherit}html pre.shiki code .sRBoR, html code.shiki .sRBoR{--shiki-light:#859900;--shiki-default:#89DDFF;--shiki-dark:#56B6C2}html pre.shiki code .sp8Z5, html code.shiki .sp8Z5{--shiki-light:#B58900;--shiki-default:#89DDFF;--shiki-dark:#D19A66}html pre.shiki code .sF6sA, html code.shiki .sF6sA{--shiki-light:#586E75;--shiki-light-font-weight:bold;--shiki-default:#C792EA;--shiki-default-font-weight:inherit;--shiki-dark:#C678DD;--shiki-dark-font-weight:inherit}html pre.shiki code .sJsHy, html code.shiki .sJsHy{--shiki-light:#93A1A1;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#7F848E;--shiki-dark-font-style:italic}",{"title":426,"searchDepth":485,"depth":485,"links":1660},[1661,1662,1663,1664,1665,1666,1667,1668,1669],{"id":392,"depth":485,"text":393},{"id":418,"depth":485,"text":419},{"id":540,"depth":485,"text":541},{"id":825,"depth":485,"text":826},{"id":1084,"depth":485,"text":1085},{"id":1275,"depth":485,"text":1276},{"id":1468,"depth":485,"text":1469},{"id":1597,"depth":485,"text":1598},{"id":1636,"depth":485,"text":1637},"Build a small HTTP server and call external services safely with net\u002Fhttp.","md",null,{},{"icon":168},{"description":1676,"title":165},"Learn Go net\u002Fhttp handlers, servers, clients, status codes, JSON responses, timeouts, and resource cleanup.","6788i_8_mSAxfkewWgWc2FaHYzMQlpWb3_jH-fOJ6mE",[1679,1681],{"title":160,"path":161,"stem":162,"description":1680,"icon":163,"children":-1},"Read and write files, stream data, and encode structured values as JSON.",{"title":170,"path":171,"stem":172,"description":1682,"icon":173,"children":-1},"Write table-driven tests, test HTTP handlers, use subtests, and understand useful test commands.",1794118100500]