_content: Doc index masonry layout
- converts existing doc index content into html sections - uses css columns to create css only masonry layout Video: https://drive.google.com/file/d/1VJ9IEz_mpVDhRXN6KPa7Z_z2oy4623an/view?usp=sharing Change-Id: Iad7413bad2ad5aaeff9dfc6334f206177508acc4 Reviewed-on: https://go-review.googlesource.com/c/website/+/443698 Run-TryBot: Jamal Carvalho <jamal@golang.org> Reviewed-by: Hyang-Ah Hana Kim <hyangah@gmail.com> Reviewed-by: Jamal Carvalho <jamal@golang.org> TryBot-Result: Gopher Robot <gobot@golang.org>
This commit is contained in:
Frederick Mixell
Jamal Carvalho
Родитель
dbe961f9e2
Коммит
d82958ec8a
|
|
@ -3878,12 +3878,30 @@ a.UseCase-anchorLink.selected::before {
|
||||||
img.PullQuote-image {
|
img.PullQuote-image {
|
||||||
width: 2.625rem;
|
width: 2.625rem;
|
||||||
}
|
}
|
||||||
|
.Masonry {
|
||||||
|
column-count: 1;
|
||||||
|
column-gap: 3.5rem;
|
||||||
|
row-gap: 3.5rem;
|
||||||
|
column-fill: balance;
|
||||||
|
}
|
||||||
.BigCard {
|
.BigCard {
|
||||||
border: var(--border);
|
border: var(--border);
|
||||||
border-radius: 0.25rem;
|
border-radius: 0.25rem;
|
||||||
padding: 0 1.75rem;
|
padding: 0 1.75rem;
|
||||||
|
padding-bottom: 1rem;
|
||||||
margin-bottom: 1.5rem;
|
margin-bottom: 1.5rem;
|
||||||
}
|
}
|
||||||
|
.Masonry .BigCard {
|
||||||
|
margin-bottom: unset;
|
||||||
|
margin-top: 1.5rem;
|
||||||
|
min-width: 33%;
|
||||||
|
height: max-content;
|
||||||
|
display: inline-block;
|
||||||
|
-webkit-column-break-inside: avoid;
|
||||||
|
page-break-inside: avoid;
|
||||||
|
break-inside: avoid;
|
||||||
|
width: 100%;
|
||||||
|
}
|
||||||
.BigCard h2 {
|
.BigCard h2 {
|
||||||
margin-top: 1.5rem;
|
margin-top: 1.5rem;
|
||||||
font-style: normal;
|
font-style: normal;
|
||||||
|
|
@ -3893,6 +3911,11 @@ img.PullQuote-image {
|
||||||
border-bottom: var(--border);
|
border-bottom: var(--border);
|
||||||
padding-bottom: 0.5rem;
|
padding-bottom: 0.5rem;
|
||||||
}
|
}
|
||||||
|
@media only screen and (min-width: 48rem) {
|
||||||
|
.Masonry {
|
||||||
|
column-count: 2;
|
||||||
|
}
|
||||||
|
}
|
||||||
.Card {
|
.Card {
|
||||||
background-color: var(--white);
|
background-color: var(--white);
|
||||||
border: var(--border);
|
border: var(--border);
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,7 @@
|
||||||
<!--{
|
<!--{
|
||||||
"Title": "Documentation",
|
"Title": "Documentation",
|
||||||
"Template": true
|
"Template": true,
|
||||||
|
"HideTOC": true
|
||||||
}-->
|
}-->
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
|
|
@ -18,51 +19,35 @@ fast, statically typed, compiled language that feels like a dynamically typed,
|
||||||
interpreted language.
|
interpreted language.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<div id="manual-nav"></div>
|
<div class="Masonry">
|
||||||
|
|
||||||
<h2 id="getting-started">Getting started</h2>
|
<section id="getting-started" class="BigCard">
|
||||||
|
|
||||||
|
<h2>Getting Started</h2>
|
||||||
|
|
||||||
<h3 id="installing"><a href="/doc/install">Installing Go</a></h3>
|
<h3 id="installing"><a href="/doc/install">Installing Go</a></h3>
|
||||||
<p>
|
<p>Instructions for downloading and installing Go.</p>
|
||||||
Instructions for downloading and installing Go.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h3 id="get-started-tutorial"><a href="/doc/tutorial/getting-started.html">Tutorial: Getting started</a></h3>
|
<h3 id="get-started-tutorial"><a href="/doc/tutorial/getting-started.html">Tutorial: Getting started</a></h3>
|
||||||
<p>
|
<p>A brief Hello, World tutorial to get started. Learn a bit about Go code, tools, packages, and modules.</p>
|
||||||
A brief Hello, World tutorial to get started. Learn a bit about Go code, tools, packages, and modules.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h3 id="create-module-tutorial"><a href="/doc/tutorial/create-module.html">Tutorial: Create a module</a></h3>
|
<h3 id="create-module-tutorial"><a href="/doc/tutorial/create-module.html">Tutorial: Create a module</a></h3>
|
||||||
<p>
|
<p>A tutorial of short topics introducing functions, error handling, arrays, maps, unit testing, and compiling.</p>
|
||||||
A tutorial of short topics introducing functions, error handling, arrays, maps, unit testing, and compiling.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h3 id="workspaces-tutorial"><a href="/doc/tutorial/workspaces.html">Tutorial: Getting started with multi-module workspaces</a></h3>
|
<h3 id="workspaces-tutorial"><a href="/doc/tutorial/workspaces.html">Tutorial: Getting started with multi-module workspaces</a></h3>
|
||||||
<p>
|
<p>Introduces the basics of creating and using multi-module workspaces in Go. Multi-module workspaces are useful for making changes across multiple modules.</p>
|
||||||
Introduces the basics of creating and using multi-module workspaces in Go.
|
|
||||||
Multi-module workspaces are useful for making changes across multiple modules.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h3 id="web-service-gin-tutorial"><a href="/doc/tutorial/web-service-gin.html">Tutorial: Developing a RESTful
|
<h3 id="web-service-gin-tutorial"><a href="/doc/tutorial/web-service-gin.html">Tutorial: Developing a RESTful API with Go and Gin</a></h3>
|
||||||
API with Go and Gin</a></h3>
|
<p>Introduces the basics of writing a RESTful web service API with Go and the Gin Web Framework.</p>
|
||||||
<p>
|
|
||||||
Introduces the basics of writing a RESTful web service API with Go and the Gin Web Framework.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h3 id="generics-tutorial"><a href="/doc/tutorial/generics.html">Tutorial: Getting started with generics</a></h3>
|
<h3 id="generics-tutorial"><a href="/doc/tutorial/generics.html">Tutorial: Getting started with generics</a></h3>
|
||||||
<p>
|
<p>With generics, you can declare and use functions or types that are written to work with any of a set of types provided by calling code.</p>
|
||||||
With generics, you can declare and use functions or types that are written to work with any of a set of types provided by calling code.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h3 id="fuzz-tutorial"><a href="/doc/tutorial/fuzz.html">Tutorial: Getting started with fuzzing</a></h3>
|
<h3 id="fuzz-tutorial"><a href="/doc/tutorial/fuzz.html">Tutorial: Getting started with fuzzing</a></h3>
|
||||||
<p>
|
<p>Fuzzing can generate inputs to your tests that can catch edge cases and security issues that you may have missed.</p>
|
||||||
Fuzzing can generate inputs to your tests that can catch edge cases and security issues that you may have missed.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h3 id="writing-web-applications"><a href="/doc/articles/wiki/">Writing Web Applications</a></h3>
|
<h3 id="writing-web-applications"><a href="/doc/articles/wiki/">Writing Web Applications</a></h3>
|
||||||
<p>
|
<p>Building a simple web application.</p>
|
||||||
Building a simple web application.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h3 id="code"><a href="code.html">How to write Go code</a></h3>
|
<h3 id="code"><a href="code.html">How to write Go code</a></h3>
|
||||||
<p>
|
<p>
|
||||||
|
|
@ -71,26 +56,34 @@ and it shows how to use the <a href="/cmd/go/"><code>go</code> command</a>
|
||||||
to build and test packages.
|
to build and test packages.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<img class="gopher" src="/doc/gopher/doc.png" alt=""/>
|
|
||||||
|
|
||||||
<h3 id="go_tour"><a href="/tour/">A Tour of Go</a></h3>
|
<h3 id="go_tour"><a href="/tour/">A Tour of Go</a></h3>
|
||||||
<p>
|
<p>
|
||||||
An interactive introduction to Go in three sections.
|
An interactive introduction to Go in three sections.
|
||||||
The first section covers basic syntax and data structures; the second discusses
|
The first section covers basic syntax and data structures; the second discusses
|
||||||
methods and interfaces; and the third introduces Go's concurrency primitives.
|
methods and interfaces; and the third introduces Go's concurrency primitives.
|
||||||
Each section concludes with a few exercises so you can practice what you've
|
Each section concludes with a few exercises so you can practice what you've
|
||||||
learned. You can <a href="/tour/">take the tour
|
learned. You can <a href="/tour/">take the tour online</a> or install it locally with:
|
||||||
online</a> or install it locally with:
|
|
||||||
</p>
|
</p>
|
||||||
<pre>
|
|
||||||
$ go install golang.org/x/website/tour@latest
|
<pre class="CopyPaste">
|
||||||
|
<span>$ go install golang.org/x/website/tour@latest</span>
|
||||||
|
<button aria-label="Copy and paste the code.">
|
||||||
|
<img class="CopyPaste-icon" src="/images/icons/copy-paste.svg" />
|
||||||
|
<img class="CopyPaste-icon CopyPaste-icon-dark" src="/images/icons/copy-paste-dark.svg" />
|
||||||
|
</button>
|
||||||
</pre>
|
</pre>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
This will place the <code>tour</code> binary in your
|
This will place the <code>tour</code> binary in your
|
||||||
<a href="/cmd/go/#hdr-GOPATH_and_Modules">GOPATH</a>'s <code>bin</code> directory.
|
<a href="/cmd/go/#hdr-GOPATH_and_Modules">GOPATH</a>'s <code>bin</code> directory.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<h2 id="learning">Using and understanding Go</h2>
|
</section>
|
||||||
|
|
||||||
|
|
||||||
|
<section id="learning" class="BigCard">
|
||||||
|
|
||||||
|
<h2>Using and understanding Go</h2>
|
||||||
|
|
||||||
<h3 id="effective_go"><a href="effective_go.html">Effective Go</a></h3>
|
<h3 id="effective_go"><a href="effective_go.html">Effective Go</a></h3>
|
||||||
<p>
|
<p>
|
||||||
|
|
@ -136,109 +129,12 @@ Main documentation page for profile-guided optimization (PGO) of Go applications
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<h3 id="data-access">Accessing databases</h3>
|
<h3 id="data-access">Accessing databases</h3>
|
||||||
|
</section>
|
||||||
|
|
||||||
<h4 id="data-access-tutorial"><a href="/doc/tutorial/database-access">Tutorial: Accessing a relational database</a></h4>
|
|
||||||
<p>
|
|
||||||
Introduces the basics of accessing a relational database using Go and the
|
|
||||||
<code>database/sql</code> package in the standard library.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h4 id="accessing-databases"><a href="/doc/database/index">Accessing relational databases</a></h4>
|
<section id="references" class="BigCard">
|
||||||
<p>
|
|
||||||
An overview of Go's data access features.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h4 id="open-handle"><a href="/doc/database/open-handle">Opening a database handle</a></h4>
|
<h2>References</h2>
|
||||||
<p>
|
|
||||||
You use the Go database handle to execute database operations. Once you open a
|
|
||||||
handle with database connection properties, the handle represents a connection
|
|
||||||
pool it manages on your behalf.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h4 id="change-data"><a href="/doc/database/change-data">Executing SQL statements that don't return data</a></h4>
|
|
||||||
<p>
|
|
||||||
For SQL operations that might change the database, including SQL
|
|
||||||
<code>INSERT</code>, <code>UPDATE</code>, and <code>DELETE</code>, you use
|
|
||||||
<code>Exec</code> methods.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h4 id="querying"><a href="/doc/database/querying">Querying for data</a></h4>
|
|
||||||
<p>
|
|
||||||
For <code>SELECT</code> statements that return data from a query, using the
|
|
||||||
<code>Query</code> or <code>QueryRow</code> method.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h4 id="prepared-statements"><a href="/doc/database/prepared-statements">Using prepared statements</a></h4>
|
|
||||||
<p>
|
|
||||||
Defining a prepared statement for repeated use can help your code run a bit
|
|
||||||
faster by avoiding the overhead of re-creating the statement each time your
|
|
||||||
code performs the database operation.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h4 id="execute-transactions"><a href="/doc/database/execute-transactions">Executing transactions</a></h4>
|
|
||||||
<p>
|
|
||||||
<code>sql.Tx</code> exports methods representing transaction-specific semantics,
|
|
||||||
including <code>Commit</code> and <code>Rollback</code>, as well as methods you
|
|
||||||
use to perform common database operations.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h4 id="cancel-operations"><a href="/doc/database/cancel-operations">Canceling in-progress database operations</a></h4>
|
|
||||||
<p>
|
|
||||||
Using <a href="https://pkg.go.dev/context#Context">context.Context</a>, you can
|
|
||||||
have your application's function calls and services stop working early and
|
|
||||||
return an error when their processing is no longer needed.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h4 id="manage-connections"><a href="/doc/database/manage-connections">Managing connections</a></h4>
|
|
||||||
<p>
|
|
||||||
For some advanced programs, you might need to tune connection pool parameters
|
|
||||||
or work with connections explicitly.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h4 id="sql-injection"><a href="/doc/database/sql-injection">Avoiding SQL injection risk</a></h4>
|
|
||||||
<p>
|
|
||||||
You can avoid an SQL injection risk by providing SQL parameter values as
|
|
||||||
<code>sql</code> package function arguments
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h3 id="developing-modules">Developing modules</h3>
|
|
||||||
|
|
||||||
<h4 id="modules-develop-publish"><a href="/doc/modules/developing">Developing and publishing modules</a></h4>
|
|
||||||
<p>
|
|
||||||
You can collect related packages into modules, then publish the modules for other developers to use. This topic gives an overview of developing and publishing modules.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h4 id="modules-release-workflow"><a href="/doc/modules/release-workflow">Module release and versioning workflow</a></h4>
|
|
||||||
<p>
|
|
||||||
When you develop modules for use by other developers, you can follow a workflow that helps ensure a reliable, consistent experience for developers using the module. This topic describes the high-level steps in that workflow.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h4 id="modules-managing-source"><a href="/doc/modules/managing-source">Managing module source</a></h4>
|
|
||||||
<p>
|
|
||||||
When you're developing modules to publish for others to use, you can help ensure that your modules are easier for other developers to use by following the repository conventions described in this topic.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h4 id="modules-major-version"><a href="/doc/modules/major-version">Developing a major version update</a></h4>
|
|
||||||
<p>
|
|
||||||
A major version update can be very disruptive to your module's users because it includes breaking changes and represents a new module. Learn more in this topic.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h4 id="modules-publishing"><a href="/doc/modules/publishing">Publishing a module</a></h4>
|
|
||||||
<p>
|
|
||||||
When you want to make a module available for other developers, you publish it so that it's visible to Go tools. Once you've published the module, developers importing its packages will be able to resolve a dependency on the module by running commands such as <code>go get</code>.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h4 id="modules-version-numbers"><a href="/doc/modules/version-numbers">Module version numbering</a></h4>
|
|
||||||
<p>
|
|
||||||
A module's developer uses each part of a module's version number to signal the version’s stability and backward compatibility. For each new release, a module's release version number specifically reflects the nature of the module's changes since the preceding release.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h3 id="faq"><a href="/doc/faq">Frequently Asked Questions (FAQ)</a></h3>
|
|
||||||
<p>
|
|
||||||
Answers to common questions about Go.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h2 id="references">References</h2>
|
|
||||||
|
|
||||||
<h3 id="pkg"><a href="/pkg/">Package Documentation</a></h3>
|
<h3 id="pkg"><a href="/pkg/">Package Documentation</a></h3>
|
||||||
<p>
|
<p>
|
||||||
|
|
@ -278,75 +174,128 @@ same variable in a different goroutine.
|
||||||
<h3 id="release"><a href="/doc/devel/release.html">Release History</a></h3>
|
<h3 id="release"><a href="/doc/devel/release.html">Release History</a></h3>
|
||||||
<p>A summary of the changes between Go releases.</p>
|
<p>A summary of the changes between Go releases.</p>
|
||||||
|
|
||||||
<h2 id="codewalks">Codewalks</h2>
|
</section>
|
||||||
|
|
||||||
|
|
||||||
|
<section id="data-access" class="BigCard">
|
||||||
|
|
||||||
|
<h2>Accessing databases</h2>
|
||||||
|
|
||||||
|
<h3 id="data-access-tutorial"><a href="/doc/tutorial/database-access">Tutorial: Accessing a relational database</a></h3>
|
||||||
<p>
|
<p>
|
||||||
Guided tours of Go programs.
|
Introduces the basics of accessing a relational database using Go and the
|
||||||
|
<code>database/sql</code> package in the standard library.
|
||||||
</p>
|
</p>
|
||||||
<ul>
|
|
||||||
<li><a href="/doc/codewalk/functions">First-Class Functions in Go</a></li>
|
|
||||||
<li><a href="/doc/codewalk/markov">Generating arbitrary text: a Markov chain algorithm</a></li>
|
|
||||||
<li><a href="/doc/codewalk/sharemem">Share Memory by Communicating</a></li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h2 id="blog">From the Go Blog</h2>
|
<h3 id="accessing-databases"><a href="/doc/database/index">Accessing relational databases</a></h3>
|
||||||
<p>The <a href="https://blog.golang.org/">official blog of the Go project</a>, featuring news and in-depth articles by
|
|
||||||
the Go team and guests.</p>
|
|
||||||
|
|
||||||
<h4>Language</h4>
|
|
||||||
<ul>
|
|
||||||
<li><a href="/blog/json-rpc-tale-of-interfaces">JSON-RPC: a tale of interfaces</a></li>
|
|
||||||
<li><a href="/blog/gos-declaration-syntax">Go's Declaration Syntax</a></li>
|
|
||||||
<li><a href="/blog/defer-panic-and-recover">Defer, Panic, and Recover</a></li>
|
|
||||||
<li><a href="/blog/go-concurrency-patterns-timing-out-and">Go Concurrency Patterns: Timing out, moving on</a></li>
|
|
||||||
<li><a href="/blog/go-slices-usage-and-internals">Go Slices: usage and internals</a></li>
|
|
||||||
<li><a href="/blog/gif-decoder-exercise-in-go-interfaces">A GIF decoder: an exercise in Go interfaces</a></li>
|
|
||||||
<li><a href="/blog/error-handling-and-go">Error Handling and Go</a></li>
|
|
||||||
<li><a href="/blog/organizing-go-code">Organizing Go code</a></li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h4>Packages</h4>
|
|
||||||
<ul>
|
|
||||||
<li><a href="/blog/json-and-go">JSON and Go</a> - using the <a href="/pkg/encoding/json/">json</a> package.</li>
|
|
||||||
<li><a href="/blog/gobs-of-data">Gobs of data</a> - the design and use of the <a href="/pkg/encoding/gob/">gob</a> package.</li>
|
|
||||||
<li><a href="/blog/laws-of-reflection">The Laws of Reflection</a> - the fundamentals of the <a href="/pkg/reflect/">reflect</a> package.</li>
|
|
||||||
<li><a href="/blog/go-image-package">The Go image package</a> - the fundamentals of the <a href="/pkg/image/">image</a> package.</li>
|
|
||||||
<li><a href="/blog/go-imagedraw-package">The Go image/draw package</a> - the fundamentals of the <a href="/pkg/image/draw/">image/draw</a> package.</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h4>Modules</h4>
|
|
||||||
<ul>
|
|
||||||
<li><a href="/blog/using-go-modules">Using Go Modules</a> - an introduction to using modules in a simple project.</li>
|
|
||||||
<li><a href="/blog/migrating-to-go-modules">Migrating to Go Modules</a> - converting an existing project to use modules.</li>
|
|
||||||
<li><a href="/blog/publishing-go-modules">Publishing Go Modules</a> - how to make new versions of modules available to others.</li>
|
|
||||||
<li><a href="/blog/v2-go-modules">Go Modules: v2 and Beyond</a> - creating and publishing major versions 2 and higher.</li>
|
|
||||||
<li><a href="/blog/module-compatibility">Keeping Your Modules Compatible</a> - how to keep your modules compatible with prior minor/patch versions.</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h4>Tools</h4>
|
|
||||||
<ul>
|
|
||||||
<li><a href="/doc/articles/go_command.html">About the Go command</a> - why we wrote it, what it is, what it's not, and how to use it.</li>
|
|
||||||
<li><a href="/doc/comment">Go Doc Comments</a> - writing good program documentation</li>
|
|
||||||
<li><a href="/doc/gdb">Debugging Go Code with GDB</a></li>
|
|
||||||
<li><a href="/doc/articles/race_detector.html">Data Race Detector</a> - a manual for the data race detector.</li>
|
|
||||||
<li><a href="/doc/asm">A Quick Guide to Go's Assembler</a> - an introduction to the assembler used by Go.</li>
|
|
||||||
<li><a href="/blog/c-go-cgo">C? Go? Cgo!</a> - linking against C code with <a href="/cmd/cgo/">cgo</a>.</li>
|
|
||||||
<li><a href="/blog/profiling-go-programs">Profiling Go Programs</a></li>
|
|
||||||
<li><a href="/blog/race-detector">Introducing the Go Race Detector</a> - an introduction to the race detector.</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h2 id="wiki">Wiki</h2>
|
|
||||||
<p>
|
<p>
|
||||||
The <a href="/wiki">Go Wiki</a>, maintained by the Go community, includes articles about the Go language, tools, and other resources.
|
An overview of Go's data access features.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p id="learn_more">
|
<h3 id="open-handle"><a href="/doc/database/open-handle">Opening a database handle</a></h3>
|
||||||
See the <a href="/wiki/Learn">Learn</a> page at the <a href="/wiki">Wiki</a>
|
<p>
|
||||||
for more Go learning resources.
|
You use the Go database handle to execute database operations. Once you open a
|
||||||
|
handle with database connection properties, the handle represents a connection
|
||||||
|
pool it manages on your behalf.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<h2 id="talks">Talks</h2>
|
<h3 id="change-data"><a href="/doc/database/change-data">Executing SQL statements that don't return data</a></h3>
|
||||||
|
<p>
|
||||||
|
For SQL operations that might change the database, including SQL
|
||||||
|
<code>INSERT</code>, <code>UPDATE</code>, and <code>DELETE</code>, you use
|
||||||
|
<code>Exec</code> methods.
|
||||||
|
</p>
|
||||||
|
|
||||||
<img class="gopher" src="/doc/gopher/talks.png" alt=""/>
|
<h3 id="querying"><a href="/doc/database/querying">Querying for data</a></h3>
|
||||||
|
<p>
|
||||||
|
For <code>SELECT</code> statements that return data from a query, using the
|
||||||
|
<code>Query</code> or <code>QueryRow</code> method.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3 id="prepared-statements"><a href="/doc/database/prepared-statements">Using prepared statements</a></h3>
|
||||||
|
<p>
|
||||||
|
Defining a prepared statement for repeated use can help your code run a bit
|
||||||
|
faster by avoiding the overhead of re-creating the statement each time your
|
||||||
|
code performs the database operation.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3 id="execute-transactions"><a href="/doc/database/execute-transactions">Executing transactions</a></h3>
|
||||||
|
<p>
|
||||||
|
<code>sql.Tx</code> exports methods representing transaction-specific semantics,
|
||||||
|
including <code>Commit</code> and <code>Rollback</code>, as well as methods you
|
||||||
|
use to perform common database operations.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3 id="cancel-operations"><a href="/doc/database/cancel-operations">Canceling in-progress database operations</a></h3>
|
||||||
|
<p>
|
||||||
|
Using <a href="https://pkg.go.dev/context#Context">context.Context</a>, you can
|
||||||
|
have your application's function calls and services stop working early and
|
||||||
|
return an error when their processing is no longer needed.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3 id="manage-connections"><a href="/doc/database/manage-connections">Managing connections</a></h3>
|
||||||
|
<p>
|
||||||
|
For some advanced programs, you might need to tune connection pool parameters
|
||||||
|
or work with connections explicitly.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3 id="sql-injection"><a href="/doc/database/sql-injection">Avoiding SQL injection risk</a></h3>
|
||||||
|
<p>
|
||||||
|
You can avoid an SQL injection risk by providing SQL parameter values as
|
||||||
|
<code>sql</code> package function arguments
|
||||||
|
</p>
|
||||||
|
|
||||||
|
</section>
|
||||||
|
|
||||||
|
|
||||||
|
<section id="developing-modules" class="BigCard">
|
||||||
|
|
||||||
|
<h2>Developing modules</h2>
|
||||||
|
|
||||||
|
<h3 id="modules-develop-publish"><a href="/doc/modules/developing">Developing and publishing modules</a></h3>
|
||||||
|
<p>
|
||||||
|
You can collect related packages into modules, then publish the modules for other developers to use. This topic gives an overview of developing and publishing modules.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3 id="modules-release-workflow"><a href="/doc/modules/release-workflow">Module release and versioning workflow</a></h3>
|
||||||
|
<p>
|
||||||
|
When you develop modules for use by other developers, you can follow a workflow that helps ensure a reliable, consistent experience for developers using the module. This topic describes the high-level steps in that workflow.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3 id="modules-managing-source"><a href="/doc/modules/managing-source">Managing module source</a></h3>
|
||||||
|
<p>
|
||||||
|
When you're developing modules to publish for others to use, you can help ensure that your modules are easier for other developers to use by following the repository conventions described in this topic.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3 id="modules-major-version"><a href="/doc/modules/major-version">Developing a major version update</a></h3>
|
||||||
|
<p>
|
||||||
|
A major version update can be very disruptive to your module's users because it includes breaking changes and represents a new module. Learn more in this topic.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3 id="modules-publishing"><a href="/doc/modules/publishing">Publishing a module</a></h3>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
When you want to make a module available for other developers, you publish it so that it's visible to Go tools. Once you've published the module, developers importing its packages will be able to resolve a dependency on the module by running commands such as <code>go get</code>.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3 id="modules-version-numbers"><a href="/doc/modules/version-numbers">Module version numbering</a></h3>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
A module's developer uses each part of a module's version number to signal the version’s stability and backward compatibility. For each new release, a module's release version number specifically reflects the nature of the module's changes since the preceding release.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3 id="faq"><a href="/doc/faq">Frequently Asked Questions (FAQ)</a></h3>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Answers to common questions about Go.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
</section>
|
||||||
|
|
||||||
|
|
||||||
|
<section id="talks" class="BigCard">
|
||||||
|
|
||||||
|
<h2>Talks</h2>
|
||||||
|
|
||||||
<h3 id="video_tour_of_go"><a href="https://research.swtch.com/gotour">A Video Tour of Go</a></h3>
|
<h3 id="video_tour_of_go"><a href="https://research.swtch.com/gotour">A Video Tour of Go</a></h3>
|
||||||
<p>
|
<p>
|
||||||
|
|
@ -375,10 +324,91 @@ This talk expands on the <i>Go Concurrency Patterns</i> talk to dive deeper into
|
||||||
See the <a href="/talks">Go Talks site</a> and <a href="/wiki/GoTalks">wiki page</a> for more Go talks.
|
See the <a href="/talks">Go Talks site</a> and <a href="/wiki/GoTalks">wiki page</a> for more Go talks.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<h2 id="nonenglish">Non-English Documentation</h2>
|
</section>
|
||||||
|
|
||||||
|
|
||||||
|
<section id="codewalks" class="BigCard">
|
||||||
|
|
||||||
|
<h2>Codewalks</h2>
|
||||||
<p>
|
<p>
|
||||||
|
Guided tours of Go programs.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li><a href="/doc/codewalk/functions">First-Class Functions in Go</a></li>
|
||||||
|
<li><a href="/doc/codewalk/markov">Generating arbitrary text: a Markov chain algorithm</a></li>
|
||||||
|
<li><a href="/doc/codewalk/sharemem">Share Memory by Communicating</a></li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<h3>Language</h3>
|
||||||
|
<ul>
|
||||||
|
<li><a href="/blog/json-rpc-tale-of-interfaces">JSON-RPC: a tale of interfaces</a></li>
|
||||||
|
<li><a href="/blog/gos-declaration-syntax">Go's Declaration Syntax</a></li>
|
||||||
|
<li><a href="/blog/defer-panic-and-recover">Defer, Panic, and Recover</a></li>
|
||||||
|
<li><a href="/blog/go-concurrency-patterns-timing-out-and">Go Concurrency Patterns: Timing out, moving on</a></li>
|
||||||
|
<li><a href="/blog/go-slices-usage-and-internals">Go Slices: usage and internals</a></li>
|
||||||
|
<li><a href="/blog/gif-decoder-exercise-in-go-interfaces">A GIF decoder: an exercise in Go interfaces</a></li>
|
||||||
|
<li><a href="/blog/error-handling-and-go">Error Handling and Go</a></li>
|
||||||
|
<li><a href="/blog/organizing-go-code">Organizing Go code</a></li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<h3>Packages</h3>
|
||||||
|
<ul>
|
||||||
|
<li><a href="/blog/json-and-go">JSON and Go</a> - using the <a href="/pkg/encoding/json/">json</a> package.</li>
|
||||||
|
<li><a href="/blog/gobs-of-data">Gobs of data</a> - the design and use of the <a href="/pkg/encoding/gob/">gob</a> package.</li>
|
||||||
|
<li><a href="/blog/laws-of-reflection">The Laws of Reflection</a> - the fundamentals of the <a href="/pkg/reflect/">reflect</a> package.</li>
|
||||||
|
<li><a href="/blog/go-image-package">The Go image package</a> - the fundamentals of the <a href="/pkg/image/">image</a> package.</li>
|
||||||
|
<li><a href="/blog/go-imagedraw-package">The Go image/draw package</a> - the fundamentals of the <a href="/pkg/image/draw/">image/draw</a> package.</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<h3>Modules</h3>
|
||||||
|
<ul>
|
||||||
|
<li><a href="/blog/using-go-modules">Using Go Modules</a> - an introduction to using modules in a simple project.</li>
|
||||||
|
<li><a href="/blog/migrating-to-go-modules">Migrating to Go Modules</a> - converting an existing project to use modules.</li>
|
||||||
|
<li><a href="/blog/publishing-go-modules">Publishing Go Modules</a> - how to make new versions of modules available to others.</li>
|
||||||
|
<li><a href="/blog/v2-go-modules">Go Modules: v2 and Beyond</a> - creating and publishing major versions 2 and higher.</li>
|
||||||
|
<li><a href="/blog/module-compatibility">Keeping Your Modules Compatible</a> - how to keep your modules compatible with prior minor/patch versions.</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<h3>Tools</h3>
|
||||||
|
<ul>
|
||||||
|
<li><a href="/doc/articles/go_command.html">About the Go command</a> - why we wrote it, what it is, what it's not, and how to use it.</li>
|
||||||
|
<li><a href="/doc/comment">Go Doc Comments</a> - writing good program documentation</li>
|
||||||
|
<li><a href="/doc/gdb">Debugging Go Code with GDB</a></li>
|
||||||
|
<li><a href="/doc/articles/race_detector.html">Data Race Detector</a> - a manual for the data race detector.</li>
|
||||||
|
<li><a href="/doc/asm">A Quick Guide to Go's Assembler</a> - an introduction to the assembler used by Go.</li>
|
||||||
|
<li><a href="/blog/c-go-cgo">C? Go? Cgo!</a> - linking against C code with <a href="/cmd/cgo/">cgo</a>.</li>
|
||||||
|
<li><a href="/blog/profiling-go-programs">Profiling Go Programs</a></li>
|
||||||
|
<li><a href="/blog/race-detector">Introducing the Go Race Detector</a> - an introduction to the race detector.</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
</section>
|
||||||
|
|
||||||
|
|
||||||
|
<section id="wiki" class="BigCard">
|
||||||
|
|
||||||
|
<h2>Wiki</h2>
|
||||||
|
<p>
|
||||||
|
The <a href="/wiki">Go Wiki</a>, maintained by the Go community, includes articles about the Go language, tools, and other resources.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p id="learn_more">
|
||||||
|
See the <a href="/wiki/Learn">Learn</a> page at the <a href="/wiki">Wiki</a>
|
||||||
|
for more Go learning resources.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
</section>
|
||||||
|
|
||||||
|
|
||||||
|
<section id="nonenglish" class="BigCard">
|
||||||
|
|
||||||
|
<h2>Non-English Documentation</h2>
|
||||||
See the <a href="/wiki/NonEnglish">NonEnglish</a> page
|
See the <a href="/wiki/NonEnglish">NonEnglish</a> page
|
||||||
at the <a href="/wiki">Wiki</a> for localized
|
at the <a href="/wiki">Wiki</a> for localized
|
||||||
documentation.
|
documentation.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
</section>
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
|
||||||
Загрузка…
Ссылка в новой задаче