├── .gitignore ├── .history ├── CONTRIBUTING.md ├── LICENSE ├── README.md ├── _sphinx ├── exts │ ├── includecode.py │ └── includecode2.py ├── pygments │ ├── setup.py │ └── styles │ │ ├── __init__.py │ │ └── simple.py ├── static │ ├── akka-intellij-code-style.jar │ ├── akka.png │ ├── favicon.ico │ └── logo.png └── themes │ └── akka │ ├── layout.html │ ├── static │ ├── akka_full_color.svg │ ├── akka_icon_full_color.svg │ ├── akka_icon_reverse.svg │ ├── akka_reverse.svg │ ├── base.css │ ├── contentsFix.js │ ├── docs.css │ ├── effects.core.js │ ├── effects.highlight.js │ ├── ga.js │ ├── highlightCode.js │ ├── jquery.js │ ├── logo-small.png │ ├── pdf-icon.png │ ├── pdf-java-icon.png │ ├── pdf-scala-icon.png │ ├── prettify.css │ ├── prettify.js │ ├── scrollTo.js │ ├── search.jpg │ ├── style.css │ ├── toc.js │ ├── warnOldDocs.js │ └── watermark.png │ └── theme.conf ├── build.sbt ├── rst ├── additional │ ├── books.rst │ ├── code │ │ └── docs │ │ │ ├── faq │ │ │ └── Faq.scala │ │ │ └── osgi │ │ │ ├── Activator.scala │ │ │ └── blueprint.xml │ ├── faq.rst │ ├── index.rst │ └── osgi.rst ├── common │ ├── binary-compatibility-rules.rst │ ├── circuitbreaker.rst │ ├── cluster.rst │ ├── code │ │ └── docs │ │ │ ├── circuitbreaker │ │ │ ├── CircuitBreakerDocSpec.scala │ │ │ ├── DangerousJavaActor.java │ │ │ └── TellPatternJavaActor.java │ │ │ └── duration │ │ │ ├── Java.java │ │ │ └── Sample.scala │ └── duration.rst ├── conf.py ├── dev │ ├── building-akka.rst │ ├── developer-guidelines.rst │ ├── documentation.rst │ ├── index.rst │ ├── io-layer.rst │ ├── multi-jvm-testing.rst │ └── multi-node-testing.rst ├── experimental │ ├── index-java.rst │ └── index.rst ├── general │ ├── ActorPath.png │ ├── RemoteDeployment.png │ ├── actor-systems.rst │ ├── actors.rst │ ├── addressing.rst │ ├── code │ │ └── docs │ │ │ └── config │ │ │ ├── ConfigDoc.java │ │ │ └── ConfigDocSpec.scala │ ├── configuration.rst │ ├── guardians.png │ ├── index.rst │ ├── jmm.rst │ ├── message-delivery-reliability.rst │ ├── remoting.rst │ ├── stream │ │ ├── stream-configuration.rst │ │ └── stream-design.rst │ ├── supervision.rst │ └── terminology.rst ├── images │ ├── actor_lifecycle.png │ ├── actor_lifecycle.svg │ ├── akka-http-file-listing.png │ ├── akka-remote-testconductor.png │ ├── association_lifecycle.png │ ├── association_lifecycle.svg │ ├── asyncBoundary.png │ ├── benchmark-akka-sample-trading-throughput.png │ ├── build-path.png │ ├── camel-pubsub.png │ ├── camel-pubsub2.png │ ├── circuit-breaker-states.dot │ ├── circuit-breaker-states.png │ ├── clojure-trees.png │ ├── compose_attributes.png │ ├── compose_composites.png │ ├── compose_graph.png │ ├── compose_graph_flow.png │ ├── compose_graph_partial.png │ ├── compose_graph_shape.png │ ├── compose_mat.png │ ├── compose_nested_flow.png │ ├── compose_nested_flow_opaque.png │ ├── compose_shapes.png │ ├── composition.png │ ├── composition.svg │ ├── diagnostics-window.png │ ├── example-code.png │ ├── faulttolerancesample-failure-flow.png │ ├── faulttolerancesample-normal-flow.png │ ├── faulttolerancesample.graffle │ ├── graph_stage_chain.png │ ├── graph_stage_chain.svg │ ├── graph_stage_conceptual.png │ ├── graph_stage_conceptual.svg │ ├── graph_stage_detached_tracks_1.png │ ├── graph_stage_detached_tracks_1.svg │ ├── graph_stage_detached_tracks_2.png │ ├── graph_stage_detached_tracks_2.svg │ ├── graph_stage_diagrams.graffle │ ├── graph_stage_duplicate.png │ ├── graph_stage_duplicate.svg │ ├── graph_stage_filter.png │ ├── graph_stage_filter.svg │ ├── graph_stage_map.png │ ├── graph_stage_map.svg │ ├── graph_stage_tracks_1.png │ ├── graph_stage_tracks_1.svg │ ├── import-project.png │ ├── inport_transitions.png │ ├── install-beta2-updatesite.png │ ├── member-states-weakly-up.png │ ├── member-states.drawing │ ├── member-states.png │ ├── member-states.svg │ ├── more.png │ ├── outport_transitions.png │ ├── persistence-detach-models.graffle │ ├── persistence-detach-models.png │ ├── persistence-detach-models.svg │ ├── persistence-drop-event-serializer.graffle │ ├── persistence-drop-event-serializer.png │ ├── persistence-drop-event-serializer.svg │ ├── persistence-drop-event.graffle │ ├── persistence-drop-event.png │ ├── persistence-drop-event.svg │ ├── persistence-event-adapter-1-n.graffle │ ├── persistence-event-adapter-1-n.png │ ├── persistence-event-adapter-1-n.svg │ ├── persistence-manual-rename.graffle │ ├── persistence-manual-rename.png │ ├── persistence-serializer-rename.graffle │ ├── persistence-serializer-rename.png │ ├── persistence-serializer-rename.svg │ ├── persistent-message-envelope.graffle │ ├── persistent-message-envelope.png │ ├── persistent-message-envelope.svg │ ├── phi1.png │ ├── phi2.png │ ├── phi3.png │ ├── pi-formula.png │ ├── port_transitions.svg │ ├── quickfix.png │ ├── run-config.png │ ├── simple-graph-example.png │ ├── tcp-message-protocol.graffle │ ├── tcp-message-protocol_bind-connect-maxed-out.svg │ ├── tcp-message-protocol_binding.svg │ ├── tcp-message-protocol_closing.svg │ ├── tcp-message-protocol_establishing-incoming.svg │ ├── tcp-message-protocol_establishing-outgoing.svg │ ├── tcp-message-protocol_noticing-close.svg │ ├── tcp-message-protocol_receiving.svg │ ├── tcp-message-protocol_unbinding.svg │ ├── tcp-message-protocol_writing.svg │ ├── tcp-stream-bind.png │ ├── tcp-stream-bind.svg │ ├── tcp-stream-run.png │ └── tcp-stream-run.svg ├── index.rst ├── intro │ ├── deployment-scenarios.rst │ ├── getting-started.rst │ ├── index-java.rst │ ├── index-scala.rst │ ├── use-cases.rst │ ├── what-is-akka.rst │ └── why-akka.rst ├── java.rst ├── java │ ├── agents.rst │ ├── camel.rst │ ├── cluster-client.rst │ ├── cluster-metrics.rst │ ├── cluster-sharding.rst │ ├── cluster-singleton.rst │ ├── cluster-usage.rst │ ├── code │ │ └── docs │ │ │ ├── AbstractJavaTest.scala │ │ │ ├── actor │ │ │ ├── ActorDocTest.java │ │ │ ├── ByteBufferSerializerDocTest.java │ │ │ ├── FSMDocTest.java │ │ │ ├── FaultHandlingTest.java │ │ │ ├── FaultHandlingTestJava8.java │ │ │ ├── FirstUntypedActor.java │ │ │ ├── ImmutableMessage.java │ │ │ ├── InboxDocTest.java │ │ │ ├── InitializationDocSpecJava.java │ │ │ ├── InitializationDocTest.java │ │ │ ├── Messages.java │ │ │ ├── MyBoundedUntypedActor.java │ │ │ ├── MyJavaActor.java │ │ │ ├── MyReceiveTimeoutUntypedActor.java │ │ │ ├── MyStoppingActor.java │ │ │ ├── MyUntypedActor.java │ │ │ ├── SampleActor.java │ │ │ ├── SampleActorTest.java │ │ │ ├── SchedulerDocTest.java │ │ │ ├── TypedActorDocTest.java │ │ │ ├── UntypedActorDocTest.java │ │ │ ├── UntypedActorSwapper.java │ │ │ ├── fsm │ │ │ │ ├── Buncher.java │ │ │ │ ├── BuncherTest.java │ │ │ │ ├── Events.java │ │ │ │ └── FSMDocTest.java │ │ │ └── japi │ │ │ │ ├── FaultHandlingDocSample.java │ │ │ │ └── FaultHandlingDocSampleJava8.java │ │ │ ├── actorlambda │ │ │ ├── ActorDocTest.java │ │ │ ├── FaultHandlingTest.java │ │ │ ├── InitializationDocTest.java │ │ │ ├── Messages.java │ │ │ ├── MyActor.java │ │ │ ├── SampleActor.java │ │ │ ├── SampleActorTest.java │ │ │ ├── fsm │ │ │ │ ├── Buncher.java │ │ │ │ ├── BuncherTest.java │ │ │ │ ├── Events.java │ │ │ │ └── FSMDocTest.java │ │ │ └── japi │ │ │ │ └── FaultHandlingDocSample.java │ │ │ ├── agent │ │ │ ├── AgentDocJavaSpec.scala │ │ │ └── AgentDocTest.java │ │ │ ├── camel │ │ │ ├── ActivationTestBase.java │ │ │ ├── CamelExtensionTest.java │ │ │ ├── Consumer1.java │ │ │ ├── Consumer2.java │ │ │ ├── Consumer3.java │ │ │ ├── Consumer4.java │ │ │ ├── CustomRouteBuilder.java │ │ │ ├── CustomRouteTestBase.java │ │ │ ├── ErrorThrowingConsumer.java │ │ │ ├── FirstProducer.java │ │ │ ├── Forwarder.java │ │ │ ├── MyActor.java │ │ │ ├── MyEndpoint.java │ │ │ ├── OnRouteResponseTestBase.java │ │ │ ├── OnewaySender.java │ │ │ ├── Orders.java │ │ │ ├── Producer1.java │ │ │ ├── ProducerTestBase.java │ │ │ ├── RequestBodyActor.java │ │ │ ├── Responder.java │ │ │ ├── ResponseReceiver.java │ │ │ └── Transformer.java │ │ │ ├── cluster │ │ │ └── ClusterDocTest.java │ │ │ ├── ddata │ │ │ ├── DataBot.java │ │ │ ├── DistributedDataDocTest.java │ │ │ └── japi │ │ │ │ ├── TwoPhaseSet.java │ │ │ │ └── protobuf │ │ │ │ ├── TwoPhaseSetSerializer.java │ │ │ │ ├── TwoPhaseSetSerializer2.java │ │ │ │ └── TwoPhaseSetSerializerWithCompression.java │ │ │ ├── dispatcher │ │ │ ├── DispatcherDocTest.java │ │ │ ├── MyUnboundedJMailbox.java │ │ │ └── MyUnboundedJMessageQueueSemantics.java │ │ │ ├── event │ │ │ ├── EventBusDocTest.java │ │ │ └── LoggingDocTest.java │ │ │ ├── extension │ │ │ ├── ExtensionDocTest.java │ │ │ └── SettingsExtensionDocTest.java │ │ │ ├── future │ │ │ └── FutureDocTest.java │ │ │ ├── http │ │ │ └── javadsl │ │ │ │ ├── HttpClientExampleDocTest.java │ │ │ │ ├── HttpsExamplesDocTest.java │ │ │ │ ├── ModelDocTest.java │ │ │ │ ├── WebSocketClientExampleTest.java │ │ │ │ └── server │ │ │ │ ├── FormFieldRequestValsExampleTest.java │ │ │ │ ├── HeaderRequestValsExampleTest.java │ │ │ │ ├── HighLevelServerBindFailureExample.java │ │ │ │ ├── HighLevelServerExample.java │ │ │ │ ├── HttpBasicAuthenticatorExample.java │ │ │ │ ├── HttpServerExampleDocTest.java │ │ │ │ ├── HttpsServerExampleTest.java │ │ │ │ ├── JsonStreamingExamplesTest.java │ │ │ │ ├── OAuth2AuthenticatorExample.java │ │ │ │ ├── PathDirectiveExampleTest.java │ │ │ │ ├── WebSocketCoreExample.java │ │ │ │ ├── WebSocketRoutingExample.java │ │ │ │ ├── directives │ │ │ │ ├── BasicDirectivesExamplesTest.java │ │ │ │ ├── CodingDirectivesExamplesTest.java │ │ │ │ ├── CookieDirectivesExamplesTest.java │ │ │ │ ├── CustomDirectivesExamplesTest.java │ │ │ │ ├── CustomHttpMethodExamplesTest.java │ │ │ │ ├── DebuggingDirectivesExamplesTest.java │ │ │ │ ├── ExecutionDirectivesExamplesTest.java │ │ │ │ ├── FileAndResourceDirectivesExamplesTest.java │ │ │ │ ├── FileUploadDirectivesExamplesTest.java │ │ │ │ ├── FormFieldDirectivesExamplesTest.java │ │ │ │ ├── FutureDirectivesExamplesTest.java │ │ │ │ ├── HeaderDirectivesExamplesTest.java │ │ │ │ ├── HostDirectivesExamplesTest.java │ │ │ │ ├── MethodDirectivesExamplesTest.java │ │ │ │ ├── MiscDirectivesExamplesTest.java │ │ │ │ ├── ParameterDirectivesExamplesTest.java │ │ │ │ ├── PathDirectivesExamplesTest.java │ │ │ │ ├── RangeDirectivesExamplesTest.java │ │ │ │ ├── RespondWithDirectivesExamplesTest.java │ │ │ │ ├── RouteDirectivesExamplesTest.java │ │ │ │ ├── SchemeDirectivesExamplesTest.java │ │ │ │ ├── SecurityDirectivesExamplesTest.java │ │ │ │ ├── TimeoutDirectivesExamplesTest.java │ │ │ │ └── WebSocketDirectivesExamplesTest.java │ │ │ │ └── testkit │ │ │ │ ├── MyAppService.java │ │ │ │ └── TestkitExampleTest.java │ │ │ ├── io │ │ │ ├── IODocTest.java │ │ │ ├── JavaReadBackPressure.java │ │ │ ├── JavaUdpMulticast.java │ │ │ ├── JavaUdpMulticastTest.java │ │ │ ├── UdpConnectedDocTest.java │ │ │ ├── UdpDocTest.java │ │ │ └── japi │ │ │ │ ├── EchoHandler.java │ │ │ │ ├── EchoManager.java │ │ │ │ ├── EchoServer.java │ │ │ │ ├── IODocTest.java │ │ │ │ ├── Message.java │ │ │ │ ├── SimpleEchoHandler.java │ │ │ │ └── Watcher.java │ │ │ ├── jrouting │ │ │ ├── ConsistentHashingRouterDocTest.java │ │ │ ├── CustomRouterDocTest.java │ │ │ ├── RedundancyGroup.java │ │ │ └── RouterDocTest.java │ │ │ ├── pattern │ │ │ ├── BackoffSupervisorDocTest.java │ │ │ ├── JavaTemplate.java │ │ │ ├── SchedulerPatternTest.java │ │ │ ├── SupervisedAsk.java │ │ │ └── SupervisedAskSpec.java │ │ │ ├── persistence │ │ │ ├── LambdaPersistenceDocTest.java │ │ │ ├── LambdaPersistencePluginDocTest.java │ │ │ ├── PersistenceDocTest.java │ │ │ ├── PersistenceEventAdapterDocTest.java │ │ │ ├── PersistenceMultiDocTest.java │ │ │ ├── PersistencePluginDocTest.java │ │ │ ├── PersistenceQueryDocTest.java │ │ │ ├── PersistenceSchemaEvolutionDocTest.java │ │ │ └── query │ │ │ │ ├── LeveldbPersistenceQueryDocTest.java │ │ │ │ └── MyEventsByTagJavaPublisher.java │ │ │ ├── remoting │ │ │ └── RemoteDeploymentDocTest.java │ │ │ ├── serialization │ │ │ └── SerializationDocTest.java │ │ │ ├── stream │ │ │ ├── ActorPublisherDocTest.java │ │ │ ├── ActorSubscriberDocTest.java │ │ │ ├── BidiFlowDocTest.java │ │ │ ├── CompositionDocTest.java │ │ │ ├── FlowDocTest.java │ │ │ ├── FlowErrorDocTest.java │ │ │ ├── FlowParallelismDocTest.java │ │ │ ├── GraphCyclesDocTest.java │ │ │ ├── GraphDSLDocTest.java │ │ │ ├── GraphStageDocTest.java │ │ │ ├── HubDocTest.java │ │ │ ├── IntegrationDocTest.java │ │ │ ├── KillSwitchDocTest.java │ │ │ ├── MigrationsJava.java │ │ │ ├── QuickStartDocTest.java │ │ │ ├── RateTransformationDocTest.java │ │ │ ├── ReactiveStreamsDocTest.java │ │ │ ├── SilenceSystemOut.java │ │ │ ├── StreamBuffersRateDocTest.java │ │ │ ├── StreamPartialGraphDSLDocTest.java │ │ │ ├── StreamTestKitDocTest.java │ │ │ ├── TwitterStreamQuickstartDocTest.java │ │ │ ├── io │ │ │ │ ├── StreamFileDocTest.java │ │ │ │ └── StreamTcpDocTest.java │ │ │ └── javadsl │ │ │ │ └── cookbook │ │ │ │ ├── RecipeByteStrings.java │ │ │ │ ├── RecipeDigest.java │ │ │ │ ├── RecipeDroppyBroadcast.java │ │ │ │ ├── RecipeFlattenList.java │ │ │ │ ├── RecipeGlobalRateLimit.java │ │ │ │ ├── RecipeHold.java │ │ │ │ ├── RecipeKeepAlive.java │ │ │ │ ├── RecipeLoggingElements.java │ │ │ │ ├── RecipeManualTrigger.java │ │ │ │ ├── RecipeMissedTicks.java │ │ │ │ ├── RecipeMultiGroupByTest.java │ │ │ │ ├── RecipeParseLines.java │ │ │ │ ├── RecipeReduceByKeyTest.java │ │ │ │ ├── RecipeSeq.java │ │ │ │ ├── RecipeSimpleDrop.java │ │ │ │ ├── RecipeTest.java │ │ │ │ └── RecipeWorkerPool.java │ │ │ ├── testkit │ │ │ ├── ParentChildTest.java │ │ │ ├── TestKitDocTest.java │ │ │ └── TestKitSampleTest.java │ │ │ └── util │ │ │ └── SocketUtils.java │ ├── dispatchers.rst │ ├── distributed-data.rst │ ├── distributed-pub-sub.rst │ ├── event-bus.rst │ ├── extending-akka.rst │ ├── fault-tolerance-sample.rst │ ├── fault-tolerance.rst │ ├── fsm.rst │ ├── futures.rst │ ├── hello-world.rst │ ├── howto.rst │ ├── http │ │ ├── client-side │ │ │ ├── client-https-support.rst │ │ │ ├── connection-level.rst │ │ │ ├── host-level.rst │ │ │ ├── index.rst │ │ │ ├── request-level.rst │ │ │ └── websocket-support.rst │ │ ├── common │ │ │ ├── de-coding.rst │ │ │ ├── index.rst │ │ │ ├── json-support.rst │ │ │ ├── marshalling.rst │ │ │ ├── timeouts.rst │ │ │ └── unmarshalling.rst │ │ ├── configuration.rst │ │ ├── http-model.rst │ │ ├── implications-of-streaming-http-entity.rst │ │ ├── index.rst │ │ ├── routing-dsl │ │ │ ├── directives │ │ │ │ ├── alphabetically.rst │ │ │ │ ├── basic-directives │ │ │ │ │ ├── cancelRejection.rst │ │ │ │ │ ├── cancelRejections.rst │ │ │ │ │ ├── extract.rst │ │ │ │ │ ├── extractActorSystem.rst │ │ │ │ │ ├── extractDataBytes.rst │ │ │ │ │ ├── extractExecutionContext.rst │ │ │ │ │ ├── extractLog.rst │ │ │ │ │ ├── extractMaterializer.rst │ │ │ │ │ ├── extractRequest.rst │ │ │ │ │ ├── extractRequestContext.rst │ │ │ │ │ ├── extractRequestEntity.rst │ │ │ │ │ ├── extractSettings.rst │ │ │ │ │ ├── extractStrictEntity.rst │ │ │ │ │ ├── extractUnmatchedPath.rst │ │ │ │ │ ├── extractUri.rst │ │ │ │ │ ├── index.rst │ │ │ │ │ ├── mapInnerRoute.rst │ │ │ │ │ ├── mapRejections.rst │ │ │ │ │ ├── mapRequest.rst │ │ │ │ │ ├── mapRequestContext.rst │ │ │ │ │ ├── mapResponse.rst │ │ │ │ │ ├── mapResponseEntity.rst │ │ │ │ │ ├── mapResponseHeaders.rst │ │ │ │ │ ├── mapRouteResult.rst │ │ │ │ │ ├── mapRouteResultFuture.rst │ │ │ │ │ ├── mapRouteResultPF.rst │ │ │ │ │ ├── mapRouteResultWith.rst │ │ │ │ │ ├── mapRouteResultWithPF.rst │ │ │ │ │ ├── mapSettings.rst │ │ │ │ │ ├── mapUnmatchedPath.rst │ │ │ │ │ ├── pass.rst │ │ │ │ │ ├── provide.rst │ │ │ │ │ ├── recoverRejections.rst │ │ │ │ │ ├── recoverRejectionsWith.rst │ │ │ │ │ ├── toStrictEntity.rst │ │ │ │ │ ├── withExecutionContext.rst │ │ │ │ │ ├── withLog.rst │ │ │ │ │ ├── withMaterializer.rst │ │ │ │ │ └── withSettings.rst │ │ │ │ ├── by-trait.rst │ │ │ │ ├── cache-condition-directives │ │ │ │ │ ├── conditional.rst │ │ │ │ │ └── index.rst │ │ │ │ ├── coding-directives │ │ │ │ │ ├── decodeRequest.rst │ │ │ │ │ ├── decodeRequestWith.rst │ │ │ │ │ ├── encodeResponse.rst │ │ │ │ │ ├── encodeResponseWith.rst │ │ │ │ │ ├── index.rst │ │ │ │ │ ├── requestEncodedWith.rst │ │ │ │ │ └── responseEncodingAccepted.rst │ │ │ │ ├── cookie-directives │ │ │ │ │ ├── cookie.rst │ │ │ │ │ ├── deleteCookie.rst │ │ │ │ │ ├── index.rst │ │ │ │ │ ├── optionalCookie.rst │ │ │ │ │ └── setCookie.rst │ │ │ │ ├── custom-directives.rst │ │ │ │ ├── debugging-directives │ │ │ │ │ ├── index.rst │ │ │ │ │ ├── logRequest.rst │ │ │ │ │ ├── logRequestResult.rst │ │ │ │ │ └── logResult.rst │ │ │ │ ├── execution-directives │ │ │ │ │ ├── handleExceptions.rst │ │ │ │ │ ├── handleRejections.rst │ │ │ │ │ └── index.rst │ │ │ │ ├── file-and-resource-directives │ │ │ │ │ ├── getFromBrowseableDirectories.rst │ │ │ │ │ ├── getFromBrowseableDirectory.rst │ │ │ │ │ ├── getFromDirectory.rst │ │ │ │ │ ├── getFromFile.rst │ │ │ │ │ ├── getFromResource.rst │ │ │ │ │ ├── getFromResourceDirectory.rst │ │ │ │ │ ├── index.rst │ │ │ │ │ └── listDirectoryContents.rst │ │ │ │ ├── file-upload-directives │ │ │ │ │ ├── fileUpload.rst │ │ │ │ │ ├── index.rst │ │ │ │ │ └── uploadedFile.rst │ │ │ │ ├── form-field-directives │ │ │ │ │ ├── formField.rst │ │ │ │ │ ├── formFieldList.rst │ │ │ │ │ ├── formFieldMap.rst │ │ │ │ │ ├── formFieldMultiMap.rst │ │ │ │ │ └── index.rst │ │ │ │ ├── future-directives │ │ │ │ │ ├── completeOrRecoverWith.rst │ │ │ │ │ ├── index.rst │ │ │ │ │ ├── onComplete.rst │ │ │ │ │ ├── onCompleteWithBreaker.rst │ │ │ │ │ └── onSuccess.rst │ │ │ │ ├── header-directives │ │ │ │ │ ├── checkSameOrigin.rst │ │ │ │ │ ├── headerValue.rst │ │ │ │ │ ├── headerValueByName.rst │ │ │ │ │ ├── headerValueByType.rst │ │ │ │ │ ├── headerValuePF.rst │ │ │ │ │ ├── index.rst │ │ │ │ │ ├── optionalHeaderValue.rst │ │ │ │ │ ├── optionalHeaderValueByName.rst │ │ │ │ │ ├── optionalHeaderValueByType.rst │ │ │ │ │ └── optionalHeaderValuePF.rst │ │ │ │ ├── host-directives │ │ │ │ │ ├── extractHostName.rst │ │ │ │ │ ├── host.rst │ │ │ │ │ └── index.rst │ │ │ │ ├── index.rst │ │ │ │ ├── marshalling-directives │ │ │ │ │ ├── completeWith.rst │ │ │ │ │ ├── entity.rst │ │ │ │ │ ├── handleWith.rst │ │ │ │ │ └── index.rst │ │ │ │ ├── method-directives │ │ │ │ │ ├── delete.rst │ │ │ │ │ ├── extractMethod.rst │ │ │ │ │ ├── get.rst │ │ │ │ │ ├── head.rst │ │ │ │ │ ├── index.rst │ │ │ │ │ ├── method.rst │ │ │ │ │ ├── options.rst │ │ │ │ │ ├── overrideMethodWithParameter.rst │ │ │ │ │ ├── patch.rst │ │ │ │ │ ├── post.rst │ │ │ │ │ └── put.rst │ │ │ │ ├── misc-directives │ │ │ │ │ ├── extractClientIP.rst │ │ │ │ │ ├── index.rst │ │ │ │ │ ├── rejectEmptyResponse.rst │ │ │ │ │ ├── requestEntityEmpty.rst │ │ │ │ │ ├── requestEntityPresent.rst │ │ │ │ │ ├── selectPreferredLanguage.rst │ │ │ │ │ ├── validate.rst │ │ │ │ │ ├── withSizeLimit.rst │ │ │ │ │ └── withoutSizeLimit.rst │ │ │ │ ├── parameter-directives │ │ │ │ │ ├── index.rst │ │ │ │ │ ├── parameter.rst │ │ │ │ │ ├── parameterMap.rst │ │ │ │ │ ├── parameterMultiMap.rst │ │ │ │ │ ├── parameterSeq.rst │ │ │ │ │ └── parameters.rst │ │ │ │ ├── path-directives.rst │ │ │ │ ├── path-directives │ │ │ │ │ ├── index.rst │ │ │ │ │ ├── path.rst │ │ │ │ │ ├── pathEnd.rst │ │ │ │ │ ├── pathEndOrSingleSlash.rst │ │ │ │ │ ├── pathPrefix.rst │ │ │ │ │ ├── pathPrefixTest.rst │ │ │ │ │ ├── pathSingleSlash.rst │ │ │ │ │ ├── pathSuffix.rst │ │ │ │ │ ├── pathSuffixTest.rst │ │ │ │ │ ├── rawPathPrefix.rst │ │ │ │ │ ├── rawPathPrefixTest.rst │ │ │ │ │ ├── redirectToNoTrailingSlashIfPresent.rst │ │ │ │ │ └── redirectToTrailingSlashIfMissing.rst │ │ │ │ ├── range-directives │ │ │ │ │ ├── index.rst │ │ │ │ │ └── withRangeSupport.rst │ │ │ │ ├── respond-with-directives │ │ │ │ │ ├── index.rst │ │ │ │ │ ├── respondWithDefaultHeader.rst │ │ │ │ │ ├── respondWithDefaultHeaders.rst │ │ │ │ │ ├── respondWithHeader.rst │ │ │ │ │ └── respondWithHeaders.rst │ │ │ │ ├── route-directives │ │ │ │ │ ├── complete.rst │ │ │ │ │ ├── failWith.rst │ │ │ │ │ ├── index.rst │ │ │ │ │ ├── redirect.rst │ │ │ │ │ └── reject.rst │ │ │ │ ├── scheme-directives │ │ │ │ │ ├── extractScheme.rst │ │ │ │ │ ├── index.rst │ │ │ │ │ └── scheme.rst │ │ │ │ ├── security-directives │ │ │ │ │ ├── authenticateBasic.rst │ │ │ │ │ ├── authenticateBasicAsync.rst │ │ │ │ │ ├── authenticateBasicPF.rst │ │ │ │ │ ├── authenticateBasicPFAsync.rst │ │ │ │ │ ├── authenticateOAuth2.rst │ │ │ │ │ ├── authenticateOAuth2Async.rst │ │ │ │ │ ├── authenticateOAuth2PF.rst │ │ │ │ │ ├── authenticateOAuth2PFAsync.rst │ │ │ │ │ ├── authenticateOrRejectWithChallenge.rst │ │ │ │ │ ├── authorize.rst │ │ │ │ │ ├── authorizeAsync.rst │ │ │ │ │ ├── extractCredentials.rst │ │ │ │ │ └── index.rst │ │ │ │ ├── timeout-directives │ │ │ │ │ ├── index.rst │ │ │ │ │ ├── withRequestTimeout.rst │ │ │ │ │ ├── withRequestTimeoutResponse.rst │ │ │ │ │ └── withoutRequestTimeout.rst │ │ │ │ └── websocket-directives │ │ │ │ │ ├── handleWebSocketMessages.rst │ │ │ │ │ ├── handleWebSocketMessagesForProtocol.rst │ │ │ │ │ └── index.rst │ │ │ ├── exception-handling.rst │ │ │ ├── index.rst │ │ │ ├── marshalling.rst │ │ │ ├── overview.rst │ │ │ ├── rejections.rst │ │ │ ├── routes.rst │ │ │ ├── source-streaming-support.rst │ │ │ └── testkit.rst │ │ ├── server-side-https-support.rst │ │ └── server-side │ │ │ ├── low-level-server-side-api.rst │ │ │ └── websocket-support.rst │ ├── index-actors.rst │ ├── index-futures.rst │ ├── index-network.rst │ ├── index-utilities.rst │ ├── io-tcp.rst │ ├── io-udp.rst │ ├── io.rst │ ├── lambda-actors.rst │ ├── lambda-fault-tolerance-sample.rst │ ├── lambda-fault-tolerance.rst │ ├── lambda-fsm.rst │ ├── lambda-index-actors.rst │ ├── lambda-persistence.rst │ ├── logging.rst │ ├── mailboxes.rst │ ├── persistence-query-leveldb.rst │ ├── persistence-query.rst │ ├── persistence-schema-evolution.rst │ ├── persistence.rst │ ├── remoting-artery.rst │ ├── remoting.rst │ ├── routing.rst │ ├── scheduler.rst │ ├── serialization.rst │ ├── stream │ │ ├── index.rst │ │ ├── migration-guide-1.0-2.x-java.rst │ │ ├── migration-guide-2.0-2.4-java.rst │ │ ├── stages-overview.rst │ │ ├── stream-composition.rst │ │ ├── stream-cookbook.rst │ │ ├── stream-customize.rst │ │ ├── stream-dynamic.rst │ │ ├── stream-error.rst │ │ ├── stream-flows-and-basics.rst │ │ ├── stream-graphs.rst │ │ ├── stream-integrations.rst │ │ ├── stream-introduction.rst │ │ ├── stream-io.rst │ │ ├── stream-parallelism.rst │ │ ├── stream-quickstart.rst │ │ ├── stream-rate.rst │ │ └── stream-testkit.rst │ ├── testing.rst │ ├── typed-actors.rst │ └── untyped-actors.rst ├── locale │ └── ja │ │ └── LC_MESSAGES │ │ ├── additional │ │ ├── books.po │ │ ├── faq.po │ │ ├── index.po │ │ ├── language-bindings.po │ │ └── osgi.po │ │ ├── common │ │ ├── binary-compatibility-rules.po │ │ ├── circuitbreaker.po │ │ ├── cluster.po │ │ └── duration.po │ │ ├── dev │ │ ├── building-akka.po │ │ ├── developer-guidelines.po │ │ ├── documentation.po │ │ ├── index.po │ │ ├── io-layer.po │ │ ├── multi-jvm-testing.po │ │ └── multi-node-testing.po │ │ ├── experimental │ │ ├── index-java.po │ │ └── index.po │ │ ├── general │ │ ├── actor-systems.po │ │ ├── actors.po │ │ ├── addressing.po │ │ ├── configuration.po │ │ ├── index.po │ │ ├── jmm.po │ │ ├── message-delivery-reliability.po │ │ ├── remoting.po │ │ ├── stream │ │ │ ├── stream-configuration.po │ │ │ └── stream-design.po │ │ ├── supervision.po │ │ └── terminology.po │ │ ├── index.po │ │ ├── intro │ │ ├── deployment-scenarios.po │ │ ├── getting-started.po │ │ ├── index-java.po │ │ ├── index-scala.po │ │ ├── use-cases.po │ │ ├── what-is-akka.po │ │ └── why-akka.po │ │ ├── java.po │ │ ├── java │ │ ├── agents.po │ │ ├── camel.po │ │ ├── cluster-client.po │ │ ├── cluster-metrics.po │ │ ├── cluster-sharding.po │ │ ├── cluster-singleton.po │ │ ├── cluster-usage.po │ │ ├── dispatchers.po │ │ ├── distributed-data.po │ │ ├── distributed-pub-sub.po │ │ ├── event-bus.po │ │ ├── extending-akka.po │ │ ├── fault-tolerance-sample.po │ │ ├── fault-tolerance.po │ │ ├── fsm.po │ │ ├── futures.po │ │ ├── hello-world.po │ │ ├── howto.po │ │ ├── http │ │ │ ├── client-side │ │ │ │ ├── client-https-support.po │ │ │ │ ├── connection-level.po │ │ │ │ ├── host-level.po │ │ │ │ ├── index.po │ │ │ │ ├── request-level.po │ │ │ │ └── websocket-support.po │ │ │ ├── common │ │ │ │ ├── de-coding.po │ │ │ │ ├── index.po │ │ │ │ ├── json-support.po │ │ │ │ ├── marshalling.po │ │ │ │ ├── timeouts.po │ │ │ │ └── unmarshalling.po │ │ │ ├── configuration.po │ │ │ ├── http-model.po │ │ │ ├── implications-of-streaming-http-entity.po │ │ │ ├── index.po │ │ │ ├── routing-dsl │ │ │ │ ├── directives │ │ │ │ │ ├── alphabetically.po │ │ │ │ │ ├── basic-directives │ │ │ │ │ │ ├── cancelRejection.po │ │ │ │ │ │ ├── cancelRejections.po │ │ │ │ │ │ ├── extract.po │ │ │ │ │ │ ├── extractActorSystem.po │ │ │ │ │ │ ├── extractDataBytes.po │ │ │ │ │ │ ├── extractExecutionContext.po │ │ │ │ │ │ ├── extractLog.po │ │ │ │ │ │ ├── extractMaterializer.po │ │ │ │ │ │ ├── extractRequest.po │ │ │ │ │ │ ├── extractRequestContext.po │ │ │ │ │ │ ├── extractRequestEntity.po │ │ │ │ │ │ ├── extractSettings.po │ │ │ │ │ │ ├── extractStrictEntity.po │ │ │ │ │ │ ├── extractUnmatchedPath.po │ │ │ │ │ │ ├── extractUri.po │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ ├── mapInnerRoute.po │ │ │ │ │ │ ├── mapRejections.po │ │ │ │ │ │ ├── mapRequest.po │ │ │ │ │ │ ├── mapRequestContext.po │ │ │ │ │ │ ├── mapResponse.po │ │ │ │ │ │ ├── mapResponseEntity.po │ │ │ │ │ │ ├── mapResponseHeaders.po │ │ │ │ │ │ ├── mapRouteResult.po │ │ │ │ │ │ ├── mapRouteResultFuture.po │ │ │ │ │ │ ├── mapRouteResultPF.po │ │ │ │ │ │ ├── mapRouteResultWith.po │ │ │ │ │ │ ├── mapRouteResultWithPF.po │ │ │ │ │ │ ├── mapSettings.po │ │ │ │ │ │ ├── mapUnmatchedPath.po │ │ │ │ │ │ ├── pass.po │ │ │ │ │ │ ├── provide.po │ │ │ │ │ │ ├── recoverRejections.po │ │ │ │ │ │ ├── recoverRejectionsWith.po │ │ │ │ │ │ ├── toStrictEntity.po │ │ │ │ │ │ ├── withExecutionContext.po │ │ │ │ │ │ ├── withLog.po │ │ │ │ │ │ ├── withMaterializer.po │ │ │ │ │ │ └── withSettings.po │ │ │ │ │ ├── by-trait.po │ │ │ │ │ ├── cache-condition-directives │ │ │ │ │ │ ├── conditional.po │ │ │ │ │ │ └── index.po │ │ │ │ │ ├── coding-directives │ │ │ │ │ │ ├── decodeRequest.po │ │ │ │ │ │ ├── decodeRequestWith.po │ │ │ │ │ │ ├── encodeResponse.po │ │ │ │ │ │ ├── encodeResponseWith.po │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ ├── requestEncodedWith.po │ │ │ │ │ │ └── responseEncodingAccepted.po │ │ │ │ │ ├── cookie-directives │ │ │ │ │ │ ├── cookie.po │ │ │ │ │ │ ├── deleteCookie.po │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ ├── optionalCookie.po │ │ │ │ │ │ └── setCookie.po │ │ │ │ │ ├── custom-directives.po │ │ │ │ │ ├── debugging-directives │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ ├── logRequest.po │ │ │ │ │ │ ├── logRequestResult.po │ │ │ │ │ │ └── logResult.po │ │ │ │ │ ├── execution-directives │ │ │ │ │ │ ├── handleExceptions.po │ │ │ │ │ │ ├── handleRejections.po │ │ │ │ │ │ └── index.po │ │ │ │ │ ├── file-and-resource-directives │ │ │ │ │ │ ├── getFromBrowseableDirectories.po │ │ │ │ │ │ ├── getFromBrowseableDirectory.po │ │ │ │ │ │ ├── getFromDirectory.po │ │ │ │ │ │ ├── getFromFile.po │ │ │ │ │ │ ├── getFromResource.po │ │ │ │ │ │ ├── getFromResourceDirectory.po │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ └── listDirectoryContents.po │ │ │ │ │ ├── file-upload-directives │ │ │ │ │ │ ├── fileUpload.po │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ └── uploadedFile.po │ │ │ │ │ ├── form-field-directives │ │ │ │ │ │ ├── formField.po │ │ │ │ │ │ ├── formFieldList.po │ │ │ │ │ │ ├── formFieldMap.po │ │ │ │ │ │ ├── formFieldMultiMap.po │ │ │ │ │ │ └── index.po │ │ │ │ │ ├── future-directives │ │ │ │ │ │ ├── completeOrRecoverWith.po │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ ├── onComplete.po │ │ │ │ │ │ ├── onCompleteWithBreaker.po │ │ │ │ │ │ └── onSuccess.po │ │ │ │ │ ├── header-directives │ │ │ │ │ │ ├── checkSameOrigin.po │ │ │ │ │ │ ├── headerValue.po │ │ │ │ │ │ ├── headerValueByName.po │ │ │ │ │ │ ├── headerValueByType.po │ │ │ │ │ │ ├── headerValuePF.po │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ ├── optionalHeaderValue.po │ │ │ │ │ │ ├── optionalHeaderValueByName.po │ │ │ │ │ │ ├── optionalHeaderValueByType.po │ │ │ │ │ │ └── optionalHeaderValuePF.po │ │ │ │ │ ├── host-directives │ │ │ │ │ │ ├── extractHostName.po │ │ │ │ │ │ ├── host.po │ │ │ │ │ │ └── index.po │ │ │ │ │ ├── index.po │ │ │ │ │ ├── marshalling-directives │ │ │ │ │ │ ├── completeWith.po │ │ │ │ │ │ ├── entity.po │ │ │ │ │ │ ├── handleWith.po │ │ │ │ │ │ └── index.po │ │ │ │ │ ├── method-directives │ │ │ │ │ │ ├── delete.po │ │ │ │ │ │ ├── extractMethod.po │ │ │ │ │ │ ├── get.po │ │ │ │ │ │ ├── head.po │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ ├── method.po │ │ │ │ │ │ ├── options.po │ │ │ │ │ │ ├── overrideMethodWithParameter.po │ │ │ │ │ │ ├── patch.po │ │ │ │ │ │ ├── post.po │ │ │ │ │ │ └── put.po │ │ │ │ │ ├── misc-directives │ │ │ │ │ │ ├── extractClientIP.po │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ ├── rejectEmptyResponse.po │ │ │ │ │ │ ├── requestEntityEmpty.po │ │ │ │ │ │ ├── requestEntityPresent.po │ │ │ │ │ │ ├── selectPreferredLanguage.po │ │ │ │ │ │ ├── validate.po │ │ │ │ │ │ ├── withSizeLimit.po │ │ │ │ │ │ └── withoutSizeLimit.po │ │ │ │ │ ├── parameter-directives │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ ├── parameter.po │ │ │ │ │ │ ├── parameterMap.po │ │ │ │ │ │ ├── parameterMultiMap.po │ │ │ │ │ │ ├── parameterSeq.po │ │ │ │ │ │ └── parameters.po │ │ │ │ │ ├── path-directives.po │ │ │ │ │ ├── path-directives │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ ├── path.po │ │ │ │ │ │ ├── pathEnd.po │ │ │ │ │ │ ├── pathEndOrSingleSlash.po │ │ │ │ │ │ ├── pathPrefix.po │ │ │ │ │ │ ├── pathPrefixTest.po │ │ │ │ │ │ ├── pathSingleSlash.po │ │ │ │ │ │ ├── pathSuffix.po │ │ │ │ │ │ ├── pathSuffixTest.po │ │ │ │ │ │ ├── rawPathPrefix.po │ │ │ │ │ │ ├── rawPathPrefixTest.po │ │ │ │ │ │ ├── redirectToNoTrailingSlashIfPresent.po │ │ │ │ │ │ └── redirectToTrailingSlashIfMissing.po │ │ │ │ │ ├── range-directives │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ └── withRangeSupport.po │ │ │ │ │ ├── respond-with-directives │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ ├── respondWithDefaultHeader.po │ │ │ │ │ │ ├── respondWithDefaultHeaders.po │ │ │ │ │ │ ├── respondWithHeader.po │ │ │ │ │ │ └── respondWithHeaders.po │ │ │ │ │ ├── route-directives │ │ │ │ │ │ ├── complete.po │ │ │ │ │ │ ├── failWith.po │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ ├── redirect.po │ │ │ │ │ │ └── reject.po │ │ │ │ │ ├── scheme-directives │ │ │ │ │ │ ├── extractScheme.po │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ └── scheme.po │ │ │ │ │ ├── security-directives │ │ │ │ │ │ ├── authenticateBasic.po │ │ │ │ │ │ ├── authenticateBasicAsync.po │ │ │ │ │ │ ├── authenticateBasicPF.po │ │ │ │ │ │ ├── authenticateBasicPFAsync.po │ │ │ │ │ │ ├── authenticateOAuth2.po │ │ │ │ │ │ ├── authenticateOAuth2Async.po │ │ │ │ │ │ ├── authenticateOAuth2PF.po │ │ │ │ │ │ ├── authenticateOAuth2PFAsync.po │ │ │ │ │ │ ├── authenticateOrRejectWithChallenge.po │ │ │ │ │ │ ├── authorize.po │ │ │ │ │ │ ├── authorizeAsync.po │ │ │ │ │ │ ├── extractCredentials.po │ │ │ │ │ │ └── index.po │ │ │ │ │ ├── timeout-directives │ │ │ │ │ │ ├── index.po │ │ │ │ │ │ ├── withRequestTimeout.po │ │ │ │ │ │ ├── withRequestTimeoutResponse.po │ │ │ │ │ │ └── withoutRequestTimeout.po │ │ │ │ │ └── websocket-directives │ │ │ │ │ │ ├── handleWebSocketMessages.po │ │ │ │ │ │ ├── handleWebSocketMessagesForProtocol.po │ │ │ │ │ │ └── index.po │ │ │ │ ├── exception-handling.po │ │ │ │ ├── index.po │ │ │ │ ├── marshalling.po │ │ │ │ ├── overview.po │ │ │ │ ├── rejections.po │ │ │ │ ├── routes.po │ │ │ │ ├── source-streaming-support.po │ │ │ │ └── testkit.po │ │ │ ├── server-side-https-support.po │ │ │ └── server-side │ │ │ │ ├── low-level-server-side-api.po │ │ │ │ └── websocket-support.po │ │ ├── index-actors.po │ │ ├── index-futures.po │ │ ├── index-network.po │ │ ├── index-utilities.po │ │ ├── io-tcp.po │ │ ├── io-udp.po │ │ ├── io.po │ │ ├── lambda-actors.po │ │ ├── lambda-fault-tolerance-sample.po │ │ ├── lambda-fault-tolerance.po │ │ ├── lambda-fsm.po │ │ ├── lambda-index-actors.po │ │ ├── lambda-persistence.po │ │ ├── logging.po │ │ ├── mailboxes.po │ │ ├── persistence-query-leveldb.po │ │ ├── persistence-query.po │ │ ├── persistence-schema-evolution.po │ │ ├── persistence.po │ │ ├── remoting-artery.po │ │ ├── remoting.po │ │ ├── routing.po │ │ ├── scheduler.po │ │ ├── serialization.po │ │ ├── stream │ │ │ ├── index.po │ │ │ ├── migration-guide-1.0-2.x-java.po │ │ │ ├── migration-guide-2.0-2.4-java.po │ │ │ ├── stages-overview.po │ │ │ ├── stream-composition.po │ │ │ ├── stream-cookbook.po │ │ │ ├── stream-customize.po │ │ │ ├── stream-dynamic.po │ │ │ ├── stream-error.po │ │ │ ├── stream-flows-and-basics.po │ │ │ ├── stream-graphs.po │ │ │ ├── stream-integrations.po │ │ │ ├── stream-introduction.po │ │ │ ├── stream-io.po │ │ │ ├── stream-parallelism.po │ │ │ ├── stream-quickstart.po │ │ │ ├── stream-rate.po │ │ │ └── stream-testkit.po │ │ ├── testing.po │ │ ├── typed-actors.po │ │ └── untyped-actors.po │ │ ├── project │ │ ├── index.po │ │ ├── issue-tracking.po │ │ ├── licenses.po │ │ ├── links.po │ │ ├── migration-guide-1.3.x-2.0.x.po │ │ ├── migration-guide-2.0.x-2.1.x.po │ │ ├── migration-guide-2.1.x-2.2.x.po │ │ ├── migration-guide-2.2.x-2.3.x.po │ │ ├── migration-guide-2.3.x-2.4.x.po │ │ ├── migration-guide-2.4.x-2.5.x.po │ │ ├── migration-guide-eventsourced-2.3.x.po │ │ ├── migration-guide-persistence-experimental-2.3.x-2.4.x.po │ │ ├── migration-guides.po │ │ └── sponsors.po │ │ ├── scala.po │ │ └── scala │ │ ├── actordsl.po │ │ ├── actors.po │ │ ├── agents.po │ │ ├── camel.po │ │ ├── cluster-client.po │ │ ├── cluster-metrics.po │ │ ├── cluster-sharding.po │ │ ├── cluster-singleton.po │ │ ├── cluster-usage.po │ │ ├── dispatchers.po │ │ ├── distributed-data.po │ │ ├── distributed-pub-sub.po │ │ ├── event-bus.po │ │ ├── extending-akka.po │ │ ├── fault-tolerance-sample.po │ │ ├── fault-tolerance.po │ │ ├── fsm.po │ │ ├── futures.po │ │ ├── hello-world.po │ │ ├── howto.po │ │ ├── http │ │ ├── client-side │ │ │ ├── client-https-support.po │ │ │ ├── connection-level.po │ │ │ ├── host-level.po │ │ │ ├── index.po │ │ │ ├── request-level.po │ │ │ └── websocket-support.po │ │ ├── common │ │ │ ├── de-coding.po │ │ │ ├── http-model.po │ │ │ ├── index.po │ │ │ ├── json-support.po │ │ │ ├── marshalling.po │ │ │ ├── timeouts.po │ │ │ ├── unmarshalling.po │ │ │ └── xml-support.po │ │ ├── configuration.po │ │ ├── handling-blocking-operations-in-akka-http-routes.po │ │ ├── implications-of-streaming-http-entity.po │ │ ├── index.po │ │ ├── introduction.po │ │ ├── low-level-server-side-api.po │ │ ├── migration-from-old-http-javadsl.po │ │ ├── migration-from-spray.po │ │ ├── migration-guide-2.4.x-experimental.po │ │ ├── routing-dsl │ │ │ ├── case-class-extraction.po │ │ │ ├── directives │ │ │ │ ├── alphabetically.po │ │ │ │ ├── basic-directives │ │ │ │ │ ├── cancelRejection.po │ │ │ │ │ ├── cancelRejections.po │ │ │ │ │ ├── extract.po │ │ │ │ │ ├── extractActorSystem.po │ │ │ │ │ ├── extractDataBytes.po │ │ │ │ │ ├── extractExecutionContext.po │ │ │ │ │ ├── extractLog.po │ │ │ │ │ ├── extractMaterializer.po │ │ │ │ │ ├── extractRequest.po │ │ │ │ │ ├── extractRequestContext.po │ │ │ │ │ ├── extractRequestEntity.po │ │ │ │ │ ├── extractSettings.po │ │ │ │ │ ├── extractStrictEntity.po │ │ │ │ │ ├── extractUnmatchedPath.po │ │ │ │ │ ├── extractUri.po │ │ │ │ │ ├── index.po │ │ │ │ │ ├── mapInnerRoute.po │ │ │ │ │ ├── mapRejections.po │ │ │ │ │ ├── mapRequest.po │ │ │ │ │ ├── mapRequestContext.po │ │ │ │ │ ├── mapResponse.po │ │ │ │ │ ├── mapResponseEntity.po │ │ │ │ │ ├── mapResponseHeaders.po │ │ │ │ │ ├── mapRouteResult.po │ │ │ │ │ ├── mapRouteResultFuture.po │ │ │ │ │ ├── mapRouteResultPF.po │ │ │ │ │ ├── mapRouteResultWith.po │ │ │ │ │ ├── mapRouteResultWithPF.po │ │ │ │ │ ├── mapSettings.po │ │ │ │ │ ├── mapUnmatchedPath.po │ │ │ │ │ ├── pass.po │ │ │ │ │ ├── provide.po │ │ │ │ │ ├── recoverRejections.po │ │ │ │ │ ├── recoverRejectionsWith.po │ │ │ │ │ ├── textract.po │ │ │ │ │ ├── toStrictEntity.po │ │ │ │ │ ├── tprovide.po │ │ │ │ │ ├── withExecutionContext.po │ │ │ │ │ ├── withLog.po │ │ │ │ │ ├── withMaterializer.po │ │ │ │ │ └── withSettings.po │ │ │ │ ├── by-trait.po │ │ │ │ ├── cache-condition-directives │ │ │ │ │ ├── conditional.po │ │ │ │ │ └── index.po │ │ │ │ ├── coding-directives │ │ │ │ │ ├── decodeRequest.po │ │ │ │ │ ├── decodeRequestWith.po │ │ │ │ │ ├── encodeResponse.po │ │ │ │ │ ├── encodeResponseWith.po │ │ │ │ │ ├── index.po │ │ │ │ │ ├── requestEncodedWith.po │ │ │ │ │ └── responseEncodingAccepted.po │ │ │ │ ├── cookie-directives │ │ │ │ │ ├── cookie.po │ │ │ │ │ ├── deleteCookie.po │ │ │ │ │ ├── index.po │ │ │ │ │ ├── optionalCookie.po │ │ │ │ │ └── setCookie.po │ │ │ │ ├── custom-directives.po │ │ │ │ ├── debugging-directives │ │ │ │ │ ├── index.po │ │ │ │ │ ├── logRequest.po │ │ │ │ │ ├── logRequestResult.po │ │ │ │ │ └── logResult.po │ │ │ │ ├── execution-directives │ │ │ │ │ ├── handleExceptions.po │ │ │ │ │ ├── handleRejections.po │ │ │ │ │ └── index.po │ │ │ │ ├── file-and-resource-directives │ │ │ │ │ ├── getFromBrowseableDirectories.po │ │ │ │ │ ├── getFromBrowseableDirectory.po │ │ │ │ │ ├── getFromDirectory.po │ │ │ │ │ ├── getFromFile.po │ │ │ │ │ ├── getFromResource.po │ │ │ │ │ ├── getFromResourceDirectory.po │ │ │ │ │ ├── index.po │ │ │ │ │ └── listDirectoryContents.po │ │ │ │ ├── file-upload-directives │ │ │ │ │ ├── fileUpload.po │ │ │ │ │ ├── index.po │ │ │ │ │ └── uploadedFile.po │ │ │ │ ├── form-field-directives │ │ │ │ │ ├── formField.po │ │ │ │ │ ├── formFieldMap.po │ │ │ │ │ ├── formFieldMultiMap.po │ │ │ │ │ ├── formFieldSeq.po │ │ │ │ │ ├── formFields.po │ │ │ │ │ └── index.po │ │ │ │ ├── future-directives │ │ │ │ │ ├── completeOrRecoverWith.po │ │ │ │ │ ├── index.po │ │ │ │ │ ├── onComplete.po │ │ │ │ │ ├── onCompleteWithBreaker.po │ │ │ │ │ └── onSuccess.po │ │ │ │ ├── header-directives │ │ │ │ │ ├── checkSameOrigin.po │ │ │ │ │ ├── headerValue.po │ │ │ │ │ ├── headerValueByName.po │ │ │ │ │ ├── headerValueByType.po │ │ │ │ │ ├── headerValuePF.po │ │ │ │ │ ├── index.po │ │ │ │ │ ├── optionalHeaderValue.po │ │ │ │ │ ├── optionalHeaderValueByName.po │ │ │ │ │ ├── optionalHeaderValueByType.po │ │ │ │ │ └── optionalHeaderValuePF.po │ │ │ │ ├── host-directives │ │ │ │ │ ├── extractHost.po │ │ │ │ │ ├── host.po │ │ │ │ │ └── index.po │ │ │ │ ├── index.po │ │ │ │ ├── marshalling-directives │ │ │ │ │ ├── completeWith.po │ │ │ │ │ ├── entity.po │ │ │ │ │ ├── handleWith.po │ │ │ │ │ └── index.po │ │ │ │ ├── method-directives │ │ │ │ │ ├── delete.po │ │ │ │ │ ├── extractMethod.po │ │ │ │ │ ├── get.po │ │ │ │ │ ├── head.po │ │ │ │ │ ├── index.po │ │ │ │ │ ├── method.po │ │ │ │ │ ├── options.po │ │ │ │ │ ├── overrideMethodWithParameter.po │ │ │ │ │ ├── patch.po │ │ │ │ │ ├── post.po │ │ │ │ │ └── put.po │ │ │ │ ├── misc-directives │ │ │ │ │ ├── extractClientIP.po │ │ │ │ │ ├── index.po │ │ │ │ │ ├── rejectEmptyResponse.po │ │ │ │ │ ├── requestEntityEmpty.po │ │ │ │ │ ├── requestEntityPresent.po │ │ │ │ │ ├── selectPreferredLanguage.po │ │ │ │ │ ├── validate.po │ │ │ │ │ ├── withSizeLimit.po │ │ │ │ │ └── withoutSizeLimit.po │ │ │ │ ├── parameter-directives │ │ │ │ │ ├── index.po │ │ │ │ │ ├── parameter.po │ │ │ │ │ ├── parameterMap.po │ │ │ │ │ ├── parameterMultiMap.po │ │ │ │ │ ├── parameterSeq.po │ │ │ │ │ └── parameters.po │ │ │ │ ├── path-directives │ │ │ │ │ ├── index.po │ │ │ │ │ ├── path.po │ │ │ │ │ ├── pathEnd.po │ │ │ │ │ ├── pathEndOrSingleSlash.po │ │ │ │ │ ├── pathPrefix.po │ │ │ │ │ ├── pathPrefixTest.po │ │ │ │ │ ├── pathSingleSlash.po │ │ │ │ │ ├── pathSuffix.po │ │ │ │ │ ├── pathSuffixTest.po │ │ │ │ │ ├── rawPathPrefix.po │ │ │ │ │ ├── rawPathPrefixTest.po │ │ │ │ │ ├── redirectToNoTrailingSlashIfPresent.po │ │ │ │ │ └── redirectToTrailingSlashIfMissing.po │ │ │ │ ├── range-directives │ │ │ │ │ ├── index.po │ │ │ │ │ └── withRangeSupport.po │ │ │ │ ├── respond-with-directives │ │ │ │ │ ├── index.po │ │ │ │ │ ├── respondWithDefaultHeader.po │ │ │ │ │ ├── respondWithDefaultHeaders.po │ │ │ │ │ ├── respondWithHeader.po │ │ │ │ │ └── respondWithHeaders.po │ │ │ │ ├── route-directives │ │ │ │ │ ├── complete.po │ │ │ │ │ ├── failWith.po │ │ │ │ │ ├── index.po │ │ │ │ │ ├── redirect.po │ │ │ │ │ └── reject.po │ │ │ │ ├── scheme-directives │ │ │ │ │ ├── extractScheme.po │ │ │ │ │ ├── index.po │ │ │ │ │ └── scheme.po │ │ │ │ ├── security-directives │ │ │ │ │ ├── authenticateBasic.po │ │ │ │ │ ├── authenticateBasicAsync.po │ │ │ │ │ ├── authenticateBasicPF.po │ │ │ │ │ ├── authenticateBasicPFAsync.po │ │ │ │ │ ├── authenticateOAuth2.po │ │ │ │ │ ├── authenticateOAuth2Async.po │ │ │ │ │ ├── authenticateOAuth2PF.po │ │ │ │ │ ├── authenticateOAuth2PFAsync.po │ │ │ │ │ ├── authenticateOrRejectWithChallenge.po │ │ │ │ │ ├── authorize.po │ │ │ │ │ ├── authorizeAsync.po │ │ │ │ │ ├── extractCredentials.po │ │ │ │ │ └── index.po │ │ │ │ ├── timeout-directives │ │ │ │ │ ├── index.po │ │ │ │ │ ├── withRequestTimeout.po │ │ │ │ │ ├── withRequestTimeoutResponse.po │ │ │ │ │ └── withoutRequestTimeout.po │ │ │ │ └── websocket-directives │ │ │ │ │ ├── handleWebSocketMessages.po │ │ │ │ │ ├── handleWebSocketMessagesForProtocol.po │ │ │ │ │ └── index.po │ │ │ ├── exception-handling.po │ │ │ ├── index.po │ │ │ ├── overview.po │ │ │ ├── path-matchers.po │ │ │ ├── rejections.po │ │ │ ├── routes.po │ │ │ ├── source-streaming-support.po │ │ │ ├── testkit.po │ │ │ └── websocket-support.po │ │ └── server-side-https-support.po │ │ ├── index-actors.po │ │ ├── index-futures.po │ │ ├── index-network.po │ │ ├── index-utilities.po │ │ ├── io-tcp.po │ │ ├── io-udp.po │ │ ├── io.po │ │ ├── logging.po │ │ ├── mailboxes.po │ │ ├── persistence-query-leveldb.po │ │ ├── persistence-query.po │ │ ├── persistence-schema-evolution.po │ │ ├── persistence.po │ │ ├── remoting-artery.po │ │ ├── remoting.po │ │ ├── routing.po │ │ ├── scheduler.po │ │ ├── serialization.po │ │ ├── stream │ │ ├── index.po │ │ ├── migration-guide-1.0-2.x-scala.po │ │ ├── migration-guide-2.0-2.4-scala.po │ │ ├── stages-overview.po │ │ ├── stream-composition.po │ │ ├── stream-cookbook.po │ │ ├── stream-customize.po │ │ ├── stream-dynamic.po │ │ ├── stream-error.po │ │ ├── stream-flows-and-basics.po │ │ ├── stream-graphs.po │ │ ├── stream-integrations.po │ │ ├── stream-introduction.po │ │ ├── stream-io.po │ │ ├── stream-parallelism.po │ │ ├── stream-quickstart.po │ │ ├── stream-rate.po │ │ └── stream-testkit.po │ │ ├── testing.po │ │ ├── testkit-example.po │ │ ├── typed-actors.po │ │ └── typed.po ├── project │ ├── index.rst │ ├── issue-tracking.rst │ ├── licenses.rst │ ├── links.rst │ ├── migration-guide-1.3.x-2.0.x.rst │ ├── migration-guide-2.0.x-2.1.x.rst │ ├── migration-guide-2.1.x-2.2.x.rst │ ├── migration-guide-2.2.x-2.3.x.rst │ ├── migration-guide-2.3.x-2.4.x.rst │ ├── migration-guide-2.4.x-2.5.x.rst │ ├── migration-guide-eventsourced-2.3.x.rst │ ├── migration-guide-persistence-experimental-2.3.x-2.4.x.rst │ ├── migration-guides.rst │ └── sponsors.rst ├── scala.rst └── scala │ ├── actordsl.rst │ ├── actors.rst │ ├── agents.rst │ ├── camel.rst │ ├── cluster-client.rst │ ├── cluster-metrics.rst │ ├── cluster-sharding.rst │ ├── cluster-singleton.rst │ ├── cluster-usage.rst │ ├── code │ └── docs │ │ ├── CompileOnlySpec.scala │ │ ├── actor │ │ ├── ActorDocSpec.scala │ │ ├── ByteBufferSerializerDocSpec.scala │ │ ├── FSMDocSpec.scala │ │ ├── FaultHandlingDocSample.scala │ │ ├── FaultHandlingDocSpec.scala │ │ ├── InitializationDocSpec.scala │ │ ├── PropsEdgeCaseSpec.scala │ │ ├── SchedulerDocSpec.scala │ │ ├── TypedActorDocSpec.scala │ │ └── UnnestedReceives.scala │ │ ├── agent │ │ └── AgentDocSpec.scala │ │ ├── akka │ │ └── typed │ │ │ └── IntroSpec.scala │ │ ├── camel │ │ ├── Consumers.scala │ │ ├── CustomRoute.scala │ │ ├── Introduction.scala │ │ ├── Producers.scala │ │ └── PublishSubscribe.scala │ │ ├── cluster │ │ └── ClusterDocSpec.scala │ │ ├── ddata │ │ ├── DistributedDataDocSpec.scala │ │ ├── TwoPhaseSet.scala │ │ └── protobuf │ │ │ ├── TwoPhaseSetSerializer.scala │ │ │ └── TwoPhaseSetSerializer2.scala │ │ ├── dispatcher │ │ ├── DispatcherDocSpec.scala │ │ └── MyUnboundedMailbox.scala │ │ ├── event │ │ ├── EventBusDocSpec.scala │ │ └── LoggingDocSpec.scala │ │ ├── extension │ │ ├── ExtensionDocSpec.scala │ │ └── SettingsExtensionDocSpec.scala │ │ ├── future │ │ └── FutureDocSpec.scala │ │ ├── http │ │ └── scaladsl │ │ │ ├── HttpClientExampleSpec.scala │ │ │ ├── HttpServerExampleSpec.scala │ │ │ ├── HttpsExamplesSpec.scala │ │ │ ├── MarshalSpec.scala │ │ │ ├── ModelSpec.scala │ │ │ ├── SprayJsonCompactMarshalSpec.scala │ │ │ ├── SprayJsonExampleSpec.scala │ │ │ ├── UnmarshalSpec.scala │ │ │ ├── WebSocketClientExampleSpec.scala │ │ │ └── server │ │ │ ├── BlockingInHttpExamplesSpec.scala │ │ │ ├── CaseClassExtractionExamplesSpec.scala │ │ │ ├── DirectiveExamplesSpec.scala │ │ │ ├── ExceptionHandlerExamplesSpec.scala │ │ │ ├── FileUploadExamplesSpec.scala │ │ │ ├── FullTestKitExampleSpec.scala │ │ │ ├── HttpsServerExampleSpec.scala │ │ │ ├── RejectionHandlerExamplesSpec.scala │ │ │ ├── RoutingSpec.scala │ │ │ ├── WebSocketExampleSpec.scala │ │ │ └── directives │ │ │ ├── BasicDirectivesExamplesSpec.scala │ │ │ ├── CodingDirectivesExamplesSpec.scala │ │ │ ├── CookieDirectivesExamplesSpec.scala │ │ │ ├── CustomDirectivesExamplesSpec.scala │ │ │ ├── CustomHttpMethodSpec.scala │ │ │ ├── DebuggingDirectivesExamplesSpec.scala │ │ │ ├── ExecutionDirectivesExamplesSpec.scala │ │ │ ├── FileAndResourceDirectivesExamplesSpec.scala │ │ │ ├── FileUploadDirectivesExamplesSpec.scala │ │ │ ├── FormFieldDirectivesExamplesSpec.scala │ │ │ ├── FutureDirectivesExamplesSpec.scala │ │ │ ├── HeaderDirectivesExamplesSpec.scala │ │ │ ├── HostDirectivesExamplesSpec.scala │ │ │ ├── JsonStreamingExamplesSpec.scala │ │ │ ├── MarshallingDirectivesExamplesSpec.scala │ │ │ ├── MethodDirectivesExamplesSpec.scala │ │ │ ├── MiscDirectivesExamplesSpec.scala │ │ │ ├── ParameterDirectivesExamplesSpec.scala │ │ │ ├── PathDirectivesExamplesSpec.scala │ │ │ ├── RangeDirectivesExamplesSpec.scala │ │ │ ├── RespondWithDirectivesExamplesSpec.scala │ │ │ ├── RouteDirectivesExamplesSpec.scala │ │ │ ├── SchemeDirectivesExamplesSpec.scala │ │ │ ├── SecurityDirectivesExamplesSpec.scala │ │ │ ├── TimeoutDirectivesExamplesSpec.scala │ │ │ └── WebSocketDirectivesExamplesSpec.scala │ │ ├── io │ │ ├── EchoServer.scala │ │ ├── IODocSpec.scala │ │ ├── ReadBackPressure.scala │ │ ├── ScalaUdpMulticast.scala │ │ ├── ScalaUdpMulticastSpec.scala │ │ └── UdpDocSpec.scala │ │ ├── pattern │ │ ├── BackoffSupervisorDocSpec.scala │ │ ├── ScalaTemplate.scala │ │ └── SchedulerPatternSpec.scala │ │ ├── persistence │ │ ├── PersistenceDocSpec.scala │ │ ├── PersistenceEventAdapterDocSpec.scala │ │ ├── PersistenceMultiDocSpec.scala │ │ ├── PersistencePluginDocSpec.scala │ │ ├── PersistenceSchemaEvolutionDocSpec.scala │ │ ├── PersistenceSerializerDocSpec.scala │ │ └── query │ │ │ ├── LeveldbPersistenceQueryDocSpec.scala │ │ │ ├── MyEventsByTagPublisher.scala │ │ │ └── PersistenceQueryDocSpec.scala │ │ ├── remoting │ │ └── RemoteDeploymentDocSpec.scala │ │ ├── routing │ │ ├── ConsistentHashingRouterDocSpec.scala │ │ ├── CustomRouterDocSpec.scala │ │ └── RouterDocSpec.scala │ │ ├── serialization │ │ └── SerializationDocSpec.scala │ │ ├── stream │ │ ├── ActorPublisherDocSpec.scala │ │ ├── ActorSubscriberDocSpec.scala │ │ ├── BidiFlowDocSpec.scala │ │ ├── CompositionDocSpec.scala │ │ ├── FlowDocSpec.scala │ │ ├── FlowErrorDocSpec.scala │ │ ├── FlowParallelismDocSpec.scala │ │ ├── GraphCyclesSpec.scala │ │ ├── GraphDSLDocSpec.scala │ │ ├── GraphStageDocSpec.scala │ │ ├── HubsDocSpec.scala │ │ ├── IntegrationDocSpec.scala │ │ ├── KillSwitchDocSpec.scala │ │ ├── MigrationsScala.scala │ │ ├── QuickStartDocSpec.scala │ │ ├── RateTransformationDocSpec.scala │ │ ├── ReactiveStreamsDocSpec.scala │ │ ├── StreamBuffersRateSpec.scala │ │ ├── StreamPartialGraphDSLDocSpec.scala │ │ ├── StreamTestKitDocSpec.scala │ │ ├── TwitterStreamQuickstartDocSpec.scala │ │ ├── cookbook │ │ │ ├── RecipeByteStrings.scala │ │ │ ├── RecipeCollectingMetrics.scala │ │ │ ├── RecipeDigest.scala │ │ │ ├── RecipeDroppyBroadcast.scala │ │ │ ├── RecipeFlattenSeq.scala │ │ │ ├── RecipeGlobalRateLimit.scala │ │ │ ├── RecipeHold.scala │ │ │ ├── RecipeKeepAlive.scala │ │ │ ├── RecipeLoggingElements.scala │ │ │ ├── RecipeManualTrigger.scala │ │ │ ├── RecipeMissedTicks.scala │ │ │ ├── RecipeMultiGroupBy.scala │ │ │ ├── RecipeParseLines.scala │ │ │ ├── RecipeReduceByKey.scala │ │ │ ├── RecipeSeq.scala │ │ │ ├── RecipeSimpleDrop.scala │ │ │ ├── RecipeSpec.scala │ │ │ └── RecipeWorkerPool.scala │ │ └── io │ │ │ ├── StreamFileDocSpec.scala │ │ │ └── StreamTcpDocSpec.scala │ │ ├── testkit │ │ ├── ParentChildSpec.scala │ │ ├── PlainWordSpec.scala │ │ ├── TestKitUsageSpec.scala │ │ └── TestkitDocSpec.scala │ │ └── utils │ │ └── TestUtils.scala │ ├── dispatchers.rst │ ├── distributed-data.rst │ ├── distributed-pub-sub.rst │ ├── event-bus.rst │ ├── extending-akka.rst │ ├── fault-tolerance-sample.rst │ ├── fault-tolerance.rst │ ├── fsm.rst │ ├── futures.rst │ ├── hello-world.rst │ ├── howto.rst │ ├── http │ ├── DispatcherBehaviourOnBadCode.png │ ├── DispatcherBehaviourOnGoodCode.png │ ├── DispatcherBehaviourProperBlocking.png │ ├── client-side │ │ ├── client-https-support.rst │ │ ├── connection-level.rst │ │ ├── host-level.rst │ │ ├── index.rst │ │ ├── request-level.rst │ │ └── websocket-support.rst │ ├── common │ │ ├── de-coding.rst │ │ ├── http-model.rst │ │ ├── index.rst │ │ ├── json-support.rst │ │ ├── marshalling.rst │ │ ├── timeouts.rst │ │ ├── unmarshalling.rst │ │ └── xml-support.rst │ ├── configuration.rst │ ├── handling-blocking-operations-in-akka-http-routes.rst │ ├── implications-of-streaming-http-entity.rst │ ├── index.rst │ ├── introduction.rst │ ├── low-level-server-side-api.rst │ ├── migration-from-old-http-javadsl.rst │ ├── migration-from-spray.rst │ ├── migration-guide-2.4.x-experimental.rst │ ├── routing-dsl │ │ ├── case-class-extraction.rst │ │ ├── directives │ │ │ ├── alphabetically.rst │ │ │ ├── basic-directives │ │ │ │ ├── cancelRejection.rst │ │ │ │ ├── cancelRejections.rst │ │ │ │ ├── extract.rst │ │ │ │ ├── extractActorSystem.rst │ │ │ │ ├── extractDataBytes.rst │ │ │ │ ├── extractExecutionContext.rst │ │ │ │ ├── extractLog.rst │ │ │ │ ├── extractMaterializer.rst │ │ │ │ ├── extractRequest.rst │ │ │ │ ├── extractRequestContext.rst │ │ │ │ ├── extractRequestEntity.rst │ │ │ │ ├── extractSettings.rst │ │ │ │ ├── extractStrictEntity.rst │ │ │ │ ├── extractUnmatchedPath.rst │ │ │ │ ├── extractUri.rst │ │ │ │ ├── index.rst │ │ │ │ ├── mapInnerRoute.rst │ │ │ │ ├── mapRejections.rst │ │ │ │ ├── mapRequest.rst │ │ │ │ ├── mapRequestContext.rst │ │ │ │ ├── mapResponse.rst │ │ │ │ ├── mapResponseEntity.rst │ │ │ │ ├── mapResponseHeaders.rst │ │ │ │ ├── mapRouteResult.rst │ │ │ │ ├── mapRouteResultFuture.rst │ │ │ │ ├── mapRouteResultPF.rst │ │ │ │ ├── mapRouteResultWith.rst │ │ │ │ ├── mapRouteResultWithPF.rst │ │ │ │ ├── mapSettings.rst │ │ │ │ ├── mapUnmatchedPath.rst │ │ │ │ ├── pass.rst │ │ │ │ ├── provide.rst │ │ │ │ ├── recoverRejections.rst │ │ │ │ ├── recoverRejectionsWith.rst │ │ │ │ ├── textract.rst │ │ │ │ ├── toStrictEntity.rst │ │ │ │ ├── tprovide.rst │ │ │ │ ├── withExecutionContext.rst │ │ │ │ ├── withLog.rst │ │ │ │ ├── withMaterializer.rst │ │ │ │ └── withSettings.rst │ │ │ ├── by-trait.rst │ │ │ ├── cache-condition-directives │ │ │ │ ├── conditional.rst │ │ │ │ └── index.rst │ │ │ ├── coding-directives │ │ │ │ ├── decodeRequest.rst │ │ │ │ ├── decodeRequestWith.rst │ │ │ │ ├── encodeResponse.rst │ │ │ │ ├── encodeResponseWith.rst │ │ │ │ ├── index.rst │ │ │ │ ├── requestEncodedWith.rst │ │ │ │ └── responseEncodingAccepted.rst │ │ │ ├── cookie-directives │ │ │ │ ├── cookie.rst │ │ │ │ ├── deleteCookie.rst │ │ │ │ ├── index.rst │ │ │ │ ├── optionalCookie.rst │ │ │ │ └── setCookie.rst │ │ │ ├── custom-directives.rst │ │ │ ├── debugging-directives │ │ │ │ ├── index.rst │ │ │ │ ├── logRequest.rst │ │ │ │ ├── logRequestResult.rst │ │ │ │ └── logResult.rst │ │ │ ├── execution-directives │ │ │ │ ├── handleExceptions.rst │ │ │ │ ├── handleRejections.rst │ │ │ │ └── index.rst │ │ │ ├── file-and-resource-directives │ │ │ │ ├── getFromBrowseableDirectories.rst │ │ │ │ ├── getFromBrowseableDirectory.rst │ │ │ │ ├── getFromDirectory.rst │ │ │ │ ├── getFromFile.rst │ │ │ │ ├── getFromResource.rst │ │ │ │ ├── getFromResourceDirectory.rst │ │ │ │ ├── index.rst │ │ │ │ └── listDirectoryContents.rst │ │ │ ├── file-upload-directives │ │ │ │ ├── fileUpload.rst │ │ │ │ ├── index.rst │ │ │ │ └── uploadedFile.rst │ │ │ ├── form-field-directives │ │ │ │ ├── formField.rst │ │ │ │ ├── formFieldMap.rst │ │ │ │ ├── formFieldMultiMap.rst │ │ │ │ ├── formFieldSeq.rst │ │ │ │ ├── formFields.rst │ │ │ │ └── index.rst │ │ │ ├── future-directives │ │ │ │ ├── completeOrRecoverWith.rst │ │ │ │ ├── index.rst │ │ │ │ ├── onComplete.rst │ │ │ │ ├── onCompleteWithBreaker.rst │ │ │ │ └── onSuccess.rst │ │ │ ├── header-directives │ │ │ │ ├── checkSameOrigin.rst │ │ │ │ ├── headerValue.rst │ │ │ │ ├── headerValueByName.rst │ │ │ │ ├── headerValueByType.rst │ │ │ │ ├── headerValuePF.rst │ │ │ │ ├── index.rst │ │ │ │ ├── optionalHeaderValue.rst │ │ │ │ ├── optionalHeaderValueByName.rst │ │ │ │ ├── optionalHeaderValueByType.rst │ │ │ │ └── optionalHeaderValuePF.rst │ │ │ ├── host-directives │ │ │ │ ├── extractHost.rst │ │ │ │ ├── host.rst │ │ │ │ └── index.rst │ │ │ ├── index.rst │ │ │ ├── marshalling-directives │ │ │ │ ├── completeWith.rst │ │ │ │ ├── entity.rst │ │ │ │ ├── handleWith.rst │ │ │ │ └── index.rst │ │ │ ├── method-directives │ │ │ │ ├── delete.rst │ │ │ │ ├── extractMethod.rst │ │ │ │ ├── get.rst │ │ │ │ ├── head.rst │ │ │ │ ├── index.rst │ │ │ │ ├── method.rst │ │ │ │ ├── options.rst │ │ │ │ ├── overrideMethodWithParameter.rst │ │ │ │ ├── patch.rst │ │ │ │ ├── post.rst │ │ │ │ └── put.rst │ │ │ ├── misc-directives │ │ │ │ ├── extractClientIP.rst │ │ │ │ ├── index.rst │ │ │ │ ├── rejectEmptyResponse.rst │ │ │ │ ├── requestEntityEmpty.rst │ │ │ │ ├── requestEntityPresent.rst │ │ │ │ ├── selectPreferredLanguage.rst │ │ │ │ ├── validate.rst │ │ │ │ ├── withSizeLimit.rst │ │ │ │ └── withoutSizeLimit.rst │ │ │ ├── parameter-directives │ │ │ │ ├── index.rst │ │ │ │ ├── parameter.rst │ │ │ │ ├── parameterMap.rst │ │ │ │ ├── parameterMultiMap.rst │ │ │ │ ├── parameterSeq.rst │ │ │ │ └── parameters.rst │ │ │ ├── path-directives │ │ │ │ ├── index.rst │ │ │ │ ├── path.rst │ │ │ │ ├── pathEnd.rst │ │ │ │ ├── pathEndOrSingleSlash.rst │ │ │ │ ├── pathPrefix.rst │ │ │ │ ├── pathPrefixTest.rst │ │ │ │ ├── pathSingleSlash.rst │ │ │ │ ├── pathSuffix.rst │ │ │ │ ├── pathSuffixTest.rst │ │ │ │ ├── rawPathPrefix.rst │ │ │ │ ├── rawPathPrefixTest.rst │ │ │ │ ├── redirectToNoTrailingSlashIfPresent.rst │ │ │ │ └── redirectToTrailingSlashIfMissing.rst │ │ │ ├── range-directives │ │ │ │ ├── index.rst │ │ │ │ └── withRangeSupport.rst │ │ │ ├── respond-with-directives │ │ │ │ ├── index.rst │ │ │ │ ├── respondWithDefaultHeader.rst │ │ │ │ ├── respondWithDefaultHeaders.rst │ │ │ │ ├── respondWithHeader.rst │ │ │ │ └── respondWithHeaders.rst │ │ │ ├── route-directives │ │ │ │ ├── complete.rst │ │ │ │ ├── failWith.rst │ │ │ │ ├── index.rst │ │ │ │ ├── redirect.rst │ │ │ │ └── reject.rst │ │ │ ├── scheme-directives │ │ │ │ ├── extractScheme.rst │ │ │ │ ├── index.rst │ │ │ │ └── scheme.rst │ │ │ ├── security-directives │ │ │ │ ├── authenticateBasic.rst │ │ │ │ ├── authenticateBasicAsync.rst │ │ │ │ ├── authenticateBasicPF.rst │ │ │ │ ├── authenticateBasicPFAsync.rst │ │ │ │ ├── authenticateOAuth2.rst │ │ │ │ ├── authenticateOAuth2Async.rst │ │ │ │ ├── authenticateOAuth2PF.rst │ │ │ │ ├── authenticateOAuth2PFAsync.rst │ │ │ │ ├── authenticateOrRejectWithChallenge.rst │ │ │ │ ├── authorize.rst │ │ │ │ ├── authorizeAsync.rst │ │ │ │ ├── extractCredentials.rst │ │ │ │ └── index.rst │ │ │ ├── timeout-directives │ │ │ │ ├── index.rst │ │ │ │ ├── withRequestTimeout.rst │ │ │ │ ├── withRequestTimeoutResponse.rst │ │ │ │ └── withoutRequestTimeout.rst │ │ │ └── websocket-directives │ │ │ │ ├── handleWebSocketMessages.rst │ │ │ │ ├── handleWebSocketMessagesForProtocol.rst │ │ │ │ └── index.rst │ │ ├── exception-handling.rst │ │ ├── index.rst │ │ ├── overview.rst │ │ ├── path-matchers.rst │ │ ├── rejections.rst │ │ ├── routes.rst │ │ ├── source-streaming-support.rst │ │ ├── testkit.rst │ │ └── websocket-support.rst │ └── server-side-https-support.rst │ ├── index-actors.rst │ ├── index-futures.rst │ ├── index-network.rst │ ├── index-utilities.rst │ ├── io-tcp.rst │ ├── io-udp.rst │ ├── io.rst │ ├── logging.rst │ ├── mailboxes.rst │ ├── persistence-query-leveldb.rst │ ├── persistence-query.rst │ ├── persistence-schema-evolution.rst │ ├── persistence.rst │ ├── remoting-artery.rst │ ├── remoting.rst │ ├── routing.rst │ ├── scheduler.rst │ ├── serialization.rst │ ├── stream │ ├── index.rst │ ├── migration-guide-1.0-2.x-scala.rst │ ├── migration-guide-2.0-2.4-scala.rst │ ├── stages-overview.rst │ ├── stream-composition.rst │ ├── stream-cookbook.rst │ ├── stream-customize.rst │ ├── stream-dynamic.rst │ ├── stream-error.rst │ ├── stream-flows-and-basics.rst │ ├── stream-graphs.rst │ ├── stream-integrations.rst │ ├── stream-introduction.rst │ ├── stream-io.rst │ ├── stream-parallelism.rst │ ├── stream-quickstart.rst │ ├── stream-rate.rst │ └── stream-testkit.rst │ ├── testing.rst │ ├── testkit-example.rst │ ├── typed-actors.rst │ └── typed.rst └── src ├── main ├── java │ └── docs │ │ ├── ddata │ │ └── protobuf │ │ │ └── msg │ │ │ └── TwoPhaseSetMessages.java │ │ └── persistence │ │ └── proto │ │ └── FlightAppModels.java └── protobuf │ ├── FlightAppModels.proto │ └── TwoPhaseSetMessages.proto └── test └── resources └── application.conf /.gitignore: -------------------------------------------------------------------------------- 1 | _build/** 2 | project/** 3 | rst/_build/** 4 | _sphinx/** 5 | *.mo 6 | -------------------------------------------------------------------------------- /.history: -------------------------------------------------------------------------------- 1 | exit 2 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Akka ドキュメント日本語版 2 | 3 | [![Join the chat at https://gitter.im/akka-ja/akka-doc-ja](https://badges.gitter.im/akka-ja/akka-doc-ja.svg)](https://gitter.im/akka-ja/akka-doc-ja?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) 4 | 5 | このプロジェクトは [Akka](http://akka.io/) のドキュメントを日本語に翻訳するプロジェクトです。 6 | 7 | 翻訳にご協力いただける際は [CONTRIBUTING.md](CONTRIBUTING.md) を確認してください。 8 | -------------------------------------------------------------------------------- /_sphinx/pygments/setup.py: -------------------------------------------------------------------------------- 1 | """ 2 | Akka syntax styles for Pygments. 3 | """ 4 | 5 | from setuptools import setup 6 | 7 | entry_points = """ 8 | [pygments.styles] 9 | simple = styles.simple:SimpleStyle 10 | """ 11 | 12 | setup( 13 | name = 'akkastyles', 14 | version = '0.1', 15 | description = __doc__, 16 | author = "Akka", 17 | packages = ['styles'], 18 | entry_points = entry_points 19 | ) 20 | -------------------------------------------------------------------------------- /_sphinx/pygments/styles/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/_sphinx/pygments/styles/__init__.py -------------------------------------------------------------------------------- /_sphinx/static/akka-intellij-code-style.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/_sphinx/static/akka-intellij-code-style.jar -------------------------------------------------------------------------------- /_sphinx/static/akka.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/_sphinx/static/akka.png -------------------------------------------------------------------------------- /_sphinx/static/favicon.ico: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/_sphinx/static/favicon.ico -------------------------------------------------------------------------------- /_sphinx/static/logo.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/_sphinx/static/logo.png -------------------------------------------------------------------------------- /_sphinx/themes/akka/static/akka_icon_full_color.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /_sphinx/themes/akka/static/akka_icon_reverse.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /_sphinx/themes/akka/static/contentsFix.js: -------------------------------------------------------------------------------- 1 | jQuery(document).ready(function($) { 2 | 3 | $("#toc ul").each(function(){ 4 | var elem = $(this); 5 | if (elem.children().length == 0) { 6 | $(".contents-title").css("display","none"); 7 | } 8 | }); 9 | 10 | }); -------------------------------------------------------------------------------- /_sphinx/themes/akka/static/highlightCode.js: -------------------------------------------------------------------------------- 1 | jQuery(document).ready(function($) { 2 | if (typeof disableStyleCode != "undefined") { 3 | return; 4 | } 5 | var a = false; 6 | $("pre").each(function() { 7 | if (!$(this).hasClass("prettyprint")) { 8 | $(this).addClass("prettyprint lang-scala linenums"); 9 | a = true 10 | } 11 | }); 12 | if (a) { prettyPrint() } 13 | }); 14 | -------------------------------------------------------------------------------- /_sphinx/themes/akka/static/logo-small.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/_sphinx/themes/akka/static/logo-small.png -------------------------------------------------------------------------------- /_sphinx/themes/akka/static/pdf-icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/_sphinx/themes/akka/static/pdf-icon.png -------------------------------------------------------------------------------- /_sphinx/themes/akka/static/pdf-java-icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/_sphinx/themes/akka/static/pdf-java-icon.png -------------------------------------------------------------------------------- /_sphinx/themes/akka/static/pdf-scala-icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/_sphinx/themes/akka/static/pdf-scala-icon.png -------------------------------------------------------------------------------- /_sphinx/themes/akka/static/scrollTo.js: -------------------------------------------------------------------------------- 1 | jQuery(document).ready(function ($) { 2 | 3 | $(".scroll").click(function (event) { 4 | event.preventDefault(); 5 | window.location.hash = $(this).attr('href'); 6 | $(this.hash).effect("highlight", {color: "#15A9CE"}, 2000); 7 | }); 8 | }); -------------------------------------------------------------------------------- /_sphinx/themes/akka/static/search.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/_sphinx/themes/akka/static/search.jpg -------------------------------------------------------------------------------- /_sphinx/themes/akka/static/watermark.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/_sphinx/themes/akka/static/watermark.png -------------------------------------------------------------------------------- /_sphinx/themes/akka/theme.conf: -------------------------------------------------------------------------------- 1 | [theme] 2 | inherit = basic 3 | stylesheet = style.css 4 | 5 | [options] 6 | full_logo = false -------------------------------------------------------------------------------- /build.sbt: -------------------------------------------------------------------------------- 1 | import akka.{ AkkaBuild, Dependencies, Formatting, SphinxDoc } 2 | import akka.ValidatePullRequest._ 3 | import com.typesafe.sbt.SbtScalariform.ScalariformKeys 4 | import com.typesafe.sbt.SbtSite.site 5 | import com.typesafe.sbt.site.SphinxSupport._ 6 | 7 | AkkaBuild.defaultSettings 8 | AkkaBuild.dontPublishSettings 9 | Formatting.docFormatSettings 10 | Dependencies.docs 11 | 12 | site.settings 13 | site.sphinxSupport() 14 | site.publishSite 15 | 16 | SphinxDoc.sphinxPreprocessing 17 | SphinxDoc.docsSettings 18 | 19 | unmanagedSourceDirectories in ScalariformKeys.format in Test <<= unmanagedSourceDirectories in Test 20 | additionalTasks in ValidatePR += generate in Sphinx 21 | 22 | enablePlugins(ScaladocNoVerificationOfDiagrams) 23 | disablePlugins(MimaPlugin) 24 | -------------------------------------------------------------------------------- /rst/additional/code/docs/osgi/Activator.scala: -------------------------------------------------------------------------------- 1 | package docs.osgi 2 | 3 | case object SomeMessage 4 | 5 | class SomeActor extends akka.actor.Actor { 6 | def receive = { case SomeMessage => } 7 | } 8 | 9 | //#Activator 10 | import akka.actor.{ Props, ActorSystem } 11 | import org.osgi.framework.BundleContext 12 | import akka.osgi.ActorSystemActivator 13 | 14 | class Activator extends ActorSystemActivator { 15 | 16 | def configure(context: BundleContext, system: ActorSystem) { 17 | // optionally register the ActorSystem in the OSGi Service Registry 18 | registerService(context, system) 19 | 20 | val someActor = system.actorOf(Props[SomeActor], name = "someName") 21 | someActor ! SomeMessage 22 | } 23 | 24 | } 25 | //#Activator -------------------------------------------------------------------------------- /rst/additional/code/docs/osgi/blueprint.xml: -------------------------------------------------------------------------------- 1 | 2 | 4 | 5 | 6 | 7 | 8 | 9 | some.config { 10 | key=value 11 | } 12 | 13 | 14 | 15 | -------------------------------------------------------------------------------- /rst/additional/index.rst: -------------------------------------------------------------------------------- 1 | Additional Information 2 | ====================== 3 | 4 | .. toctree:: 5 | :maxdepth: 2 6 | 7 | ../common/binary-compatibility-rules 8 | faq 9 | books 10 | osgi 11 | -------------------------------------------------------------------------------- /rst/common/code/docs/duration/Java.java: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright (C) 2013-2016 Lightbend Inc. 3 | */ 4 | 5 | package docs.duration; 6 | 7 | //#import 8 | import scala.concurrent.duration.Duration; 9 | import scala.concurrent.duration.Deadline; 10 | //#import 11 | 12 | class Java { 13 | public void demo() { 14 | //#dsl 15 | final Duration fivesec = Duration.create(5, "seconds"); 16 | final Duration threemillis = Duration.create("3 millis"); 17 | final Duration diff = fivesec.minus(threemillis); 18 | assert diff.lt(fivesec); 19 | assert Duration.Zero().lt(Duration.Inf()); 20 | //#dsl 21 | //#deadline 22 | final Deadline deadline = Duration.create(10, "seconds").fromNow(); 23 | final Duration rest = deadline.timeLeft(); 24 | //#deadline 25 | rest.toString(); 26 | } 27 | } 28 | -------------------------------------------------------------------------------- /rst/common/code/docs/duration/Sample.scala: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright (C) 2013-2016 Lightbend Inc. 3 | */ 4 | 5 | package docs.duration 6 | 7 | import language.postfixOps 8 | 9 | object Scala { 10 | //#dsl 11 | import scala.concurrent.duration._ 12 | 13 | val fivesec = 5.seconds 14 | val threemillis = 3.millis 15 | val diff = fivesec - threemillis 16 | assert(diff < fivesec) 17 | val fourmillis = threemillis * 4 / 3 // you cannot write it the other way around 18 | val n = threemillis / (1 millisecond) 19 | //#dsl 20 | 21 | //#deadline 22 | val deadline = 10.seconds.fromNow 23 | // do something 24 | val rest = deadline.timeLeft 25 | //#deadline 26 | } 27 | -------------------------------------------------------------------------------- /rst/dev/index.rst: -------------------------------------------------------------------------------- 1 | Information for Akka Developers 2 | =============================== 3 | 4 | .. toctree:: 5 | :maxdepth: 2 6 | 7 | building-akka 8 | multi-jvm-testing 9 | io-layer 10 | developer-guidelines 11 | documentation 12 | 13 | -------------------------------------------------------------------------------- /rst/general/ActorPath.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/general/ActorPath.png -------------------------------------------------------------------------------- /rst/general/RemoteDeployment.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/general/RemoteDeployment.png -------------------------------------------------------------------------------- /rst/general/guardians.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/general/guardians.png -------------------------------------------------------------------------------- /rst/general/index.rst: -------------------------------------------------------------------------------- 1 | General 2 | ======= 3 | 4 | .. toctree:: 5 | :maxdepth: 2 6 | 7 | terminology 8 | actor-systems 9 | actors 10 | supervision 11 | addressing 12 | remoting 13 | jmm 14 | message-delivery-reliability 15 | configuration 16 | -------------------------------------------------------------------------------- /rst/general/stream/stream-configuration.rst: -------------------------------------------------------------------------------- 1 | .. _stream-config: 2 | 3 | ############# 4 | Configuration 5 | ############# 6 | 7 | .. literalinclude:: ../../../../akka-stream/src/main/resources/reference.conf -------------------------------------------------------------------------------- /rst/images/actor_lifecycle.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/actor_lifecycle.png -------------------------------------------------------------------------------- /rst/images/akka-http-file-listing.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/akka-http-file-listing.png -------------------------------------------------------------------------------- /rst/images/akka-remote-testconductor.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/akka-remote-testconductor.png -------------------------------------------------------------------------------- /rst/images/association_lifecycle.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/association_lifecycle.png -------------------------------------------------------------------------------- /rst/images/asyncBoundary.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/asyncBoundary.png -------------------------------------------------------------------------------- /rst/images/benchmark-akka-sample-trading-throughput.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/benchmark-akka-sample-trading-throughput.png -------------------------------------------------------------------------------- /rst/images/build-path.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/build-path.png -------------------------------------------------------------------------------- /rst/images/camel-pubsub.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/camel-pubsub.png -------------------------------------------------------------------------------- /rst/images/camel-pubsub2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/camel-pubsub2.png -------------------------------------------------------------------------------- /rst/images/circuit-breaker-states.dot: -------------------------------------------------------------------------------- 1 | digraph circuit_breaker { 2 | rankdir = "LR"; 3 | size = "6,5"; 4 | graph [ bgcolor = "transparent" ] 5 | node [ fontname = "Helvetica", 6 | fontsize = 14, 7 | shape = circle, 8 | color = white, 9 | style = filled ]; 10 | edge [ fontname = "Helvetica", fontsize = 12 ] 11 | Closed [ fillcolor = green2 ]; 12 | "Half-Open" [fillcolor = yellow2 ]; 13 | Open [ fillcolor = red2 ]; 14 | Closed -> Closed [ label = "Success" ]; 15 | "Half-Open" -> Open [ label = "Trip Breaker" ]; 16 | "Half-Open" -> Closed [ label = "Reset Breaker" ]; 17 | Closed -> Open [ label = "Trip Breaker" ]; 18 | Open -> Open [ label = "Calls failing fast" ]; 19 | Open -> "Half-Open" [ label = "Attempt Reset" ]; -------------------------------------------------------------------------------- /rst/images/circuit-breaker-states.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/circuit-breaker-states.png -------------------------------------------------------------------------------- /rst/images/clojure-trees.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/clojure-trees.png -------------------------------------------------------------------------------- /rst/images/compose_attributes.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/compose_attributes.png -------------------------------------------------------------------------------- /rst/images/compose_composites.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/compose_composites.png -------------------------------------------------------------------------------- /rst/images/compose_graph.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/compose_graph.png -------------------------------------------------------------------------------- /rst/images/compose_graph_flow.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/compose_graph_flow.png -------------------------------------------------------------------------------- /rst/images/compose_graph_partial.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/compose_graph_partial.png -------------------------------------------------------------------------------- /rst/images/compose_graph_shape.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/compose_graph_shape.png -------------------------------------------------------------------------------- /rst/images/compose_mat.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/compose_mat.png -------------------------------------------------------------------------------- /rst/images/compose_nested_flow.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/compose_nested_flow.png -------------------------------------------------------------------------------- /rst/images/compose_nested_flow_opaque.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/compose_nested_flow_opaque.png -------------------------------------------------------------------------------- /rst/images/compose_shapes.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/compose_shapes.png -------------------------------------------------------------------------------- /rst/images/composition.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/composition.png -------------------------------------------------------------------------------- /rst/images/diagnostics-window.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/diagnostics-window.png -------------------------------------------------------------------------------- /rst/images/example-code.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/example-code.png -------------------------------------------------------------------------------- /rst/images/faulttolerancesample-failure-flow.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/faulttolerancesample-failure-flow.png -------------------------------------------------------------------------------- /rst/images/faulttolerancesample-normal-flow.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/faulttolerancesample-normal-flow.png -------------------------------------------------------------------------------- /rst/images/graph_stage_chain.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/graph_stage_chain.png -------------------------------------------------------------------------------- /rst/images/graph_stage_conceptual.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/graph_stage_conceptual.png -------------------------------------------------------------------------------- /rst/images/graph_stage_detached_tracks_1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/graph_stage_detached_tracks_1.png -------------------------------------------------------------------------------- /rst/images/graph_stage_detached_tracks_2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/graph_stage_detached_tracks_2.png -------------------------------------------------------------------------------- /rst/images/graph_stage_diagrams.graffle: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/graph_stage_diagrams.graffle -------------------------------------------------------------------------------- /rst/images/graph_stage_duplicate.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/graph_stage_duplicate.png -------------------------------------------------------------------------------- /rst/images/graph_stage_filter.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/graph_stage_filter.png -------------------------------------------------------------------------------- /rst/images/graph_stage_map.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/graph_stage_map.png -------------------------------------------------------------------------------- /rst/images/graph_stage_tracks_1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/graph_stage_tracks_1.png -------------------------------------------------------------------------------- /rst/images/import-project.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/import-project.png -------------------------------------------------------------------------------- /rst/images/inport_transitions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/inport_transitions.png -------------------------------------------------------------------------------- /rst/images/install-beta2-updatesite.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/install-beta2-updatesite.png -------------------------------------------------------------------------------- /rst/images/member-states-weakly-up.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/member-states-weakly-up.png -------------------------------------------------------------------------------- /rst/images/member-states.drawing: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/member-states.drawing -------------------------------------------------------------------------------- /rst/images/member-states.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/member-states.png -------------------------------------------------------------------------------- /rst/images/more.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/more.png -------------------------------------------------------------------------------- /rst/images/outport_transitions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/outport_transitions.png -------------------------------------------------------------------------------- /rst/images/persistence-detach-models.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/persistence-detach-models.png -------------------------------------------------------------------------------- /rst/images/persistence-drop-event-serializer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/persistence-drop-event-serializer.png -------------------------------------------------------------------------------- /rst/images/persistence-drop-event.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/persistence-drop-event.png -------------------------------------------------------------------------------- /rst/images/persistence-event-adapter-1-n.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/persistence-event-adapter-1-n.png -------------------------------------------------------------------------------- /rst/images/persistence-manual-rename.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/persistence-manual-rename.png -------------------------------------------------------------------------------- /rst/images/persistence-serializer-rename.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/persistence-serializer-rename.png -------------------------------------------------------------------------------- /rst/images/persistent-message-envelope.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/persistent-message-envelope.png -------------------------------------------------------------------------------- /rst/images/phi1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/phi1.png -------------------------------------------------------------------------------- /rst/images/phi2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/phi2.png -------------------------------------------------------------------------------- /rst/images/phi3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/phi3.png -------------------------------------------------------------------------------- /rst/images/pi-formula.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/pi-formula.png -------------------------------------------------------------------------------- /rst/images/quickfix.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/quickfix.png -------------------------------------------------------------------------------- /rst/images/run-config.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/run-config.png -------------------------------------------------------------------------------- /rst/images/simple-graph-example.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/simple-graph-example.png -------------------------------------------------------------------------------- /rst/images/tcp-stream-bind.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/tcp-stream-bind.png -------------------------------------------------------------------------------- /rst/images/tcp-stream-run.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/images/tcp-stream-run.png -------------------------------------------------------------------------------- /rst/index.rst: -------------------------------------------------------------------------------- 1 | Contents 2 | ======== 3 | 4 | .. toctree:: 5 | :maxdepth: 1 6 | 7 | java 8 | scala 9 | -------------------------------------------------------------------------------- /rst/intro/index-java.rst: -------------------------------------------------------------------------------- 1 | Introduction 2 | ============ 3 | 4 | .. toctree:: 5 | :maxdepth: 2 6 | 7 | what-is-akka 8 | why-akka 9 | getting-started 10 | ../java/hello-world 11 | deployment-scenarios 12 | use-cases 13 | 14 | -------------------------------------------------------------------------------- /rst/intro/index-scala.rst: -------------------------------------------------------------------------------- 1 | Introduction 2 | ============ 3 | 4 | .. toctree:: 5 | :maxdepth: 2 6 | 7 | what-is-akka 8 | why-akka 9 | getting-started 10 | ../scala/hello-world 11 | deployment-scenarios 12 | use-cases 13 | 14 | -------------------------------------------------------------------------------- /rst/java.rst: -------------------------------------------------------------------------------- 1 | .. _java-api: 2 | 3 | Java Documentation 4 | ================== 5 | 6 | .. toctree:: 7 | :maxdepth: 2 8 | 9 | intro/index-java 10 | general/index 11 | java/index-actors 12 | java/lambda-index-actors 13 | java/index-futures 14 | java/index-network 15 | java/index-utilities 16 | java/stream/index 17 | java/http/index 18 | java/howto 19 | experimental/index-java 20 | dev/index 21 | project/index 22 | additional/index 23 | 24 | -------------------------------------------------------------------------------- /rst/java/code/docs/AbstractJavaTest.scala: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (C) 2016 Lightbend Inc. 3 | */ 4 | package docs 5 | 6 | import org.scalatest.junit.JUnitSuite 7 | 8 | /** 9 | * Base class for all runnable example tests written in Java 10 | */ 11 | abstract class AbstractJavaTest extends JUnitSuite { 12 | 13 | } 14 | -------------------------------------------------------------------------------- /rst/java/code/docs/actor/FirstUntypedActor.java: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright (C) 2009-2016 Lightbend Inc. 3 | */ 4 | package docs.actor; 5 | 6 | import akka.actor.ActorRef; 7 | import akka.actor.Props; 8 | import akka.actor.PoisonPill; 9 | import akka.actor.UntypedActor; 10 | 11 | //#context-actorOf 12 | public class FirstUntypedActor extends UntypedActor { 13 | ActorRef myActor = getContext().actorOf(Props.create(MyActor.class), "myactor"); 14 | 15 | //#context-actorOf 16 | 17 | public void onReceive(Object message) { 18 | myActor.forward(message, getContext()); 19 | myActor.tell(PoisonPill.getInstance(), ActorRef.noSender()); 20 | } 21 | } 22 | -------------------------------------------------------------------------------- /rst/java/code/docs/actor/ImmutableMessage.java: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright (C) 2009-2016 Lightbend Inc. 3 | */ 4 | package docs.actor; 5 | 6 | import java.util.ArrayList; 7 | import java.util.Collections; 8 | import java.util.List; 9 | 10 | //#immutable-message 11 | public class ImmutableMessage { 12 | private final int sequenceNumber; 13 | private final List values; 14 | 15 | public ImmutableMessage(int sequenceNumber, List values) { 16 | this.sequenceNumber = sequenceNumber; 17 | this.values = Collections.unmodifiableList(new ArrayList(values)); 18 | } 19 | 20 | public int getSequenceNumber() { 21 | return sequenceNumber; 22 | } 23 | 24 | public List getValues() { 25 | return values; 26 | } 27 | } 28 | //#immutable-message 29 | -------------------------------------------------------------------------------- /rst/java/code/docs/actor/MyBoundedUntypedActor.java: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright (C) 2009-2016 Lightbend Inc. 3 | */ 4 | 5 | package docs.actor; 6 | 7 | //#my-bounded-untyped-actor 8 | import akka.dispatch.BoundedMessageQueueSemantics; 9 | import akka.dispatch.RequiresMessageQueue; 10 | 11 | public class MyBoundedUntypedActor extends MyUntypedActor 12 | implements RequiresMessageQueue { 13 | } 14 | //#my-bounded-untyped-actor 15 | -------------------------------------------------------------------------------- /rst/java/code/docs/actor/MyStoppingActor.java: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright (C) 2009-2016 Lightbend Inc. 3 | */ 4 | package docs.actor; 5 | 6 | //#my-stopping-actor 7 | import akka.actor.ActorRef; 8 | import akka.actor.UntypedActor; 9 | import akka.event.Logging; 10 | import akka.event.LoggingAdapter; 11 | 12 | public class MyStoppingActor extends UntypedActor { 13 | 14 | ActorRef child = null; 15 | 16 | // ... creation of child ... 17 | 18 | public void onReceive(Object message) throws Exception { 19 | if (message.equals("interrupt-child")) { 20 | context().stop(child); 21 | } else if (message.equals("done")) { 22 | context().stop(getSelf()); 23 | } else { 24 | unhandled(message); 25 | } 26 | } 27 | } 28 | //#my-stopping-actor 29 | 30 | -------------------------------------------------------------------------------- /rst/java/code/docs/actor/MyUntypedActor.java: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright (C) 2009-2016 Lightbend Inc. 3 | */ 4 | package docs.actor; 5 | 6 | //#my-untyped-actor 7 | import akka.actor.UntypedActor; 8 | import akka.event.Logging; 9 | import akka.event.LoggingAdapter; 10 | 11 | public class MyUntypedActor extends UntypedActor { 12 | LoggingAdapter log = Logging.getLogger(getContext().system(), this); 13 | 14 | public void onReceive(Object message) throws Exception { 15 | if (message instanceof String) { 16 | log.info("Received String message: {}", message); 17 | getSender().tell(message, getSelf()); 18 | } else 19 | unhandled(message); 20 | } 21 | } 22 | //#my-untyped-actor 23 | 24 | -------------------------------------------------------------------------------- /rst/java/code/docs/agent/AgentDocJavaSpec.scala: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright (C) 2009-2016 Lightbend Inc. 3 | */ 4 | package docs.agent 5 | 6 | import org.scalatest.junit.JUnitWrapperSuite 7 | 8 | class AgentDocJavaSpec extends JUnitWrapperSuite( 9 | "docs.agent.AgentDocTest", 10 | Thread.currentThread.getContextClassLoader) 11 | -------------------------------------------------------------------------------- /rst/java/code/docs/camel/Consumer1.java: -------------------------------------------------------------------------------- 1 | package docs.camel; 2 | //#Consumer1 3 | import akka.camel.CamelMessage; 4 | import akka.camel.javaapi.UntypedConsumerActor; 5 | import akka.event.Logging; 6 | import akka.event.LoggingAdapter; 7 | 8 | public class Consumer1 extends UntypedConsumerActor { 9 | LoggingAdapter log = Logging.getLogger(getContext().system(), this); 10 | 11 | public String getEndpointUri() { 12 | return "file:data/input/actor"; 13 | } 14 | 15 | public void onReceive(Object message) { 16 | if (message instanceof CamelMessage) { 17 | CamelMessage camelMessage = (CamelMessage) message; 18 | String body = camelMessage.getBodyAs(String.class, getCamelContext()); 19 | log.info("Received message: {}", body); 20 | } else 21 | unhandled(message); 22 | } 23 | } 24 | //#Consumer1 25 | -------------------------------------------------------------------------------- /rst/java/code/docs/camel/Consumer2.java: -------------------------------------------------------------------------------- 1 | package docs.camel; 2 | //#Consumer2 3 | import akka.camel.CamelMessage; 4 | import akka.camel.javaapi.UntypedConsumerActor; 5 | 6 | public class Consumer2 extends UntypedConsumerActor { 7 | public String getEndpointUri() { 8 | return "jetty:http://localhost:8877/camel/default"; 9 | } 10 | 11 | public void onReceive(Object message) { 12 | if (message instanceof CamelMessage) { 13 | CamelMessage camelMessage = (CamelMessage) message; 14 | String body = camelMessage.getBodyAs(String.class, getCamelContext()); 15 | getSender().tell(String.format("Received message: %s",body), getSelf()); 16 | } else 17 | unhandled(message); 18 | } 19 | } 20 | //#Consumer2 21 | -------------------------------------------------------------------------------- /rst/java/code/docs/camel/CustomRouteBuilder.java: -------------------------------------------------------------------------------- 1 | package docs.camel; 2 | //#CustomRoute 3 | import akka.actor.ActorRef; 4 | import akka.camel.internal.component.CamelPath; 5 | import org.apache.camel.builder.RouteBuilder; 6 | 7 | public class CustomRouteBuilder extends RouteBuilder{ 8 | private String uri; 9 | 10 | public CustomRouteBuilder(ActorRef responder) { 11 | uri = CamelPath.toUri(responder); 12 | } 13 | 14 | public void configure() throws Exception { 15 | from("jetty:http://localhost:8877/camel/custom").to(uri); 16 | } 17 | } 18 | //#CustomRoute 19 | -------------------------------------------------------------------------------- /rst/java/code/docs/camel/CustomRouteTestBase.java: -------------------------------------------------------------------------------- 1 | package docs.camel; 2 | 3 | import akka.actor.ActorRef; 4 | import akka.actor.ActorSystem; 5 | import akka.actor.Props; 6 | import akka.camel.Camel; 7 | import akka.camel.CamelExtension; 8 | import akka.testkit.JavaTestKit; 9 | 10 | public class CustomRouteTestBase { 11 | public void customRoute() throws Exception{ 12 | //#CustomRoute 13 | ActorSystem system = ActorSystem.create("some-system"); 14 | try { 15 | Camel camel = CamelExtension.get(system); 16 | ActorRef responder = system.actorOf(Props.create(Responder.class), "TestResponder"); 17 | camel.context().addRoutes(new CustomRouteBuilder(responder)); 18 | //#CustomRoute 19 | } finally { 20 | JavaTestKit.shutdownActorSystem(system); 21 | } 22 | } 23 | } 24 | -------------------------------------------------------------------------------- /rst/java/code/docs/camel/FirstProducer.java: -------------------------------------------------------------------------------- 1 | package docs.camel; 2 | 3 | //#Producer1 4 | import akka.camel.javaapi.UntypedProducerActor; 5 | public class FirstProducer extends UntypedProducerActor { 6 | public String getEndpointUri() { 7 | return "http://localhost:8080/news"; 8 | } 9 | } 10 | //#Producer1 -------------------------------------------------------------------------------- /rst/java/code/docs/camel/Forwarder.java: -------------------------------------------------------------------------------- 1 | package docs.camel; 2 | //#RouteResponse 3 | import akka.actor.ActorRef; 4 | import akka.camel.javaapi.UntypedProducerActor; 5 | 6 | public class Forwarder extends UntypedProducerActor { 7 | private String uri; 8 | private ActorRef target; 9 | 10 | public Forwarder(String uri, ActorRef target) { 11 | this.uri = uri; 12 | this.target = target; 13 | } 14 | 15 | public String getEndpointUri() { 16 | return uri; 17 | } 18 | 19 | @Override 20 | public void onRouteResponse(Object message) { 21 | target.forward(message, getContext()); 22 | } 23 | } 24 | //#RouteResponse 25 | -------------------------------------------------------------------------------- /rst/java/code/docs/camel/MyActor.java: -------------------------------------------------------------------------------- 1 | package docs.camel; 2 | //#ProducerTemplate 3 | import akka.actor.UntypedActor; 4 | import akka.camel.Camel; 5 | import akka.camel.CamelExtension; 6 | import org.apache.camel.ProducerTemplate; 7 | 8 | public class MyActor extends UntypedActor { 9 | public void onReceive(Object message) { 10 | Camel camel = CamelExtension.get(getContext().system()); 11 | ProducerTemplate template = camel.template(); 12 | template.sendBody("direct:news", message); 13 | } 14 | } 15 | //#ProducerTemplate -------------------------------------------------------------------------------- /rst/java/code/docs/camel/MyEndpoint.java: -------------------------------------------------------------------------------- 1 | package docs.camel; 2 | 3 | //#Consumer-mina 4 | import akka.camel.CamelMessage; 5 | import akka.camel.javaapi.UntypedConsumerActor; 6 | 7 | public class MyEndpoint extends UntypedConsumerActor{ 8 | private String uri; 9 | 10 | public String getEndpointUri() { 11 | return uri; 12 | } 13 | 14 | public void onReceive(Object message) throws Exception { 15 | if (message instanceof CamelMessage) { 16 | /* ... */ 17 | } else 18 | unhandled(message); 19 | } 20 | 21 | // Extra constructor to change the default uri, 22 | // for instance to "jetty:http://localhost:8877/example" 23 | public MyEndpoint(String uri) { 24 | this.uri = uri; 25 | } 26 | 27 | public MyEndpoint() { 28 | this.uri = "mina2:tcp://localhost:6200?textline=true"; 29 | } 30 | } 31 | //#Consumer-mina -------------------------------------------------------------------------------- /rst/java/code/docs/camel/OnewaySender.java: -------------------------------------------------------------------------------- 1 | package docs.camel; 2 | //#Oneway 3 | import akka.camel.javaapi.UntypedProducerActor; 4 | 5 | public class OnewaySender extends UntypedProducerActor{ 6 | private String uri; 7 | 8 | public OnewaySender(String uri) { 9 | this.uri = uri; 10 | } 11 | public String getEndpointUri() { 12 | return uri; 13 | } 14 | 15 | @Override 16 | public boolean isOneway() { 17 | return true; 18 | } 19 | } 20 | //#Oneway 21 | -------------------------------------------------------------------------------- /rst/java/code/docs/camel/Orders.java: -------------------------------------------------------------------------------- 1 | package docs.camel; 2 | //#Producer 3 | import akka.camel.javaapi.UntypedProducerActor; 4 | 5 | public class Orders extends UntypedProducerActor { 6 | public String getEndpointUri() { 7 | return "jms:queue:Orders"; 8 | } 9 | } 10 | //#Producer -------------------------------------------------------------------------------- /rst/java/code/docs/camel/Producer1.java: -------------------------------------------------------------------------------- 1 | package docs.camel; 2 | //#Producer1 3 | import akka.camel.javaapi.UntypedProducerActor; 4 | 5 | public class Producer1 extends UntypedProducerActor { 6 | public String getEndpointUri() { 7 | return "http://localhost:8080/news"; 8 | } 9 | } 10 | //#Producer1 -------------------------------------------------------------------------------- /rst/java/code/docs/camel/RequestBodyActor.java: -------------------------------------------------------------------------------- 1 | package docs.camel; 2 | //#RequestProducerTemplate 3 | import akka.actor.UntypedActor; 4 | import akka.camel.Camel; 5 | import akka.camel.CamelExtension; 6 | import org.apache.camel.ProducerTemplate; 7 | 8 | public class RequestBodyActor extends UntypedActor { 9 | public void onReceive(Object message) { 10 | Camel camel = CamelExtension.get(getContext().system()); 11 | ProducerTemplate template = camel.template(); 12 | getSender().tell(template.requestBody("direct:news", message), getSelf()); 13 | } 14 | } 15 | //#RequestProducerTemplate -------------------------------------------------------------------------------- /rst/java/code/docs/camel/Responder.java: -------------------------------------------------------------------------------- 1 | package docs.camel; 2 | //#CustomRoute 3 | import akka.actor.UntypedActor; 4 | import akka.camel.CamelMessage; 5 | import akka.dispatch.Mapper; 6 | import akka.japi.Function; 7 | 8 | public class Responder extends UntypedActor{ 9 | 10 | public void onReceive(Object message) { 11 | if (message instanceof CamelMessage) { 12 | CamelMessage camelMessage = (CamelMessage) message; 13 | getSender().tell(createResponse(camelMessage), getSelf()); 14 | } else 15 | unhandled(message); 16 | } 17 | 18 | private CamelMessage createResponse(CamelMessage msg) { 19 | return msg.mapBody(new Mapper() { 20 | @Override 21 | public String apply(String body) { 22 | return String.format("received %s", body); 23 | } 24 | }); 25 | } 26 | } 27 | //#CustomRoute -------------------------------------------------------------------------------- /rst/java/code/docs/camel/ResponseReceiver.java: -------------------------------------------------------------------------------- 1 | package docs.camel; 2 | //#RouteResponse 3 | import akka.actor.UntypedActor; 4 | import akka.camel.CamelMessage; 5 | 6 | public class ResponseReceiver extends UntypedActor{ 7 | public void onReceive(Object message) { 8 | if(message instanceof CamelMessage) { 9 | // do something with the forwarded response 10 | } 11 | } 12 | } 13 | //#RouteResponse 14 | -------------------------------------------------------------------------------- /rst/java/code/docs/dispatcher/MyUnboundedJMessageQueueSemantics.java: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright (C) 2009-2016 Lightbend Inc. 3 | */ 4 | 5 | package docs.dispatcher; 6 | 7 | //#mailbox-implementation-example 8 | // Marker interface used for mailbox requirements mapping 9 | public interface MyUnboundedJMessageQueueSemantics { 10 | } 11 | //#mailbox-implementation-example 12 | -------------------------------------------------------------------------------- /rst/java/code/docs/http/javadsl/server/HttpsServerExampleTest.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (C) 2009-2016 Lightbend Inc. 3 | */ 4 | 5 | package docs.http.javadsl.server; 6 | 7 | import akka.actor.ActorSystem; 8 | import com.typesafe.sslconfig.akka.AkkaSSLConfig; 9 | import org.junit.Test; 10 | import org.scalatest.junit.JUnitSuite; 11 | 12 | /* COMPILE ONLY TEST */ 13 | public class HttpsServerExampleTest extends JUnitSuite { 14 | 15 | @Test 16 | public void compileOnlySpec() throws Exception { 17 | // just making sure for it to be really compiled / run even if empty 18 | } 19 | 20 | void sslConfigGet() { 21 | //#akka-ssl-config 22 | final ActorSystem system = ActorSystem.create(); 23 | 24 | final AkkaSSLConfig sslConfig = AkkaSSLConfig.get(system); 25 | //# 26 | } 27 | } 28 | -------------------------------------------------------------------------------- /rst/java/code/docs/pattern/JavaTemplate.java: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright (C) 2009-2016 Lightbend Inc. 3 | */ 4 | 5 | package docs.pattern; 6 | 7 | // this part will not appear in the docs 8 | 9 | //#all-of-it 10 | class JavaTemplate { 11 | public JavaTemplate() { 12 | System.out.println("Hello, Template!"); 13 | } 14 | //#uninteresting-stuff 15 | // don’t show this plumbimg 16 | //#uninteresting-stuff 17 | } 18 | //#all-of-it 19 | -------------------------------------------------------------------------------- /rst/java/http/common/index.rst: -------------------------------------------------------------------------------- 1 | .. _http-java-common: 2 | 3 | Common Abstractions (Client- and Server-Side) 4 | ============================================= 5 | 6 | HTTP and related specifications define a great number of concepts and functionality that is not specific to either 7 | HTTP's client- or server-side since they are meaningful on both end of an HTTP connection. 8 | The documentation for their counterparts in Akka HTTP lives in this section rather than in the ones for the 9 | :ref:`Client-Side API `, :ref:`http-low-level-server-side-api` or :ref:`http-high-level-server-side-api`, 10 | which are specific to one side only. 11 | 12 | 13 | .. toctree:: 14 | :maxdepth: 2 15 | 16 | ../http-model 17 | marshalling 18 | unmarshalling 19 | de-coding 20 | json-support 21 | timeouts 22 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/cancelRejection.rst: -------------------------------------------------------------------------------- 1 | .. _-cancelRejection-java-: 2 | 3 | cancelRejection 4 | =============== 5 | 6 | Description 7 | ----------- 8 | 9 | Adds a ``TransformationRejection`` cancelling all rejections equal to the 10 | given one to the rejections potentially coming back from the inner route. 11 | 12 | Read :ref:`rejections-java` to learn more about rejections. 13 | 14 | For more advanced handling of rejections refer to the :ref:`-handleRejections-java-` directive 15 | which provides a nicer DSL for building rejection handlers. 16 | 17 | Example 18 | ------- 19 | 20 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#cancelRejection 21 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/cancelRejections.rst: -------------------------------------------------------------------------------- 1 | .. _-cancelRejections-java-: 2 | 3 | cancelRejections 4 | ================ 5 | 6 | Description 7 | ----------- 8 | 9 | Adds a ``TransformationRejection`` cancelling all rejections created by the inner route for which 10 | the condition argument function returns ``true``. 11 | 12 | See also :ref:`-cancelRejection-java-`, for canceling a specific rejection. 13 | 14 | Read :ref:`rejections-java` to learn more about rejections. 15 | 16 | For more advanced handling of rejections refer to the :ref:`-handleRejections-java-` directive 17 | which provides a nicer DSL for building rejection handlers. 18 | 19 | Example 20 | ------- 21 | 22 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#cancelRejections 23 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/extract.rst: -------------------------------------------------------------------------------- 1 | .. _-extract-java-: 2 | 3 | extract 4 | ======= 5 | 6 | Description 7 | ----------- 8 | 9 | The ``extract`` directive is used as a building block for :ref:`Custom Directives-java` to extract data from the 10 | ``RequestContext`` and provide it to the inner route. 11 | 12 | See :ref:`ProvideDirectives-java` for an overview of similar directives. 13 | 14 | Example 15 | ------- 16 | 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#extract 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/extractActorSystem.rst: -------------------------------------------------------------------------------- 1 | .. _-extractActorSystem-java-: 2 | 3 | extractActorSystem 4 | ================== 5 | 6 | Description 7 | ----------- 8 | 9 | Extracts the ``ActorSystem`` from the ``RequestContext``, which can be useful when the external API 10 | in your route needs one. 11 | 12 | .. warning:: 13 | 14 | This is only supported when the available Materializer is an ActorMaterializer. 15 | 16 | Example 17 | ------- 18 | 19 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#extractActorSystem 20 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/extractDataBytes.rst: -------------------------------------------------------------------------------- 1 | .. _-extractDataBytes-java-: 2 | 3 | extractDataBytes 4 | ================ 5 | 6 | Description 7 | ----------- 8 | 9 | Extracts the entities data bytes as ``Source[ByteString, Any]`` from the :class:`RequestContext`. 10 | 11 | The directive returns a stream containing the request data bytes. 12 | 13 | Example 14 | ------- 15 | 16 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#extractDataBytes 17 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/extractExecutionContext.rst: -------------------------------------------------------------------------------- 1 | .. _-extractExecutionContext-java-: 2 | 3 | extractExecutionContext 4 | ======================= 5 | 6 | Description 7 | ----------- 8 | 9 | Extracts the ``ExecutionContext`` from the ``RequestContext``. 10 | 11 | See :ref:`-withExecutionContext-java-` to see how to customise the execution context provided for an inner route. 12 | 13 | See :ref:`-extract-java-` to learn more about how extractions work. 14 | 15 | Example 16 | ------- 17 | 18 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#extractExecutionContext 19 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/extractLog.rst: -------------------------------------------------------------------------------- 1 | .. _-extractLog-java-: 2 | 3 | extractLog 4 | ========== 5 | 6 | Description 7 | ----------- 8 | 9 | Extracts a :class:`LoggingAdapter` from the request context which can be used for logging inside the route. 10 | 11 | The ``extractLog`` directive is used for providing logging to routes, such that they don't have to depend on 12 | closing over a logger provided in the class body. 13 | 14 | See :ref:`-extract-java-` and :ref:`ProvideDirectives-java` for an overview of similar directives. 15 | 16 | Example 17 | ------- 18 | 19 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#extractLog 20 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/extractMaterializer.rst: -------------------------------------------------------------------------------- 1 | .. _-extractMaterializer-java-: 2 | 3 | extractMaterializer 4 | =================== 5 | 6 | Description 7 | ----------- 8 | 9 | Extracts the ``Materializer`` from the ``RequestContext``, which can be useful when you want to run an 10 | Akka Stream directly in your route. 11 | 12 | See also :ref:`-withMaterializer-java-` to see how to customise the used materializer for specific inner routes. 13 | 14 | Example 15 | ------- 16 | 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#extractMaterializer 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/extractRequest.rst: -------------------------------------------------------------------------------- 1 | .. _-extractRequest-java-: 2 | 3 | extractRequest 4 | ============== 5 | 6 | Description 7 | ----------- 8 | Extracts the complete ``HttpRequest`` instance. 9 | 10 | Use ``extractRequest`` to extract just the complete URI of the request. Usually there's little use of 11 | extracting the complete request because extracting of most of the aspects of HttpRequests is handled by specialized 12 | directives. See :ref:`Request Directives-java`. 13 | 14 | Example 15 | ------- 16 | 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#extractRequest 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/extractRequestContext.rst: -------------------------------------------------------------------------------- 1 | .. _-extractRequestContext-java-: 2 | 3 | extractRequestContext 4 | ===================== 5 | 6 | Description 7 | ----------- 8 | 9 | Extracts the request's underlying :class:`RequestContext`. 10 | 11 | This directive is used as a building block for most of the other directives, 12 | which extract the context and by inspecting some of it's values can decide 13 | what to do with the request - for example provide a value, or reject the request. 14 | 15 | See also :ref:`-extractRequest-java-` if only interested in the :class:`HttpRequest` instance itself. 16 | 17 | Example 18 | ------- 19 | 20 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#extractRequestContext 21 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/extractRequestEntity.rst: -------------------------------------------------------------------------------- 1 | .. _-extractRequestEntity-java-: 2 | 3 | extractRequestEntity 4 | ==================== 5 | 6 | Description 7 | ----------- 8 | 9 | Extracts the ``RequestEntity`` from the :class:`RequestContext`. 10 | 11 | The directive returns a ``RequestEntity`` without unmarshalling the request. To extract domain entity, 12 | :ref:`-entity-java-` should be used. 13 | 14 | Example 15 | ------- 16 | 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#extractRequestEntity 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/extractSettings.rst: -------------------------------------------------------------------------------- 1 | .. _-extractSettings-java-: 2 | 3 | extractSettings 4 | =============== 5 | 6 | Description 7 | ----------- 8 | 9 | Extracts the :class:`RoutingSettings` from the :class:`RequestContext`. 10 | 11 | By default the settings of the ``Http()`` extension running the route will be returned. 12 | It is possible to override the settings for specific sub-routes by using the :ref:`-withSettings-java-` directive. 13 | 14 | Example 15 | ------- 16 | 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#extractRequestContext 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/extractUnmatchedPath.rst: -------------------------------------------------------------------------------- 1 | .. _-extractUnmatchedPath-java-: 2 | 3 | extractUnmatchedPath 4 | ==================== 5 | 6 | Description 7 | ----------- 8 | Extracts the unmatched path from the request context. 9 | 10 | The ``extractUnmatchedPath`` directive extracts the remaining path that was not yet matched by any of the :ref:`PathDirectives-java` 11 | (or any custom ones that change the unmatched path field of the request context). You can use it for building directives 12 | that handle complete suffixes of paths (like the ``getFromDirectory`` directives and similar ones). 13 | 14 | Use ``mapUnmatchedPath`` to change the value of the unmatched path. 15 | 16 | Example 17 | ------- 18 | 19 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#extractUnmatchedPath 20 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/extractUri.rst: -------------------------------------------------------------------------------- 1 | .. _-extractUri-java-: 2 | 3 | extractUri 4 | ========== 5 | 6 | Description 7 | ----------- 8 | Access the full URI of the request. 9 | 10 | Use :ref:`SchemeDirectives-java`, :ref:`HostDirectives-java`, :ref:`PathDirectives-java`, and :ref:`ParameterDirectives-java` for more 11 | targeted access to parts of the URI. 12 | 13 | Example 14 | ------- 15 | 16 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#extractUri 17 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/mapInnerRoute.rst: -------------------------------------------------------------------------------- 1 | .. _-mapInnerRoute-java-: 2 | 3 | mapInnerRoute 4 | ============= 5 | 6 | Description 7 | ----------- 8 | Changes the execution model of the inner route by wrapping it with arbitrary logic. 9 | 10 | The ``mapInnerRoute`` directive is used as a building block for :ref:`Custom Directives-java` to replace the inner route 11 | with any other route. Usually, the returned route wraps the original one with custom execution logic. 12 | 13 | Example 14 | ------- 15 | 16 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#mapInnerRoute 17 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/mapRejections.rst: -------------------------------------------------------------------------------- 1 | .. _-mapRejections-java-: 2 | 3 | mapRejections 4 | ============= 5 | 6 | Description 7 | ----------- 8 | 9 | **Low level directive** – unless you're sure you need to be working on this low-level you might instead 10 | want to try the :ref:`-handleRejections-java-` directive which provides a nicer DSL for building rejection handlers. 11 | 12 | The ``mapRejections`` directive is used as a building block for :ref:`Custom Directives-java` to transform a list 13 | of rejections from the inner route to a new list of rejections. 14 | 15 | See :ref:`Response Transforming Directives-java` for similar directives. 16 | 17 | Example 18 | ------- 19 | 20 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#mapRejections 21 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/mapRequestContext.rst: -------------------------------------------------------------------------------- 1 | .. _-mapRequestContext-java-: 2 | 3 | mapRequestContext 4 | ================= 5 | 6 | Description 7 | ----------- 8 | Transforms the ``RequestContext`` before it is passed to the inner route. 9 | 10 | The ``mapRequestContext`` directive is used as a building block for :ref:`Custom Directives-java` to transform 11 | the request context before it is passed to the inner route. To change only the request value itself the 12 | :ref:`-mapRequest-java-` directive can be used instead. 13 | 14 | See :ref:`Request Transforming Directives-java` for an overview of similar directives. 15 | 16 | Example 17 | ------- 18 | 19 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#mapRequestContext 20 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/mapResponseEntity.rst: -------------------------------------------------------------------------------- 1 | .. _-mapResponseEntity-java-: 2 | 3 | mapResponseEntity 4 | ================= 5 | 6 | Description 7 | ----------- 8 | 9 | The ``mapResponseEntity`` directive is used as a building block for :ref:`Custom Directives-java` to transform a 10 | response entity that was generated by the inner route. 11 | 12 | See :ref:`Response Transforming Directives-java` for similar directives. 13 | 14 | Example 15 | ------- 16 | 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#mapResponseEntity 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/mapResponseHeaders.rst: -------------------------------------------------------------------------------- 1 | .. _-mapResponseHeaders-java-: 2 | 3 | mapResponseHeaders 4 | ================== 5 | 6 | Description 7 | ----------- 8 | Changes the list of response headers that was generated by the inner route. 9 | 10 | The ``mapResponseHeaders`` directive is used as a building block for :ref:`Custom Directives-java` to transform the list of 11 | response headers that was generated by the inner route. 12 | 13 | See :ref:`Response Transforming Directives-java` for similar directives. 14 | 15 | Example 16 | ------- 17 | 18 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#mapResponseHeaders 19 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/mapRouteResult.rst: -------------------------------------------------------------------------------- 1 | .. _-mapRouteResult-java-: 2 | 3 | mapRouteResult 4 | ============== 5 | 6 | Description 7 | ----------- 8 | Changes the message the inner route sends to the responder. 9 | 10 | The ``mapRouteResult`` directive is used as a building block for :ref:`Custom Directives-java` to transform the 11 | :class:`RouteResult` coming back from the inner route. 12 | 13 | See :ref:`Result Transformation Directives-java` for similar directives. 14 | 15 | Example 16 | ------- 17 | 18 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#mapRouteResult 19 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/mapRouteResultFuture.rst: -------------------------------------------------------------------------------- 1 | .. _-mapRouteResultFuture-java-: 2 | 3 | mapRouteResultFuture 4 | ==================== 5 | 6 | Description 7 | ----------- 8 | 9 | Asynchronous version of :ref:`-mapRouteResult-java-`. 10 | 11 | It's similar to :ref:`-mapRouteResultWith-java-`, however it's 12 | ``Function, CompletionStage>`` 13 | instead of ``Function>`` which may be useful when 14 | combining multiple transformations and / or wanting to ``recover`` from a failed route result. 15 | 16 | See :ref:`Result Transformation Directives-java` for similar directives. 17 | 18 | Example 19 | ------- 20 | 21 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#mapRouteResultFuture 22 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/mapRouteResultWith.rst: -------------------------------------------------------------------------------- 1 | .. _-mapRouteResultWith-java-: 2 | 3 | mapRouteResultWith 4 | ================== 5 | 6 | Description 7 | ----------- 8 | 9 | Changes the message the inner route sends to the responder. 10 | 11 | The ``mapRouteResult`` directive is used as a building block for :ref:`Custom Directives-java` to transform the 12 | :class:`RouteResult` coming back from the inner route. It's similar to the :ref:`-mapRouteResult-java-` directive but 13 | returning a ``CompletionStage`` instead of a result immediately, which may be useful for longer running transformations. 14 | 15 | See :ref:`Result Transformation Directives-java` for similar directives. 16 | 17 | Example 18 | ------- 19 | 20 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#mapRouteResultWith 21 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/mapRouteResultWithPF.rst: -------------------------------------------------------------------------------- 1 | .. _-mapRouteResultWithPF-java-: 2 | 3 | mapRouteResultWithPF 4 | ==================== 5 | 6 | Description 7 | ----------- 8 | 9 | Asynchronous variant of :ref:`-mapRouteResultPF-java-`. 10 | 11 | Changes the message the inner route sends to the responder. 12 | 13 | The ``mapRouteResult`` directive is used as a building block for :ref:`Custom Directives-java` to transform the 14 | :class:`RouteResult` coming back from the inner route. 15 | 16 | See :ref:`Result Transformation Directives-java` for similar directives. 17 | 18 | Example 19 | ------- 20 | 21 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#mapRouteResultWithPF 22 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/mapSettings.rst: -------------------------------------------------------------------------------- 1 | .. _-mapSettings-java-: 2 | 3 | mapSettings 4 | =========== 5 | 6 | Description 7 | ----------- 8 | 9 | Transforms the ``RoutingSettings`` with a ``Function``. 10 | 11 | See also :ref:`-withSettings-java-` or :ref:`-extractSettings-java-`. 12 | 13 | Example 14 | ------- 15 | 16 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#mapSettings 17 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/mapUnmatchedPath.rst: -------------------------------------------------------------------------------- 1 | .. _-mapUnmatchedPath-java-: 2 | 3 | mapUnmatchedPath 4 | ================ 5 | 6 | Description 7 | ----------- 8 | Transforms the unmatchedPath field of the request context for inner routes. 9 | 10 | The ``mapUnmatchedPath`` directive is used as a building block for writing :ref:`Custom Directives-java`. You can use it 11 | for implementing custom path matching directives. 12 | 13 | Use ``extractUnmatchedPath`` for extracting the current value of the unmatched path. 14 | 15 | Example 16 | ------- 17 | 18 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#mapUnmatchedPath 19 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/pass.rst: -------------------------------------------------------------------------------- 1 | .. _-pass-java-: 2 | 3 | pass 4 | ==== 5 | 6 | Description 7 | ----------- 8 | A directive that passes the request unchanged to its inner route. 9 | 10 | It is usually used as a "neutral element" when combining directives generically. 11 | 12 | Example 13 | ------- 14 | 15 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#pass 16 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/provide.rst: -------------------------------------------------------------------------------- 1 | .. _-provide-java-: 2 | 3 | provide 4 | ======= 5 | Description 6 | ----------- 7 | Provides a constant value to the inner route. 8 | 9 | The `provide` directive is used as a building block for :ref:`Custom Directives-java` to provide a single value to the 10 | inner route. 11 | 12 | See :ref:`ProvideDirectives-java` for an overview of similar directives. 13 | 14 | Example 15 | ------- 16 | 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#provide 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/withExecutionContext.rst: -------------------------------------------------------------------------------- 1 | .. _-withExecutionContext-java-: 2 | 3 | withExecutionContext 4 | ==================== 5 | 6 | Description 7 | ----------- 8 | 9 | Allows running an inner route using an alternative ``ExecutionContextExecutor`` in place of the default one. 10 | 11 | The execution context can be extracted in an inner route using :ref:`-extractExecutionContext-java-` directly, 12 | or used by directives which internally extract the materializer without sufracing this fact in the API. 13 | 14 | 15 | Example 16 | ------- 17 | 18 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#withExecutionContext 19 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/withLog.rst: -------------------------------------------------------------------------------- 1 | .. _-withLog-java-: 2 | 3 | withLog 4 | ======= 5 | 6 | Description 7 | ----------- 8 | 9 | Allows running an inner route using an alternative :class:`LoggingAdapter` in place of the default one. 10 | 11 | The logging adapter can be extracted in an inner route using :ref:`-extractLog-java-` directly, 12 | or used by directives which internally extract the materializer without surfacing this fact in the API. 13 | 14 | 15 | Example 16 | ------- 17 | 18 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#withLog 19 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/withMaterializer.rst: -------------------------------------------------------------------------------- 1 | .. _-withMaterializer-java-: 2 | 3 | withMaterializer 4 | ================ 5 | 6 | Description 7 | ----------- 8 | 9 | Allows running an inner route using an alternative ``Materializer`` in place of the default one. 10 | 11 | The materializer can be extracted in an inner route using :ref:`-extractMaterializer-java-` directly, 12 | or used by directives which internally extract the materializer without sufracing this fact in the API 13 | (e.g. responding with a Chunked entity). 14 | 15 | Example 16 | ------- 17 | 18 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#withMaterializer 19 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/basic-directives/withSettings.rst: -------------------------------------------------------------------------------- 1 | .. _-withSettings-java-: 2 | 3 | withSettings 4 | ============ 5 | 6 | Description 7 | ----------- 8 | 9 | Allows running an inner route using an alternative :class:`RoutingSettings` in place of the default one. 10 | 11 | The execution context can be extracted in an inner route using :ref:`-extractSettings-java-` directly, 12 | or used by directives which internally extract the materializer without sufracing this fact in the API. 13 | 14 | Example 15 | ------- 16 | 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/BasicDirectivesExamplesTest.java#withSettings 18 | 19 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/cache-condition-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _CacheConditionDirectives-java: 2 | 3 | CacheConditionDirectives 4 | ======================== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | conditional 10 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/coding-directives/decodeRequest.rst: -------------------------------------------------------------------------------- 1 | .. _-decodeRequest-java-: 2 | 3 | decodeRequest 4 | ============= 5 | 6 | Description 7 | ----------- 8 | 9 | Decompresses the incoming request if it is ``gzip`` or ``deflate`` compressed. Uncompressed requests are passed through untouched. If the request encoded with another encoding the request is rejected with an ``UnsupportedRequestEncodingRejection``. 10 | 11 | Example 12 | ------- 13 | 14 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/CodingDirectivesExamplesTest.java#decodeRequest 15 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/coding-directives/decodeRequestWith.rst: -------------------------------------------------------------------------------- 1 | .. _-decodeRequestWith-java-: 2 | 3 | decodeRequestWith 4 | ================= 5 | 6 | Description 7 | ----------- 8 | 9 | Decodes the incoming request if it is encoded with one of the given encoders. If the request encoding doesn't match one of the given encoders the request is rejected with an ``UnsupportedRequestEncodingRejection``. If no decoders are given the default encoders (``Gzip``, ``Deflate``, ``NoCoding``) are used. 10 | 11 | Example 12 | ------- 13 | 14 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/CodingDirectivesExamplesTest.java#decodeRequestWith 15 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/coding-directives/encodeResponse.rst: -------------------------------------------------------------------------------- 1 | .. _-encodeResponse-java-: 2 | 3 | encodeResponse 4 | ============== 5 | 6 | Description 7 | ----------- 8 | 9 | Encodes the response with the encoding that is requested by the client via the ``Accept-Encoding`` header or rejects the request with an ``UnacceptedResponseEncodingRejection(supportedEncodings)``. 10 | 11 | The response encoding is determined by the rules specified in RFC7231_. 12 | 13 | If the ``Accept-Encoding`` header is missing or empty or specifies an encoding other than identity, gzip or deflate then no encoding is used. 14 | 15 | Example 16 | ------- 17 | 18 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/CodingDirectivesExamplesTest.java#encodeResponse 19 | 20 | .. _RFC7231: http://tools.ietf.org/html/rfc7231#section-5.3.4 21 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/coding-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _CodingDirectives-java: 2 | 3 | CodingDirectives 4 | ================ 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | decodeRequest 10 | decodeRequestWith 11 | encodeResponse 12 | encodeResponseWith 13 | requestEncodedWith 14 | responseEncodingAccepted 15 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/coding-directives/requestEncodedWith.rst: -------------------------------------------------------------------------------- 1 | .. _-requestEncodedWith-java-: 2 | 3 | requestEncodedWith 4 | ================== 5 | 6 | Description 7 | ----------- 8 | 9 | Passes the request to the inner route if the request is encoded with the argument encoding. Otherwise, rejects the request with an ``UnacceptedRequestEncodingRejection(encoding)``. 10 | 11 | This directive is the building block for ``decodeRequest`` to reject unsupported encodings. 12 | 13 | Example 14 | ------- 15 | TODO: Example snippets for JavaDSL are subject to community contributions! Help us complete the docs, read more about it here: `write example snippets for Akka HTTP Java DSL #20466 `_. 16 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/coding-directives/responseEncodingAccepted.rst: -------------------------------------------------------------------------------- 1 | .. _-responseEncodingAccepted-java-: 2 | 3 | responseEncodingAccepted 4 | ======================== 5 | 6 | Description 7 | ----------- 8 | 9 | Passes the request to the inner route if the request accepts the argument encoding. Otherwise, rejects the request with an ``UnacceptedResponseEncodingRejection(encoding)``. 10 | 11 | Example 12 | ------- 13 | 14 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/CodingDirectivesExamplesTest.java#responseEncodingAccepted 15 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/cookie-directives/cookie.rst: -------------------------------------------------------------------------------- 1 | .. _-cookie-java-: 2 | 3 | cookie 4 | ====== 5 | 6 | Description 7 | ----------- 8 | Extracts a cookie with a given name from a request or otherwise rejects the request with a ``MissingCookieRejection`` if 9 | the cookie is missing. 10 | 11 | Use the :ref:`-optionalCookie-java-` directive instead if you want to support missing cookies in your inner route. 12 | 13 | 14 | Example 15 | ------- 16 | 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/CookieDirectivesExamplesTest.java#cookie 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/cookie-directives/deleteCookie.rst: -------------------------------------------------------------------------------- 1 | .. _-deleteCookie-java-: 2 | 3 | deleteCookie 4 | ============ 5 | 6 | Description 7 | ----------- 8 | Adds a header to the response to request the removal of the cookie with the given name on the client. 9 | 10 | Use the :ref:`-setCookie-java-` directive to update a cookie. 11 | 12 | Example 13 | ------- 14 | 15 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/CookieDirectivesExamplesTest.java#deleteCookie 16 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/cookie-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _CookieDirectives-java: 2 | 3 | CookieDirectives 4 | ================ 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | cookie 10 | deleteCookie 11 | optionalCookie 12 | setCookie 13 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/cookie-directives/optionalCookie.rst: -------------------------------------------------------------------------------- 1 | .. _-optionalCookie-java-: 2 | 3 | optionalCookie 4 | ============== 5 | 6 | Description 7 | ----------- 8 | Extracts an optional cookie with a given name from a request. 9 | 10 | Use the :ref:`-cookie-java-` directive instead if the inner route does not handle a missing cookie. 11 | 12 | 13 | Example 14 | ------- 15 | 16 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/CookieDirectivesExamplesTest.java#optionalCookie 17 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/cookie-directives/setCookie.rst: -------------------------------------------------------------------------------- 1 | .. _-setCookie-java-: 2 | 3 | setCookie 4 | ========= 5 | 6 | Description 7 | ----------- 8 | Adds a header to the response to request the update of the cookie with the given name on the client. 9 | 10 | Use the :ref:`-deleteCookie-java-` directive to delete a cookie. 11 | 12 | 13 | Example 14 | ------- 15 | 16 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/CookieDirectivesExamplesTest.java#setCookie 17 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/debugging-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _DebuggingDirectives-java: 2 | 3 | DebuggingDirectives 4 | =================== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | logRequest 10 | logRequestResult 11 | logResult 12 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/debugging-directives/logRequest.rst: -------------------------------------------------------------------------------- 1 | .. _-logRequest-java-: 2 | 3 | logRequest 4 | ========== 5 | 6 | Description 7 | ----------- 8 | 9 | Logs the request. The directive is available with the following parameters: 10 | 11 | * A marker to prefix each log message with. 12 | * A log level. 13 | * A function that creates a :class:``LogEntry`` from the :class:``HttpRequest`` 14 | 15 | Use ``logResult`` for logging the response, or ``logRequestResult`` for logging both. 16 | 17 | Example 18 | ------- 19 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/DebuggingDirectivesExamplesTest.java#logRequest 20 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/debugging-directives/logResult.rst: -------------------------------------------------------------------------------- 1 | .. _-logResult-java-: 2 | 3 | logResult 4 | ========= 5 | 6 | Description 7 | ----------- 8 | Logs the response. 9 | 10 | See :ref:`-logRequest-java-` for the general description how these directives work. 11 | 12 | Use ``logRequest`` for logging the request, or ``logRequestResult`` for logging both. 13 | 14 | Example 15 | ------- 16 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/DebuggingDirectivesExamplesTest.java#logResult 17 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/execution-directives/handleExceptions.rst: -------------------------------------------------------------------------------- 1 | .. _-handleExceptions-java-: 2 | 3 | handleExceptions 4 | ================ 5 | 6 | Description 7 | ----------- 8 | Catches exceptions thrown by the inner route and handles them using the specified ``ExceptionHandler``. 9 | 10 | Using this directive is an alternative to using a global implicitly defined ``ExceptionHandler`` that 11 | applies to the complete route. 12 | 13 | See :ref:`exception-handling-java` for general information about options for handling exceptions. 14 | 15 | Example 16 | ------- 17 | 18 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/ExecutionDirectivesExamplesTest.java#handleExceptions 19 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/execution-directives/handleRejections.rst: -------------------------------------------------------------------------------- 1 | .. _-handleRejections-java-: 2 | 3 | handleRejections 4 | ================ 5 | 6 | Description 7 | ----------- 8 | 9 | Using this directive is an alternative to using a global implicitly defined ``RejectionHandler`` that 10 | applies to the complete route. 11 | 12 | See :ref:`rejections-java` for general information about options for handling rejections. 13 | 14 | Example 15 | ------- 16 | 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/ExecutionDirectivesExamplesTest.java#handleRejections 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/execution-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _ExecutionDirectives-java: 2 | 3 | ExecutionDirectives 4 | =================== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | handleExceptions 10 | handleRejections 11 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/file-and-resource-directives/getFromResource.rst: -------------------------------------------------------------------------------- 1 | .. _-getFromResource-java-: 2 | 3 | getFromResource 4 | =============== 5 | 6 | Description 7 | ----------- 8 | 9 | Completes ``GET`` requests with the content of the given classpath resource. 10 | 11 | For details refer to :ref:`-getFromFile-java-` which works the same way but obtaining the file from the filesystem 12 | instead of the applications classpath. 13 | 14 | Note that it's not required to wrap this directive with ``get`` as this directive will only respond to ``GET`` requests. 15 | 16 | Example 17 | ------- 18 | 19 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/FileAndResourceDirectivesExamplesTest.java#getFromResource 20 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/file-and-resource-directives/getFromResourceDirectory.rst: -------------------------------------------------------------------------------- 1 | .. _-getFromResourceDirectory-java-: 2 | 3 | getFromResourceDirectory 4 | ======================== 5 | 6 | Description 7 | ----------- 8 | 9 | Completes ``GET`` requests with the content of the given classpath resource directory. 10 | 11 | For details refer to :ref:`-getFromDirectory-java-` which works the same way but obtaining the file from the filesystem 12 | instead of the applications classpath. 13 | 14 | Note that it's not required to wrap this directive with ``get`` as this directive will only respond to ``GET`` requests. 15 | 16 | Example 17 | ------- 18 | 19 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/FileAndResourceDirectivesExamplesTest.java#getFromResourceDirectory 20 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/file-upload-directives/fileUpload.rst: -------------------------------------------------------------------------------- 1 | .. _-fileUpload-java-: 2 | 3 | fileUpload 4 | ========== 5 | 6 | Description 7 | ----------- 8 | Simple access to the stream of bytes for a file uploaded as a multipart form together with metadata 9 | about the upload as extracted value. 10 | 11 | If there is no field with the given name the request will be rejected, if there are multiple file parts 12 | with the same name, the first one will be used and the subsequent ones ignored. 13 | 14 | 15 | Example 16 | ------- 17 | .. includecode2:: ../../../../code/docs/http/javadsl/server/directives/FileUploadDirectivesExamplesTest.java 18 | :snippet: fileUpload 19 | 20 | :: 21 | 22 | curl --form "csv=@uploadFile.txt" http://: 23 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/file-upload-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _FileUploadDirectives-java: 2 | 3 | FileUploadDirectives 4 | ==================== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | uploadedFile 10 | fileUpload 11 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/form-field-directives/formField.rst: -------------------------------------------------------------------------------- 1 | .. _-formField-java-: 2 | 3 | formField 4 | ========= 5 | 6 | ----------- 7 | Allows extracting a single Form field sent in the request. 8 | 9 | Example 10 | ------- 11 | 12 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/FormFieldDirectivesExamplesTest.java#formField 13 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/form-field-directives/formFieldMap.rst: -------------------------------------------------------------------------------- 1 | .. _-formFieldMap-java-: 2 | 3 | formFieldMap 4 | ============ 5 | 6 | Description 7 | ----------- 8 | Extracts all HTTP form fields at once as a ``Map`` mapping form field names to form field values. 9 | 10 | If form data contain a field value several times, the map will contain the last one. 11 | 12 | Warning 13 | ------- 14 | Use of this directive can result in performance degradation or even in ``OutOfMemoryError`` s. 15 | See :ref:`-formFieldList-java-` for details. 16 | 17 | Example 18 | ------- 19 | 20 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/FormFieldDirectivesExamplesTest.java#formFieldMap 21 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/form-field-directives/formFieldMultiMap.rst: -------------------------------------------------------------------------------- 1 | .. _-formFieldMultiMap-java-: 2 | 3 | formFieldMultiMap 4 | ================= 5 | 6 | Description 7 | ----------- 8 | 9 | Extracts all HTTP form fields at once as a multi-map of type ``Map>`` mapping 10 | a form name to a list of all its values. 11 | 12 | This directive can be used if form fields can occur several times. 13 | 14 | The order of values is *not* specified. 15 | 16 | Warning 17 | ------- 18 | Use of this directive can result in performance degradation or even in ``OutOfMemoryError`` s. 19 | 20 | Example 21 | ------- 22 | 23 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/FormFieldDirectivesExamplesTest.java#formFieldMultiMap 24 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/form-field-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _FormFieldDirectives-java: 2 | 3 | FormFieldDirectives 4 | =================== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | formField 10 | formFieldList 11 | formFieldMap 12 | formFieldMultiMap 13 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/future-directives/completeOrRecoverWith.rst: -------------------------------------------------------------------------------- 1 | .. _-completeOrRecoverWith-java-: 2 | 3 | completeOrRecoverWith 4 | ===================== 5 | 6 | Description 7 | ----------- 8 | "Unwraps" a ``CompletionStage`` and runs the inner route when the stage has failed 9 | with the stage's failure exception as an extraction of type ``Throwable``. 10 | If the completion stage succeeds the request is completed using the values marshaller 11 | (This directive therefore requires a marshaller for the completion stage value type to be 12 | provided.) 13 | 14 | To handle the successful case manually as well, use the :ref:`-onComplete-java-` directive, instead. 15 | 16 | Example 17 | ------- 18 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/FutureDirectivesExamplesTest.java#completeOrRecoverWith 19 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/future-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _FutureDirectives-java: 2 | 3 | FuturesDirectives 4 | ================= 5 | 6 | Future directives can be used to run inner routes once the provided ``Future[T]`` has been completed. 7 | 8 | .. toctree:: 9 | :maxdepth: 1 10 | 11 | onComplete 12 | onCompleteWithBreaker 13 | onSuccess 14 | completeOrRecoverWith 15 | 16 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/future-directives/onComplete.rst: -------------------------------------------------------------------------------- 1 | .. _-onComplete-java-: 2 | 3 | onComplete 4 | ========== 5 | 6 | Description 7 | ----------- 8 | Evaluates its parameter of type ``CompletionStage``, and once it has been completed, extracts its 9 | result as a value of type ``Try`` and passes it to the inner route. A ``Try`` can either be a ``Success`` containing 10 | the ``T`` value or a ``Failure`` containing the ``Throwable``. 11 | 12 | To handle the ``Failure`` case automatically and only work with the result value, use :ref:`-onSuccess-java-`. 13 | 14 | To complete with a successful result automatically and just handle the failure result, use :ref:`-completeOrRecoverWith-java-`, instead. 15 | 16 | Example 17 | ------- 18 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/FutureDirectivesExamplesTest.java#onComplete 19 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/future-directives/onSuccess.rst: -------------------------------------------------------------------------------- 1 | .. _-onSuccess-java-: 2 | 3 | onSuccess 4 | ========= 5 | 6 | Description 7 | ----------- 8 | Evaluates its parameter of type ``CompletionStage``, and once it has been completed successfully, 9 | extracts its result as a value of type ``T`` and passes it to the inner route. 10 | 11 | If the future fails its failure throwable is bubbled up to the nearest ``ExceptionHandler``. 12 | 13 | To handle the ``Failure`` case manually as well, use :ref:`-onComplete-java-`, instead. 14 | 15 | Example 16 | ------- 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/FutureDirectivesExamplesTest.java#onSuccess 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/header-directives/checkSameOrigin.rst: -------------------------------------------------------------------------------- 1 | .. _-checkSameOrigin-java-: 2 | 3 | checkSameOrigin 4 | =============== 5 | 6 | Description 7 | ----------- 8 | Checks that request comes from the same origin. Extracts the ``Origin`` header value and verifies that allowed range 9 | contains the obtained value. In the case of absent of the ``Origin`` header rejects with a ``MissingHeaderRejection``. 10 | If the origin value is not in the allowed range rejects with an ``InvalidOriginHeaderRejection`` 11 | and ``StatusCodes.FORBIDDEN`` status. 12 | 13 | Example 14 | ------- 15 | Checking the ``Origin`` header: 16 | 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/HeaderDirectivesExamplesTest.java#checkSameOrigin 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/header-directives/headerValueByName.rst: -------------------------------------------------------------------------------- 1 | .. _-headerValueByName-java-: 2 | 3 | headerValueByName 4 | ================= 5 | 6 | Description 7 | ----------- 8 | Extracts the value of the HTTP request header with the given name. 9 | 10 | If no header with a matching name is found the request is rejected with a ``MissingHeaderRejection``. 11 | 12 | If the header is expected to be missing in some cases or to customize 13 | handling when the header is missing use the :ref:`-optionalHeaderValueByName-java-` directive instead. 14 | 15 | Example 16 | ------- 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/HeaderDirectivesExamplesTest.java#headerValueByName -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/header-directives/headerValuePF.rst: -------------------------------------------------------------------------------- 1 | .. _-headerValuePF-java-: 2 | 3 | headerValuePF 4 | ============= 5 | 6 | Description 7 | ----------- 8 | Calls the specified partial function with the first request header the function is ``isDefinedAt`` and extracts the 9 | result of calling the function. 10 | 11 | The ``headerValuePF`` directive is an alternative syntax version of :ref:`-headerValue-java-`. 12 | 13 | If the function throws an exception the request is rejected with a ``MalformedHeaderRejection``. 14 | 15 | If the function is not defined for any header the request is rejected as "NotFound". 16 | 17 | Example 18 | ------- 19 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/HeaderDirectivesExamplesTest.java#headerValuePF -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/header-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _HeaderDirectives-java: 2 | 3 | HeaderDirectives 4 | ================ 5 | 6 | Header directives can be used to extract header values from the request. To change 7 | response headers use one of the :ref:`RespondWithDirectives-java`. 8 | 9 | .. toctree:: 10 | :maxdepth: 1 11 | 12 | headerValue 13 | headerValueByName 14 | headerValueByType 15 | headerValuePF 16 | optionalHeaderValue 17 | optionalHeaderValueByName 18 | optionalHeaderValueByType 19 | optionalHeaderValuePF 20 | checkSameOrigin 21 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/header-directives/optionalHeaderValue.rst: -------------------------------------------------------------------------------- 1 | .. _-optionalHeaderValue-java-: 2 | 3 | optionalHeaderValue 4 | =================== 5 | 6 | Description 7 | ----------- 8 | Traverses the list of request headers with the specified function and extracts the first value the function returns as 9 | ``Optional[value]``. 10 | 11 | The ``optionalHeaderValue`` directive is similar to the :ref:`-headerValue-java-` directive but always extracts an ``Option`` 12 | value instead of rejecting the request if no matching header could be found. 13 | 14 | Example 15 | ------- 16 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/HeaderDirectivesExamplesTest.java#optionalHeaderValue -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/header-directives/optionalHeaderValueByName.rst: -------------------------------------------------------------------------------- 1 | .. _-optionalHeaderValueByName-java-: 2 | 3 | optionalHeaderValueByName 4 | ========================= 5 | 6 | Description 7 | ----------- 8 | Optionally extracts the value of the HTTP request header with the given name. 9 | 10 | The ``optionalHeaderValueByName`` directive is similar to the :ref:`-headerValueByName-java-` directive but always extracts 11 | an ``Optional`` value instead of rejecting the request if no matching header could be found. 12 | 13 | Example 14 | ------- 15 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/HeaderDirectivesExamplesTest.java#optionalHeaderValueByName -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/header-directives/optionalHeaderValuePF.rst: -------------------------------------------------------------------------------- 1 | .. _-optionalHeaderValuePF-java-: 2 | 3 | optionalHeaderValuePF 4 | ===================== 5 | 6 | Description 7 | ----------- 8 | Calls the specified partial function with the first request header the function is ``isDefinedAt`` and extracts the 9 | result of calling the function. 10 | 11 | The ``optionalHeaderValuePF`` directive is similar to the :ref:`-headerValuePF-java-` directive but always extracts an ``Optional`` 12 | value instead of rejecting the request if no matching header could be found. 13 | 14 | Example 15 | ------- 16 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/HeaderDirectivesExamplesTest.java#optionalHeaderValuePF -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/host-directives/extractHostName.rst: -------------------------------------------------------------------------------- 1 | .. _-extractHost-java-: 2 | 3 | extractHostName 4 | =============== 5 | 6 | Extract the hostname part of the ``Host`` request header and expose it as a ``String`` extraction 7 | to its inner route. 8 | 9 | 10 | Example 11 | ------- 12 | 13 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/HostDirectivesExamplesTest.java#extractHostname 14 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/host-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _HostDirectives-java: 2 | 3 | HostDirectives 4 | ============== 5 | 6 | HostDirectives allow you to filter requests based on the hostname part of the ``Host`` header 7 | contained in incoming requests as well as extracting its value for usage in inner routes. 8 | 9 | .. toctree:: 10 | :maxdepth: 1 11 | 12 | host 13 | extractHostName 14 | 15 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/method-directives/delete.rst: -------------------------------------------------------------------------------- 1 | .. _-delete-java-: 2 | 3 | delete 4 | ====== 5 | Matches requests with HTTP method ``DELETE``. 6 | 7 | Description 8 | ----------- 9 | 10 | This directive filters an incoming request by its HTTP method. Only requests with 11 | method ``DELETE`` are passed on to the inner route. All others are rejected with a 12 | ``MethodRejection``, which is translated into a ``405 Method Not Allowed`` response 13 | by the default ``RejectionHandler``. 14 | 15 | 16 | Example 17 | ------- 18 | 19 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/MethodDirectivesExamplesTest.java#delete 20 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/method-directives/get.rst: -------------------------------------------------------------------------------- 1 | .. _-get-java-: 2 | 3 | get 4 | === 5 | Matches requests with HTTP method ``GET``. 6 | 7 | Description 8 | ----------- 9 | 10 | This directive filters the incoming request by its HTTP method. Only requests with 11 | method ``GET`` are passed on to the inner route. All others are rejected with a 12 | ``MethodRejection``, which is translated into a ``405 Method Not Allowed`` response 13 | by the default ``RejectionHandler``. 14 | 15 | 16 | Example 17 | ------- 18 | 19 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/MethodDirectivesExamplesTest.java#get 20 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/method-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _MethodDirectives-java: 2 | 3 | MethodDirectives 4 | ================ 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | delete 10 | extractMethod 11 | get 12 | head 13 | method 14 | options 15 | overrideMethodWithParameter 16 | patch 17 | post 18 | put 19 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/method-directives/method.rst: -------------------------------------------------------------------------------- 1 | .. _-method-java-: 2 | 3 | method 4 | ====== 5 | 6 | Matches HTTP requests based on their method. 7 | 8 | Description 9 | ----------- 10 | 11 | This directive filters the incoming request by its HTTP method. Only requests with 12 | the specified method are passed on to the inner route. All others are rejected with a 13 | ``MethodRejection``, which is translated into a ``405 Method Not Allowed`` response 14 | by the default ``RejectionHandler``. 15 | 16 | Example 17 | ------- 18 | 19 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/MethodDirectivesExamplesTest.java#method-example 20 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/method-directives/options.rst: -------------------------------------------------------------------------------- 1 | .. _-options-java-: 2 | 3 | options 4 | ======= 5 | Matches requests with HTTP method ``OPTIONS``. 6 | 7 | Description 8 | ----------- 9 | 10 | This directive filters the incoming request by its HTTP method. Only requests with 11 | method ``OPTIONS`` are passed on to the inner route. All others are rejected with a 12 | ``MethodRejection``, which is translated into a ``405 Method Not Allowed`` response 13 | by the default ``RejectionHandler``. 14 | 15 | Example 16 | ------- 17 | 18 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/MethodDirectivesExamplesTest.java#options 19 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/method-directives/patch.rst: -------------------------------------------------------------------------------- 1 | .. _-patch-java-: 2 | 3 | patch 4 | ===== 5 | 6 | Matches requests with HTTP method ``PATCH``. 7 | 8 | Description 9 | ----------- 10 | 11 | This directive filters the incoming request by its HTTP method. Only requests with 12 | method ``PATCH`` are passed on to the inner route. All others are rejected with a 13 | ``MethodRejection``, which is translated into a ``405 Method Not Allowed`` response 14 | by the default ``RejectionHandler``. 15 | 16 | 17 | Example 18 | ------- 19 | 20 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/MethodDirectivesExamplesTest.java#patch 21 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/method-directives/post.rst: -------------------------------------------------------------------------------- 1 | .. _-post-java-: 2 | 3 | post 4 | ==== 5 | 6 | Matches requests with HTTP method ``POST``. 7 | 8 | Description 9 | ----------- 10 | 11 | This directive filters the incoming request by its HTTP method. Only requests with 12 | method ``POST`` are passed on to the inner route. All others are rejected with a 13 | ``MethodRejection``, which is translated into a ``405 Method Not Allowed`` response 14 | by the default ``RejectionHandler``. 15 | 16 | 17 | Example 18 | ------- 19 | 20 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/MethodDirectivesExamplesTest.java#post 21 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/method-directives/put.rst: -------------------------------------------------------------------------------- 1 | .. _-put-java-: 2 | 3 | put 4 | === 5 | 6 | Matches requests with HTTP method ``PUT``. 7 | 8 | Description 9 | ----------- 10 | 11 | This directive filters the incoming request by its HTTP method. Only requests with 12 | method ``PUT`` are passed on to the inner route. All others are rejected with a 13 | ``MethodRejection``, which is translated into a ``405 Method Not Allowed`` response 14 | by the default ``RejectionHandler``. 15 | 16 | Example 17 | ------- 18 | 19 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/MethodDirectivesExamplesTest.java#put 20 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/misc-directives/extractClientIP.rst: -------------------------------------------------------------------------------- 1 | .. _-extractClientIP-java-: 2 | 3 | extractClientIP 4 | =============== 5 | 6 | Description 7 | ----------- 8 | Provides the value of ``X-Forwarded-For``, ``Remote-Address``, or ``X-Real-IP`` headers as an instance of ``HttpIp``. 9 | 10 | The akka-http server engine adds the ``Remote-Address`` header to every request automatically if the respective 11 | setting ``akka.http.server.remote-address-header`` is set to ``on``. Per default it is set to ``off``. 12 | 13 | Example 14 | ------- 15 | TODO: Example snippets for JavaDSL are subject to community contributions! Help us complete the docs, read more about it here: `write example snippets for Akka HTTP Java DSL #20466 `_. 16 | 17 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/misc-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _MiscDirectives-java: 2 | 3 | MiscDirectives 4 | ============== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | extractClientIP 10 | rejectEmptyResponse 11 | requestEntityEmpty 12 | requestEntityPresent 13 | selectPreferredLanguage 14 | validate 15 | withoutSizeLimit 16 | withSizeLimit 17 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/misc-directives/rejectEmptyResponse.rst: -------------------------------------------------------------------------------- 1 | .. _-rejectEmptyResponse-java-: 2 | 3 | rejectEmptyResponse 4 | =================== 5 | 6 | Description 7 | ----------- 8 | Replaces a response with no content with an empty rejection. 9 | 10 | The ``rejectEmptyResponse`` directive is mostly used with marshalling ``Option[T]`` instances. The value ``None`` is 11 | usually marshalled to an empty but successful result. In many cases ``None`` should instead be handled as 12 | ``404 Not Found`` which is the effect of using ``rejectEmptyResponse``. 13 | 14 | Example 15 | ------- 16 | TODO: Example snippets for JavaDSL are subject to community contributions! Help us complete the docs, read more about it here: `write example snippets for Akka HTTP Java DSL #20466 `_. 17 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/misc-directives/requestEntityEmpty.rst: -------------------------------------------------------------------------------- 1 | .. _-requestEntityEmpty-java-: 2 | 3 | requestEntityEmpty 4 | ================== 5 | 6 | Description 7 | ----------- 8 | A filter that checks if the request entity is empty and only then passes processing to the inner route. 9 | Otherwise, the request is rejected. 10 | 11 | 12 | See also :ref:`-requestEntityPresent-java-` for the opposite effect. 13 | 14 | 15 | Example 16 | ------- 17 | TODO: Example snippets for JavaDSL are subject to community contributions! Help us complete the docs, read more about it here: `write example snippets for Akka HTTP Java DSL #20466 `_. 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/misc-directives/requestEntityPresent.rst: -------------------------------------------------------------------------------- 1 | .. _-requestEntityPresent-java-: 2 | 3 | requestEntityPresent 4 | ==================== 5 | 6 | Description 7 | ----------- 8 | A simple filter that checks if the request entity is present and only then passes processing to the inner route. 9 | Otherwise, the request is rejected. 10 | 11 | See also :ref:`-requestEntityEmpty-java-` for the opposite effect. 12 | 13 | 14 | Example 15 | ------- 16 | TODO: Example snippets for JavaDSL are subject to community contributions! Help us complete the docs, read more about it here: `write example snippets for Akka HTTP Java DSL #20466 `_. 17 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/misc-directives/validate.rst: -------------------------------------------------------------------------------- 1 | .. _-validate-java-: 2 | 3 | validate 4 | ======== 5 | Allows validating a precondition before handling a route. 6 | 7 | Description 8 | ----------- 9 | Checks an arbitrary condition and passes control to the inner route if it returns ``true``. 10 | Otherwise, rejects the request with a ``ValidationRejection`` containing the given error message. 11 | 12 | Example 13 | ------- 14 | TODO: Example snippets for JavaDSL are subject to community contributions! Help us complete the docs, read more about it here: `write example snippets for Akka HTTP Java DSL #20466 `_. 15 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/misc-directives/withoutSizeLimit.rst: -------------------------------------------------------------------------------- 1 | .. _-withoutSizeLimit-java-: 2 | 3 | withoutSizeLimit 4 | ================ 5 | 6 | Description 7 | ----------- 8 | Skips request entity size verification. 9 | 10 | The whole mechanism of entity size checking is intended to prevent certain Denial-of-Service attacks. 11 | So suggested setup is to have ``akka.http.parsing.max-content-length`` relatively low and use ``withoutSizeLimit`` 12 | directive just for endpoints for which size verification should not be performed. 13 | 14 | See also :ref:`-withSizeLimit-java-` for setting request entity size limit. 15 | 16 | Example 17 | ------- 18 | 19 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/MiscDirectivesExamplesTest.java#withSizeLimitExample 20 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/parameter-directives/parameter.rst: -------------------------------------------------------------------------------- 1 | .. _-parameter-java-: 2 | 3 | parameter 4 | ========= 5 | Extracts a *query* parameter value from the request. 6 | 7 | Description 8 | ----------- 9 | See :ref:`-parameter-java-` for a detailed description of this directive. 10 | 11 | See :ref:`which-parameter-directive-java` to understand when to use which directive. 12 | 13 | Example 14 | ------- 15 | 16 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/ParameterDirectivesExamplesTest.java#parameter 17 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/parameter-directives/parameterMap.rst: -------------------------------------------------------------------------------- 1 | .. _-parameterMap-java-: 2 | 3 | parameterMap 4 | ============ 5 | Extracts all parameters at once as a ``Map`` mapping parameter names to parameter values. 6 | 7 | Description 8 | ----------- 9 | If a query contains a parameter value several times, the map will contain the last one. 10 | 11 | See also :ref:`which-parameter-directive-java` to understand when to use which directive. 12 | 13 | Example 14 | ------- 15 | 16 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/ParameterDirectivesExamplesTest.java#parameterMap 17 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/parameter-directives/parameterMultiMap.rst: -------------------------------------------------------------------------------- 1 | .. _-parameterMultiMap-java-: 2 | 3 | parameterMultiMap 4 | ================= 5 | 6 | Description 7 | ----------- 8 | 9 | Extracts all parameters at once as a multi-map of type ``Map>`` mapping 10 | a parameter name to a list of all its values. 11 | 12 | This directive can be used if parameters can occur several times. 13 | 14 | The order of values is *not* specified. 15 | 16 | See :ref:`which-parameter-directive-java` to understand when to use which directive. 17 | 18 | Example 19 | ------- 20 | 21 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/ParameterDirectivesExamplesTest.java#parameterMultiMap 22 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/parameter-directives/parameterSeq.rst: -------------------------------------------------------------------------------- 1 | .. _-parameterList-java-: 2 | 3 | parameterList 4 | ============= 5 | 6 | Description 7 | ----------- 8 | Extracts all parameters at once in the original order as (name, value) tuples of type ``Map.Entry``. 9 | 10 | This directive can be used if the exact order of parameters is important or if parameters can occur several times. 11 | 12 | See :ref:`which-parameter-directive-java` to understand when to use which directive. 13 | 14 | Example 15 | ------- 16 | 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/ParameterDirectivesExamplesTest.java#parameterSeq 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/parameter-directives/parameters.rst: -------------------------------------------------------------------------------- 1 | .. _-parameters-java-: 2 | 3 | parameters 4 | ========== 5 | Extracts multiple *query* parameter values from the request. 6 | 7 | Description 8 | ----------- 9 | 10 | See :ref:`which-parameter-directive-java` to understand when to use which directive. 11 | 12 | Example 13 | ------- 14 | 15 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/ParameterDirectivesExamplesTest.java#parameters 16 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/path-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _PathDirectives-java: 2 | 3 | PathDirectives 4 | ============== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | path 10 | pathEnd 11 | pathEndOrSingleSlash 12 | pathPrefix 13 | pathPrefixTest 14 | pathSingleSlash 15 | pathSuffix 16 | pathSuffixTest 17 | rawPathPrefix 18 | rawPathPrefixTest 19 | redirectToNoTrailingSlashIfPresent 20 | redirectToTrailingSlashIfMissing 21 | ../path-directives 22 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/path-directives/pathEnd.rst: -------------------------------------------------------------------------------- 1 | .. _-pathEnd-java-: 2 | 3 | pathEnd 4 | ======= 5 | 6 | Description 7 | ----------- 8 | Only passes the request to its inner route if the unmatched path of the ``RequestContext`` is empty, i.e. the request 9 | path has been fully matched by a higher-level :ref:`-path-java-` or :ref:`-pathPrefix-java-` directive. 10 | 11 | 12 | This directive is a simple alias for ``rawPathPrefix(PathEnd)`` and is mostly used on an 13 | inner-level to discriminate "path already fully matched" from other alternatives (see the example below). 14 | 15 | 16 | Example 17 | ------- 18 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/PathDirectivesExamplesTest.java#path-end 19 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/path-directives/pathEndOrSingleSlash.rst: -------------------------------------------------------------------------------- 1 | .. _-pathEndOrSingleSlash-java-: 2 | 3 | pathEndOrSingleSlash 4 | ==================== 5 | 6 | Description 7 | ----------- 8 | Only passes the request to its inner route if the unmatched path of the ``RequestContext`` is either empty 9 | or contains only one single slash. 10 | 11 | This directive is a simple alias for ``rawPathPrefix(Slash.? ~ PathEnd)`` and is mostly used on an inner-level to 12 | discriminate "path already fully matched" from other alternatives (see the example below). 13 | 14 | It is equivalent to ``pathEnd | pathSingleSlash`` but slightly more efficient. 15 | 16 | 17 | Example 18 | ------- 19 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/PathDirectivesExamplesTest.java#path-end-or-single-slash 20 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/path-directives/pathSingleSlash.rst: -------------------------------------------------------------------------------- 1 | .. _-pathSingleSlash-java-: 2 | 3 | pathSingleSlash 4 | =============== 5 | 6 | Description 7 | ----------- 8 | Only passes the request to its inner route if the unmatched path of the ``RequestContext`` 9 | contains exactly one single slash. 10 | 11 | This directive is a simple alias for ``pathPrefix(PathEnd)`` and is mostly used for matching requests to the root URI 12 | (``/``) on an inner-level to discriminate "all path segments matched" from other alternatives (see the example below). 13 | 14 | 15 | Example 16 | ------- 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/PathDirectivesExamplesTest.java#path-single-slash 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/range-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _RangeDirectives-java: 2 | 3 | RangeDirectives 4 | =============== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | withRangeSupport 10 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/respond-with-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _RespondWithDirectives-java: 2 | 3 | RespondWithDirectives 4 | ===================== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | respondWithDefaultHeader 10 | respondWithDefaultHeaders 11 | respondWithHeader 12 | respondWithHeaders 13 | respondWithHeaders 14 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/respond-with-directives/respondWithHeader.rst: -------------------------------------------------------------------------------- 1 | .. _-respondWithHeader-java-: 2 | 3 | respondWithHeader 4 | ================= 5 | 6 | Description 7 | ----------- 8 | Adds a given HTTP header to all responses coming back from its inner route. 9 | 10 | This directive transforms ``HttpResponse`` and ``ChunkedResponseStart`` messages coming back from its inner route by 11 | adding the given ``HttpHeader`` instance to the headers list. 12 | 13 | See also :ref:`-respondWithHeaders-java-` if you'd like to add more than one header. 14 | 15 | Example 16 | ------- 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/RespondWithDirectivesExamplesTest.java#respondWithHeader 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/respond-with-directives/respondWithHeaders.rst: -------------------------------------------------------------------------------- 1 | .. _-respondWithHeaders-java-: 2 | 3 | respondWithHeaders 4 | ================== 5 | 6 | Description 7 | ----------- 8 | Adds the given HTTP headers to all responses coming back from its inner route. 9 | 10 | This directive transforms ``HttpResponse`` and ``ChunkedResponseStart`` messages coming back from its inner route by 11 | adding the given ``HttpHeader`` instances to the headers list. 12 | 13 | See also :ref:`-respondWithHeader-java-` if you'd like to add just a single header. 14 | 15 | 16 | Example 17 | ------- 18 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/RespondWithDirectivesExamplesTest.java#respondWithHeaders 19 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/route-directives/complete.rst: -------------------------------------------------------------------------------- 1 | .. _-complete-java-: 2 | 3 | complete 4 | ======== 5 | 6 | Description 7 | ----------- 8 | 9 | Completes the request using the given argument(s). 10 | 11 | ``complete`` uses the given arguments to construct a ``Route`` which simply calls ``complete`` on the ``RequestContext`` 12 | with the respective ``HttpResponse`` instance. 13 | Completing the request will send the response "back up" the route structure where all the logic runs that wrapping 14 | directives have potentially chained into the :class:`RouteResult` future transformation chain. 15 | 16 | Please note that the ``complete`` directive has multiple variants, like 17 | 18 | Example 19 | ------- 20 | 21 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/RouteDirectivesExamplesTest.java#complete 22 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/route-directives/redirect.rst: -------------------------------------------------------------------------------- 1 | .. _-redirect-java-: 2 | 3 | redirect 4 | ======== 5 | 6 | Description 7 | ----------- 8 | Completes the request with a redirection response to a given targer URI and of a given redirection type (status code). 9 | 10 | ``redirect`` is a convenience helper for completing the request with a redirection response. 11 | It is equivalent to this snippet relying on the ``complete`` directive: 12 | 13 | 14 | Example 15 | ------- 16 | 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/RouteDirectivesExamplesTest.java#redirect 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/scheme-directives/extractScheme.rst: -------------------------------------------------------------------------------- 1 | .. _-extractScheme-java-: 2 | 3 | extractScheme 4 | ============= 5 | 6 | Description 7 | ----------- 8 | Extracts the Uri scheme (i.e. "``http``", "``https``", etc.) for an incoming request. 9 | 10 | For rejecting a request if it doesn't match a specified scheme name, see the :ref:`-scheme-java-` directive. 11 | 12 | Example 13 | ------- 14 | 15 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/SchemeDirectivesExamplesTest.java#extractScheme 16 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/scheme-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _SchemeDirectives-java: 2 | 3 | SchemeDirectives 4 | ================ 5 | 6 | Scheme directives can be used to extract the Uri scheme (i.e. "http", "https", etc.) 7 | from requests or to reject any request that does not match a specified scheme name. 8 | 9 | .. toctree:: 10 | :maxdepth: 1 11 | 12 | extractScheme 13 | scheme 14 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/scheme-directives/scheme.rst: -------------------------------------------------------------------------------- 1 | .. _-scheme-java-: 2 | 3 | scheme 4 | ====== 5 | 6 | Description 7 | ----------- 8 | Rejects a request if its Uri scheme does not match a given one. 9 | 10 | The ``scheme`` directive can be used to match requests by their Uri scheme, only passing 11 | through requests that match the specified scheme and rejecting all others. 12 | 13 | A typical use case for the ``scheme`` directive would be to reject requests coming in over 14 | http instead of https, or to redirect such requests to the matching https URI with a 15 | ``MovedPermanently``. 16 | 17 | For simply extracting the scheme name, see the :ref:`-extractScheme-java-` directive. 18 | 19 | Example 20 | ------- 21 | 22 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/SchemeDirectivesExamplesTest.java#scheme 23 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/security-directives/extractCredentials.rst: -------------------------------------------------------------------------------- 1 | .. _-extractCredentials-java-: 2 | 3 | extractCredentials 4 | ================== 5 | 6 | Description 7 | ----------- 8 | 9 | Extracts the potentially present ``HttpCredentials`` provided with the request's ``Authorization`` header, 10 | which can be then used to implement some custom authentication or authorization logic. 11 | 12 | See :ref:`credentials-and-timing-attacks-java` for details about verifying the secret. 13 | 14 | Example 15 | ------- 16 | 17 | .. includecode:: ../../../../code/docs/http/javadsl/server/directives/SecurityDirectivesExamplesTest.java#extractCredentials 18 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/timeout-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _TimeoutDirectives-java: 2 | 3 | TimeoutDirectives 4 | ================= 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | withRequestTimeout 10 | withoutRequestTimeout 11 | withRequestTimeoutResponse 12 | -------------------------------------------------------------------------------- /rst/java/http/routing-dsl/directives/websocket-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _WebSocketDirectives-java: 2 | 3 | WebSocketDirectives 4 | =================== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | handleWebSocketMessages 10 | handleWebSocketMessagesForProtocol 11 | -------------------------------------------------------------------------------- /rst/java/index-actors.rst: -------------------------------------------------------------------------------- 1 | Actors 2 | ====== 3 | 4 | .. toctree:: 5 | :maxdepth: 2 6 | 7 | untyped-actors 8 | typed-actors 9 | fault-tolerance 10 | dispatchers 11 | mailboxes 12 | routing 13 | fsm 14 | persistence 15 | persistence-schema-evolution 16 | persistence-query 17 | persistence-query-leveldb 18 | testing 19 | -------------------------------------------------------------------------------- /rst/java/index-futures.rst: -------------------------------------------------------------------------------- 1 | Futures and Agents 2 | ================== 3 | 4 | .. toctree:: 5 | :maxdepth: 2 6 | 7 | futures 8 | agents 9 | -------------------------------------------------------------------------------- /rst/java/index-network.rst: -------------------------------------------------------------------------------- 1 | Networking 2 | ========== 3 | 4 | .. toctree:: 5 | :maxdepth: 2 6 | 7 | ../common/cluster 8 | cluster-usage 9 | cluster-singleton 10 | distributed-pub-sub 11 | cluster-client 12 | cluster-sharding 13 | cluster-metrics 14 | distributed-data 15 | remoting 16 | remoting-artery 17 | serialization 18 | io 19 | io-tcp 20 | io-udp 21 | camel 22 | -------------------------------------------------------------------------------- /rst/java/index-utilities.rst: -------------------------------------------------------------------------------- 1 | Utilities 2 | ========= 3 | 4 | .. toctree:: 5 | :maxdepth: 2 6 | 7 | event-bus 8 | logging 9 | scheduler 10 | ../common/duration 11 | ../common/circuitbreaker 12 | extending-akka 13 | ../intro/deployment-scenarios 14 | 15 | -------------------------------------------------------------------------------- /rst/java/stream/index.rst: -------------------------------------------------------------------------------- 1 | .. _streams-java: 2 | 3 | Streams 4 | ======= 5 | 6 | .. toctree:: 7 | :maxdepth: 2 8 | 9 | stream-introduction 10 | stream-quickstart 11 | ../../general/stream/stream-design 12 | stream-flows-and-basics 13 | stream-graphs 14 | stream-composition 15 | stream-rate 16 | stream-dynamic 17 | stream-customize 18 | stream-integrations 19 | stream-error 20 | stream-io 21 | stream-parallelism 22 | stream-testkit 23 | stages-overview 24 | stream-cookbook 25 | ../../general/stream/stream-configuration 26 | migration-guide-1.0-2.x-java 27 | migration-guide-2.0-2.4-java 28 | -------------------------------------------------------------------------------- /rst/java/stream/migration-guide-1.0-2.x-java.rst: -------------------------------------------------------------------------------- 1 | .. _migration-2.0-java: 2 | 3 | ########################## 4 | Migration Guide 1.0 to 2.x 5 | ########################## 6 | 7 | For this migration guide see `the documentation for Akka Streams 2.0`_. 8 | 9 | .. _`the documentation for Akka Streams 2.0`: http://doc.akka.io/docs/akka-stream-and-http-experimental/2.0.2/java/migration-guide-1.0-2.x-java.html 10 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/additional/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../additional/index.rst:2 21 | msgid "Additional Information" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/dev/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../dev/index.rst:2 21 | msgid "Information for Akka Developers" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/general/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../general/index.rst:2 21 | msgid "General" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/general/stream/stream-configuration.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../general/stream/stream-configuration.rst:5 21 | msgid "Configuration" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../index.rst:2 21 | msgid "Contents" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/intro/index-java.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../intro/index-java.rst:2 21 | msgid "Introduction" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/intro/index-scala.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../intro/index-scala.rst:2 21 | msgid "Introduction" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java.rst:4 21 | msgid "Java Documentation" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/http/routing-dsl/directives/coding-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/http/routing-dsl/directives/coding-directives/index.rst:4 21 | msgid "CodingDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/http/routing-dsl/directives/cookie-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/http/routing-dsl/directives/cookie-directives/index.rst:4 21 | msgid "CookieDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/http/routing-dsl/directives/debugging-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/http/routing-dsl/directives/debugging-directives/index.rst:4 21 | msgid "DebuggingDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/http/routing-dsl/directives/execution-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/http/routing-dsl/directives/execution-directives/index.rst:4 21 | msgid "ExecutionDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/http/routing-dsl/directives/form-field-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/http/routing-dsl/directives/form-field-directives/index.rst:4 21 | msgid "FormFieldDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/http/routing-dsl/directives/method-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/http/routing-dsl/directives/method-directives/index.rst:4 21 | msgid "MethodDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/http/routing-dsl/directives/misc-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/http/routing-dsl/directives/misc-directives/index.rst:4 21 | msgid "MiscDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/http/routing-dsl/directives/path-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/http/routing-dsl/directives/path-directives/index.rst:4 21 | msgid "PathDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/http/routing-dsl/directives/range-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/http/routing-dsl/directives/range-directives/index.rst:4 21 | msgid "RangeDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/http/routing-dsl/directives/timeout-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/http/routing-dsl/directives/timeout-directives/index.rst:4 21 | msgid "TimeoutDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/http/routing-dsl/directives/websocket-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/http/routing-dsl/directives/websocket-directives/index.rst:4 21 | msgid "WebSocketDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/index-actors.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/index-actors.rst:2 21 | msgid "Actors" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/index-futures.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/index-futures.rst:2 21 | msgid "Futures and Agents" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/index-network.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/index-network.rst:2 21 | msgid "Networking" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/index-utilities.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/index-utilities.rst:2 21 | msgid "Utilities" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/java/stream/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../java/stream/index.rst:4 21 | msgid "Streams" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/project/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../project/index.rst:2 21 | msgid "Project Information" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/project/migration-guides.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../project/migration-guides.rst:4 21 | msgid "Migration Guides" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/scala.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../scala.rst:4 21 | msgid "Scala Documentation" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/scala/http/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../scala/http/index.rst:4 21 | msgid "Akka HTTP" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/scala/http/routing-dsl/directives/coding-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../scala/http/routing-dsl/directives/coding-directives/index.rst:4 21 | msgid "CodingDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/scala/http/routing-dsl/directives/cookie-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../scala/http/routing-dsl/directives/cookie-directives/index.rst:4 21 | msgid "CookieDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/scala/http/routing-dsl/directives/method-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../scala/http/routing-dsl/directives/method-directives/index.rst:4 21 | msgid "MethodDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/scala/http/routing-dsl/directives/misc-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../scala/http/routing-dsl/directives/misc-directives/index.rst:4 21 | msgid "MiscDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/scala/http/routing-dsl/directives/path-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../scala/http/routing-dsl/directives/path-directives/index.rst:4 21 | msgid "PathDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/scala/http/routing-dsl/directives/range-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../scala/http/routing-dsl/directives/range-directives/index.rst:4 21 | msgid "RangeDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/scala/http/routing-dsl/directives/timeout-directives/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../scala/http/routing-dsl/directives/timeout-directives/index.rst:4 21 | msgid "TimeoutDirectives" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/scala/index-actors.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../scala/index-actors.rst:2 21 | msgid "Actors" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/scala/index-futures.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../scala/index-futures.rst:2 21 | msgid "Futures and Agents" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/scala/index-network.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../scala/index-network.rst:2 21 | msgid "Networking" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/scala/index-utilities.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../scala/index-utilities.rst:2 21 | msgid "Utilities" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/locale/ja/LC_MESSAGES/scala/stream/index.po: -------------------------------------------------------------------------------- 1 | # SOME DESCRIPTIVE TITLE. 2 | # Copyright (C) 2011-2016, Lightbend Inc 3 | # This file is distributed under the same license as the Akka package. 4 | # FIRST AUTHOR , 2016. 5 | # 6 | #, fuzzy 7 | msgid "" 8 | msgstr "" 9 | "Project-Id-Version: Akka @version@\n" 10 | "Report-Msgid-Bugs-To: \n" 11 | "POT-Creation-Date: 2016-10-03 22:29+0900\n" 12 | "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 13 | "Last-Translator: FULL NAME \n" 14 | "Language-Team: LANGUAGE \n" 15 | "MIME-Version: 1.0\n" 16 | "Content-Type: text/plain; charset=utf-8\n" 17 | "Content-Transfer-Encoding: 8bit\n" 18 | "Generated-By: Babel 2.3.4\n" 19 | 20 | #: ../../scala/stream/index.rst:4 21 | msgid "Streams" 22 | msgstr "" 23 | 24 | -------------------------------------------------------------------------------- /rst/project/index.rst: -------------------------------------------------------------------------------- 1 | Project Information 2 | =================== 3 | 4 | .. toctree:: 5 | :maxdepth: 2 6 | 7 | migration-guides 8 | issue-tracking 9 | licenses 10 | sponsors 11 | links 12 | -------------------------------------------------------------------------------- /rst/project/migration-guide-1.3.x-2.0.x.rst: -------------------------------------------------------------------------------- 1 | .. _migration-2.0: 2 | 3 | ################################ 4 | Migration Guide 1.3.x to 2.0.x 5 | ################################ 6 | 7 | Migration from 1.3.x to 2.0.x is described in the 8 | `documentation of 2.0 `_. 9 | 10 | 11 | -------------------------------------------------------------------------------- /rst/project/migration-guide-2.0.x-2.1.x.rst: -------------------------------------------------------------------------------- 1 | .. _migration-2.1: 2 | 3 | ################################ 4 | Migration Guide 2.0.x to 2.1.x 5 | ################################ 6 | 7 | Migration from 2.0.x to 2.1.x is described in the 8 | `documentation of 2.1 `_. -------------------------------------------------------------------------------- /rst/project/migration-guide-2.1.x-2.2.x.rst: -------------------------------------------------------------------------------- 1 | .. _migration-2.2: 2 | 3 | ################################ 4 | Migration Guide 2.1.x to 2.2.x 5 | ################################ 6 | 7 | Migration from 2.1.x to 2.2.x is described in the 8 | `documentation of 2.2 `_. -------------------------------------------------------------------------------- /rst/project/migration-guide-2.2.x-2.3.x.rst: -------------------------------------------------------------------------------- 1 | .. _migration-2.3: 2 | 3 | ################################ 4 | Migration Guide 2.2.x to 2.3.x 5 | ################################ 6 | 7 | Migration from 2.2.x to 2.3.x is described in the 8 | `documentation of 2.3 `_. -------------------------------------------------------------------------------- /rst/project/migration-guide-2.4.x-2.5.x.rst: -------------------------------------------------------------------------------- 1 | .. _migration-guide-2.4.x-2.5.x: 2 | 3 | ####################################### 4 | Upcoming Migration Guide 2.4.x to 2.5.x 5 | ####################################### 6 | 7 | Akka Persistence 8 | ================ 9 | 10 | Persistence Plugin Proxy 11 | ------------------------ 12 | 13 | A new :ref:`persistence plugin proxy` was added, that allows sharing of an otherwise 14 | non-sharable journal or snapshot store. The proxy is available by setting ``akka.persistence.journal.plugin`` or 15 | ``akka.persistence.snapshot-store.plugin`` to ``akka.persistence.journal.proxy`` or ``akka.persistence.snapshot-store.proxy``, 16 | respectively. The proxy supplants the :ref:`Shared LevelDB journal`. 17 | -------------------------------------------------------------------------------- /rst/project/migration-guides.rst: -------------------------------------------------------------------------------- 1 | .. _migration: 2 | 3 | Migration Guides 4 | ================ 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | migration-guide-1.3.x-2.0.x 10 | migration-guide-2.0.x-2.1.x 11 | migration-guide-2.1.x-2.2.x 12 | migration-guide-2.2.x-2.3.x 13 | migration-guide-persistence-experimental-2.3.x-2.4.x 14 | migration-guide-eventsourced-2.3.x 15 | migration-guide-2.3.x-2.4.x 16 | migration-guide-2.4.x-2.5.x 17 | -------------------------------------------------------------------------------- /rst/scala.rst: -------------------------------------------------------------------------------- 1 | .. _scala-api: 2 | 3 | Scala Documentation 4 | =================== 5 | 6 | .. toctree:: 7 | :maxdepth: 2 8 | 9 | intro/index-scala 10 | general/index 11 | scala/index-actors 12 | scala/index-futures 13 | scala/index-network 14 | scala/index-utilities 15 | scala/stream/index 16 | scala/http/index 17 | scala/howto 18 | experimental/index 19 | dev/index 20 | project/index 21 | additional/index 22 | 23 | -------------------------------------------------------------------------------- /rst/scala/code/docs/CompileOnlySpec.scala: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (C) 2009-2016 Lightbend Inc. 3 | */ 4 | 5 | package docs 6 | 7 | trait CompileOnlySpec { 8 | /** 9 | * Given a block of code... does NOT execute it. 10 | * Useful when writing code samples in tests, which should only be compiled. 11 | */ 12 | def compileOnlySpec(body: => Unit) = () 13 | } 14 | -------------------------------------------------------------------------------- /rst/scala/code/docs/cluster/ClusterDocSpec.scala: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright (C) 2015-2016 Lightbend Inc. 3 | */ 4 | package docs.cluster 5 | 6 | import akka.cluster.Cluster 7 | import akka.testkit.AkkaSpec 8 | 9 | object ClusterDocSpec { 10 | 11 | val config = 12 | """ 13 | akka.actor.provider = "cluster" 14 | akka.remote.netty.tcp.port = 0 15 | """ 16 | } 17 | 18 | class ClusterDocSpec extends AkkaSpec(ClusterDocSpec.config) { 19 | 20 | "demonstrate leave" in { 21 | //#leave 22 | val cluster = Cluster(system) 23 | cluster.leave(cluster.selfAddress) 24 | //#leave 25 | } 26 | 27 | } 28 | -------------------------------------------------------------------------------- /rst/scala/code/docs/http/scaladsl/server/RoutingSpec.scala: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (C) 2009-2016 Lightbend Inc. 3 | */ 4 | 5 | package docs.http.scaladsl.server 6 | 7 | import akka.http.scaladsl.server.Directives 8 | import akka.http.scaladsl.testkit.ScalatestRouteTest 9 | import docs.CompileOnlySpec 10 | import org.scalatest.{ Matchers, WordSpec } 11 | 12 | abstract class RoutingSpec extends WordSpec with Matchers 13 | with Directives with ScalatestRouteTest 14 | with CompileOnlySpec 15 | -------------------------------------------------------------------------------- /rst/scala/code/docs/pattern/ScalaTemplate.scala: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright (C) 2009-2016 Lightbend Inc. 3 | */ 4 | 5 | package docs.pattern 6 | 7 | // this part will not appear in the docs 8 | 9 | //#all-of-it 10 | class ScalaTemplate { 11 | println("Hello, Template!") 12 | //#uninteresting-stuff 13 | // don’t show this plumbimg 14 | //#uninteresting-stuff 15 | } 16 | //#all-of-it 17 | -------------------------------------------------------------------------------- /rst/scala/code/docs/stream/cookbook/RecipeKeepAlive.scala: -------------------------------------------------------------------------------- 1 | package docs.stream.cookbook 2 | 3 | import akka.NotUsed 4 | import akka.stream.ClosedShape 5 | import akka.stream.scaladsl._ 6 | import akka.util.ByteString 7 | 8 | class RecipeKeepAlive extends RecipeSpec { 9 | 10 | "Recipe for injecting keepalive messages" must { 11 | 12 | "work" in { 13 | val keepaliveMessage = ByteString(11) 14 | 15 | //#inject-keepalive 16 | import scala.concurrent.duration._ 17 | val injectKeepAlive: Flow[ByteString, ByteString, NotUsed] = 18 | Flow[ByteString].keepAlive(1.second, () => keepaliveMessage) 19 | //#inject-keepalive 20 | 21 | // No need to test, this is a built-in stage with proper tests 22 | } 23 | } 24 | 25 | } 26 | -------------------------------------------------------------------------------- /rst/scala/code/docs/stream/cookbook/RecipeSpec.scala: -------------------------------------------------------------------------------- 1 | package docs.stream.cookbook 2 | 3 | import akka.stream.ActorMaterializer 4 | import akka.testkit.AkkaSpec 5 | 6 | trait RecipeSpec extends AkkaSpec { 7 | 8 | implicit val m = ActorMaterializer() 9 | type Message = String 10 | type Trigger = Unit 11 | type Job = String 12 | 13 | } 14 | -------------------------------------------------------------------------------- /rst/scala/http/DispatcherBehaviourOnBadCode.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/scala/http/DispatcherBehaviourOnBadCode.png -------------------------------------------------------------------------------- /rst/scala/http/DispatcherBehaviourOnGoodCode.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/scala/http/DispatcherBehaviourOnGoodCode.png -------------------------------------------------------------------------------- /rst/scala/http/DispatcherBehaviourProperBlocking.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/akka-ja/akka-doc-ja/db6edaf325469e6f6c48da03f0eb9023f7dd937f/rst/scala/http/DispatcherBehaviourProperBlocking.png -------------------------------------------------------------------------------- /rst/scala/http/common/index.rst: -------------------------------------------------------------------------------- 1 | .. _http-scala-common-scala: 2 | 3 | Common Abstractions (Client- and Server-Side) 4 | ============================================= 5 | 6 | HTTP and related specifications define a great number of concepts and functionality that is not specific to either 7 | HTTP's client- or server-side since they are meaningful on both end of an HTTP connection. 8 | The documentation for their counterparts in Akka HTTP lives in this section rather than in the ones for the 9 | :ref:`Client-Side API `, :ref:`http-low-level-server-side-api` or :ref:`http-high-level-server-side-api`, 10 | which are specific to one side only. 11 | 12 | 13 | .. toctree:: 14 | :maxdepth: 2 15 | 16 | http-model 17 | marshalling 18 | unmarshalling 19 | de-coding 20 | json-support 21 | xml-support 22 | timeouts 23 | -------------------------------------------------------------------------------- /rst/scala/http/index.rst: -------------------------------------------------------------------------------- 1 | .. _http-scala: 2 | 3 | Akka HTTP 4 | ========= 5 | 6 | .. toctree:: 7 | :maxdepth: 2 8 | 9 | introduction 10 | configuration 11 | common/index 12 | implications-of-streaming-http-entity 13 | low-level-server-side-api 14 | routing-dsl/index 15 | client-side/index 16 | server-side-https-support 17 | handling-blocking-operations-in-akka-http-routes 18 | migration-from-spray 19 | migration-from-old-http-javadsl 20 | migration-guide-2.4.x-experimental 21 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/basic-directives/extractActorSystem.rst: -------------------------------------------------------------------------------- 1 | .. _-extractActorSystem-: 2 | 3 | extractActorSystem 4 | ================== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala 10 | :snippet: extractActorSystem 11 | 12 | Description 13 | ----------- 14 | 15 | Extracts the ``ActorSystem`` from the ``RequestContext``, which can be useful when the external API 16 | in your route needs one. 17 | 18 | .. warning:: 19 | 20 | This is only supported when the available Materializer is an ActorMaterializer. 21 | 22 | Example 23 | ------- 24 | 25 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala 26 | :snippet: extractActorSystem-example 27 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/basic-directives/extractDataBytes.rst: -------------------------------------------------------------------------------- 1 | .. _-extractDataBytes-: 2 | 3 | extractDataBytes 4 | ================ 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala 10 | :snippet: extractDataBytes 11 | 12 | Description 13 | ----------- 14 | 15 | Extracts the entities data bytes as ``Source[ByteString, Any]`` from the :class:`RequestContext`. 16 | 17 | The directive returns a stream containing the request data bytes. 18 | 19 | 20 | Example 21 | ------- 22 | 23 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala 24 | :snippet: extractDataBytes-example 25 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/basic-directives/extractExecutionContext.rst: -------------------------------------------------------------------------------- 1 | .. _-extractExecutionContext-: 2 | 3 | extractExecutionContext 4 | ======================= 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala 10 | :snippet: extractExecutionContext 11 | 12 | Description 13 | ----------- 14 | 15 | Extracts the ``ExecutionContext`` from the ``RequestContext``. 16 | 17 | See :ref:`-withExecutionContext-` to see how to customise the execution context provided for an inner route. 18 | 19 | See :ref:`-extract-` to learn more about how extractions work. 20 | 21 | Example 22 | ------- 23 | 24 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala 25 | :snippet: extractExecutionContext-0 26 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/basic-directives/extractMaterializer.rst: -------------------------------------------------------------------------------- 1 | .. _-extractMaterializer-: 2 | 3 | extractMaterializer 4 | =================== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala 10 | :snippet: extractMaterializer 11 | 12 | Description 13 | ----------- 14 | 15 | Extracts the ``Materializer`` from the ``RequestContext``, which can be useful when you want to run an 16 | Akka Stream directly in your route. 17 | 18 | See also :ref:`-withMaterializer-` to see how to customise the used materializer for specific inner routes. 19 | 20 | Example 21 | ------- 22 | 23 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala 24 | :snippet: extractMaterializer-0 25 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/basic-directives/extractRequestEntity.rst: -------------------------------------------------------------------------------- 1 | .. _-extractRequestEntity-: 2 | 3 | extractRequestEntity 4 | ==================== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala 10 | :snippet: extractRequestEntity 11 | 12 | Description 13 | ----------- 14 | 15 | Extracts the ``RequestEntity`` from the :class:`RequestContext`. 16 | 17 | The directive returns a ``RequestEntity`` without unmarshalling the request. To extract domain entity, 18 | :ref:`-entity-` should be used. 19 | 20 | 21 | Example 22 | ------- 23 | 24 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala 25 | :snippet: extractRequestEntity-example 26 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/basic-directives/extractSettings.rst: -------------------------------------------------------------------------------- 1 | .. _-extractSettings-: 2 | 3 | extractSettings 4 | =============== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala 10 | :snippet: extractSettings 11 | 12 | Description 13 | ----------- 14 | 15 | Extracts the ``RoutingSettings`` from the :class:`RequestContext`. 16 | 17 | By default the settings of the ``Http()`` extension running the route will be returned. 18 | It is possible to override the settings for specific sub-routes by using the :ref:`-withSettings-` directive. 19 | 20 | Example 21 | ------- 22 | 23 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala 24 | :snippet: extractSettings-examples 25 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/basic-directives/extractUri.rst: -------------------------------------------------------------------------------- 1 | .. _-extractUri-: 2 | 3 | extractUri 4 | ========== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala 10 | :snippet: extractUri 11 | 12 | Description 13 | ----------- 14 | Access the full URI of the request. 15 | 16 | Use :ref:`SchemeDirectives`, :ref:`HostDirectives`, :ref:`PathDirectives`, and :ref:`ParameterDirectives` for more 17 | targeted access to parts of the URI. 18 | 19 | Example 20 | ------- 21 | 22 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala 23 | :snippet: extractUri-example 24 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/basic-directives/mapInnerRoute.rst: -------------------------------------------------------------------------------- 1 | .. _-mapInnerRoute-: 2 | 3 | mapInnerRoute 4 | ============= 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala 10 | :snippet: mapInnerRoute 11 | 12 | Description 13 | ----------- 14 | Changes the execution model of the inner route by wrapping it with arbitrary logic. 15 | 16 | The ``mapInnerRoute`` directive is used as a building block for :ref:`Custom Directives` to replace the inner route 17 | with any other route. Usually, the returned route wraps the original one with custom execution logic. 18 | 19 | Example 20 | ------- 21 | 22 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala 23 | :snippet: mapInnerRoute 24 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/basic-directives/mapResponseEntity.rst: -------------------------------------------------------------------------------- 1 | .. _-mapResponseEntity-: 2 | 3 | mapResponseEntity 4 | ================= 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala 10 | :snippet: mapResponseEntity 11 | 12 | Description 13 | ----------- 14 | 15 | The ``mapResponseEntity`` directive is used as a building block for :ref:`Custom Directives` to transform a 16 | response entity that was generated by the inner route. 17 | 18 | See :ref:`Response Transforming Directives` for similar directives. 19 | 20 | Example 21 | ------- 22 | 23 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala 24 | :snippet: mapResponseEntity 25 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/basic-directives/mapRouteResult.rst: -------------------------------------------------------------------------------- 1 | .. _-mapRouteResult-: 2 | 3 | mapRouteResult 4 | ============== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala 10 | :snippet: mapRouteResult 11 | 12 | Description 13 | ----------- 14 | Changes the message the inner route sends to the responder. 15 | 16 | The ``mapRouteResult`` directive is used as a building block for :ref:`Custom Directives` to transform the 17 | :ref:`RouteResult` coming back from the inner route. 18 | 19 | See :ref:`Result Transformation Directives` for similar directives. 20 | 21 | Example 22 | ------- 23 | 24 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala 25 | :snippet: 0mapRouteResult 26 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/basic-directives/mapSettings.rst: -------------------------------------------------------------------------------- 1 | .. _-mapSettings-: 2 | 3 | mapSettings 4 | =========== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala 10 | :snippet: mapSettings 11 | 12 | Description 13 | ----------- 14 | 15 | Transforms the ``RoutingSettings`` with a ``RoutingSettings ⇒ RoutingSettings`` function. 16 | 17 | See also :ref:`-withSettings-` or :ref:`-extractSettings-`. 18 | 19 | Example 20 | ------- 21 | 22 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala 23 | :snippet: withSettings-0 24 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/basic-directives/pass.rst: -------------------------------------------------------------------------------- 1 | .. _-pass-: 2 | 3 | pass 4 | ==== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala 10 | :snippet: pass 11 | 12 | Description 13 | ----------- 14 | A directive that passes the request unchanged to its inner route. 15 | 16 | It is usually used as a "neutral element" when combining directives generically. 17 | 18 | Example 19 | ------- 20 | 21 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala 22 | :snippet: pass 23 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/basic-directives/provide.rst: -------------------------------------------------------------------------------- 1 | .. _-provide-: 2 | 3 | provide 4 | ======= 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala 10 | :snippet: provide 11 | 12 | Description 13 | ----------- 14 | Provides a constant value to the inner route. 15 | 16 | The `provide` directive is used as a building block for :ref:`Custom Directives` to provide a single value to the 17 | inner route. To provide several values use the :ref:`-tprovide-` directive. 18 | 19 | See :ref:`ProvideDirectives` for an overview of similar directives. 20 | 21 | Example 22 | ------- 23 | 24 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala 25 | :snippet: 0provide 26 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/basic-directives/withLog.rst: -------------------------------------------------------------------------------- 1 | .. _-withLog-: 2 | 3 | withLog 4 | ======= 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala 10 | :snippet: withLog 11 | 12 | Description 13 | ----------- 14 | 15 | Allows running an inner route using an alternative :class:`LoggingAdapter` in place of the default one. 16 | 17 | The logging adapter can be extracted in an inner route using :ref:`-extractLog-` directly, 18 | or used by directives which internally extract the materializer without sufracing this fact in the API. 19 | 20 | 21 | Example 22 | ------- 23 | 24 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala 25 | :snippet: 0withLog 26 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/basic-directives/withSettings.rst: -------------------------------------------------------------------------------- 1 | .. _-withSettings-: 2 | 3 | withSettings 4 | ============ 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/BasicDirectives.scala 10 | :snippet: withSettings 11 | 12 | Description 13 | ----------- 14 | 15 | Allows running an inner route using an alternative :class:`RoutingSettings` in place of the default one. 16 | 17 | The execution context can be extracted in an inner route using :ref:`-extractSettings-` directly, 18 | or used by directives which internally extract the materializer without sufracing this fact in the API. 19 | 20 | Example 21 | ------- 22 | 23 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/BasicDirectivesExamplesSpec.scala 24 | :snippet: withSettings-0 25 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/cache-condition-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _CacheConditionDirectives: 2 | 3 | CacheConditionDirectives 4 | ======================== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | conditional -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/coding-directives/decodeRequest.rst: -------------------------------------------------------------------------------- 1 | .. _-decodeRequest-: 2 | 3 | decodeRequest 4 | ============= 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/CodingDirectives.scala 10 | :snippet: decodeRequest 11 | 12 | Description 13 | ----------- 14 | 15 | Decompresses the incoming request if it is ``gzip`` or ``deflate`` compressed. Uncompressed requests are passed through untouched. If the request encoded with another encoding the request is rejected with an ``UnsupportedRequestEncodingRejection``. 16 | 17 | Example 18 | ------- 19 | 20 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/CodingDirectivesExamplesSpec.scala 21 | :snippet: "decodeRequest" 22 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/coding-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _CodingDirectives: 2 | 3 | CodingDirectives 4 | ================ 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | decodeRequest 10 | decodeRequestWith 11 | encodeResponse 12 | encodeResponseWith 13 | requestEncodedWith 14 | responseEncodingAccepted -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/coding-directives/requestEncodedWith.rst: -------------------------------------------------------------------------------- 1 | .. _-requestEncodedWith-: 2 | 3 | requestEncodedWith 4 | ================== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/CodingDirectives.scala 10 | :snippet: requestEncodedWith 11 | 12 | Description 13 | ----------- 14 | 15 | Passes the request to the inner route if the request is encoded with the argument encoding. Otherwise, rejects the request with an ``UnacceptedRequestEncodingRejection(encoding)``. 16 | 17 | This directive is the `building block`_ for ``decodeRequest`` to reject unsupported encodings. 18 | 19 | .. _`building block`: @github@/akka-http/src/main/scala/akka/http/scaladsl/server/directives/CodingDirectives.scala 20 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/coding-directives/responseEncodingAccepted.rst: -------------------------------------------------------------------------------- 1 | .. _-responseEncodingAccepted-: 2 | 3 | responseEncodingAccepted 4 | ======================== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/CodingDirectives.scala 10 | :snippet: responseEncodingAccepted 11 | 12 | Description 13 | ----------- 14 | 15 | Passes the request to the inner route if the request accepts the argument encoding. Otherwise, rejects the request with an ``UnacceptedResponseEncodingRejection(encoding)``. 16 | 17 | Example 18 | ------- 19 | 20 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/CodingDirectivesExamplesSpec.scala 21 | :snippet: responseEncodingAccepted 22 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/cookie-directives/cookie.rst: -------------------------------------------------------------------------------- 1 | .. _-cookie-: 2 | 3 | cookie 4 | ====== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/CookieDirectives.scala 10 | :snippet: cookie 11 | 12 | Description 13 | ----------- 14 | Extracts a cookie with a given name from a request or otherwise rejects the request with a ``MissingCookieRejection`` if 15 | the cookie is missing. 16 | 17 | Use the :ref:`-optionalCookie-` directive instead if you want to support missing cookies in your inner route. 18 | 19 | 20 | Example 21 | ------- 22 | 23 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/CookieDirectivesExamplesSpec.scala 24 | :snippet: cookie 25 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/cookie-directives/deleteCookie.rst: -------------------------------------------------------------------------------- 1 | .. _-deleteCookie-: 2 | 3 | deleteCookie 4 | ============ 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/CookieDirectives.scala 10 | :snippet: deleteCookie 11 | 12 | Description 13 | ----------- 14 | Adds a header to the response to request the removal of the cookie with the given name on the client. 15 | 16 | Use the :ref:`-setCookie-` directive to update a cookie. 17 | 18 | Example 19 | ------- 20 | 21 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/CookieDirectivesExamplesSpec.scala 22 | :snippet: deleteCookie 23 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/cookie-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _CookieDirectives: 2 | 3 | CookieDirectives 4 | ================ 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | cookie 10 | deleteCookie 11 | optionalCookie 12 | setCookie 13 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/cookie-directives/optionalCookie.rst: -------------------------------------------------------------------------------- 1 | .. _-optionalCookie-: 2 | 3 | optionalCookie 4 | ============== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/CookieDirectives.scala 10 | :snippet: optionalCookie 11 | 12 | Description 13 | ----------- 14 | Extracts an optional cookie with a given name from a request. 15 | 16 | Use the :ref:`-cookie-` directive instead if the inner route does not handle a missing cookie. 17 | 18 | 19 | Example 20 | ------- 21 | 22 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/CookieDirectivesExamplesSpec.scala 23 | :snippet: optionalCookie 24 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/cookie-directives/setCookie.rst: -------------------------------------------------------------------------------- 1 | .. _-setCookie-: 2 | 3 | setCookie 4 | ========= 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/CookieDirectives.scala 10 | :snippet: setCookie 11 | 12 | Description 13 | ----------- 14 | Adds a header to the response to request the update of the cookie with the given name on the client. 15 | 16 | Use the :ref:`-deleteCookie-` directive to delete a cookie. 17 | 18 | 19 | Example 20 | ------- 21 | 22 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/CookieDirectivesExamplesSpec.scala 23 | :snippet: setCookie 24 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/debugging-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _DebuggingDirectives: 2 | 3 | DebuggingDirectives 4 | =================== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | logRequest 10 | logRequestResult 11 | logResult 12 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/execution-directives/handleRejections.rst: -------------------------------------------------------------------------------- 1 | .. _-handleRejections-: 2 | 3 | handleRejections 4 | ================ 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/ExecutionDirectives.scala 10 | :snippet: handleRejections 11 | 12 | Description 13 | ----------- 14 | 15 | Using this directive is an alternative to using a global implicitly defined ``RejectionHandler`` that 16 | applies to the complete route. 17 | 18 | See :ref:`rejections-scala` for general information about options for handling rejections. 19 | 20 | Example 21 | ------- 22 | 23 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/ExecutionDirectivesExamplesSpec.scala 24 | :snippet: handleRejections 25 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/execution-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _ExecutionDirectives: 2 | 3 | ExecutionDirectives 4 | =================== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | handleExceptions 10 | handleRejections 11 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/file-upload-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _FileUploadDirectives: 2 | 3 | FileUploadDirectives 4 | ==================== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | uploadedFile 10 | fileUpload 11 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/form-field-directives/formField.rst: -------------------------------------------------------------------------------- 1 | .. _-formField-scala-: 2 | 3 | formField 4 | ========= 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/FormFieldDirectives.scala 10 | :snippet: formField 11 | 12 | Description 13 | ----------- 14 | Allows extracting a single Form field sent in the request. 15 | 16 | See :ref:`-formFields-` for an in-depth description. 17 | 18 | Example 19 | ------- 20 | 21 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/FormFieldDirectivesExamplesSpec.scala 22 | :snippet: formField 23 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/form-field-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _FormFieldDirectives: 2 | 3 | FormFieldDirectives 4 | =================== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | formField 10 | formFields 11 | formFieldSeq 12 | formFieldMap 13 | formFieldMultiMap -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/future-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _FutureDirectives: 2 | 3 | FuturesDirectives 4 | ================= 5 | 6 | Future directives can be used to run inner routes once the provided ``Future[T]`` has been completed. 7 | 8 | .. toctree:: 9 | :maxdepth: 1 10 | 11 | onComplete 12 | onCompleteWithBreaker 13 | onSuccess 14 | completeOrRecoverWith 15 | 16 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/header-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _HeaderDirectives: 2 | 3 | HeaderDirectives 4 | ================ 5 | 6 | Header directives can be used to extract header values from the request. To change 7 | response headers use one of the :ref:`RespondWithDirectives`. 8 | 9 | .. toctree:: 10 | :maxdepth: 1 11 | 12 | headerValue 13 | headerValueByName 14 | headerValueByType 15 | headerValuePF 16 | optionalHeaderValue 17 | optionalHeaderValueByName 18 | optionalHeaderValueByType 19 | optionalHeaderValuePF 20 | checkSameOrigin 21 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/host-directives/extractHost.rst: -------------------------------------------------------------------------------- 1 | .. _-extractHost-: 2 | 3 | extractHost 4 | =========== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/HostDirectives.scala 10 | :snippet: extractHost 11 | 12 | 13 | Description 14 | ----------- 15 | 16 | Extract the hostname part of the ``Host`` request header and expose it as a ``String`` extraction to its inner route. 17 | 18 | 19 | Example 20 | ------- 21 | 22 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/HostDirectivesExamplesSpec.scala 23 | :snippet: extractHost -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/host-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _HostDirectives: 2 | 3 | HostDirectives 4 | ============== 5 | 6 | HostDirectives allow you to filter requests based on the hostname part of the ``Host`` header 7 | contained in incoming requests as well as extracting its value for usage in inner routes. 8 | 9 | .. toctree:: 10 | :maxdepth: 1 11 | 12 | extractHost 13 | host 14 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/method-directives/get.rst: -------------------------------------------------------------------------------- 1 | .. _-get-: 2 | 3 | get 4 | === 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/MethodDirectives.scala 10 | :snippet: get 11 | 12 | Description 13 | ----------- 14 | Matches requests with HTTP method ``GET``. 15 | 16 | This directive filters the incoming request by its HTTP method. Only requests with 17 | method ``GET`` are passed on to the inner route. All others are rejected with a 18 | ``MethodRejection``, which is translated into a ``405 Method Not Allowed`` response 19 | by the default :ref:`RejectionHandler `. 20 | 21 | 22 | Example 23 | ------- 24 | 25 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/MethodDirectivesExamplesSpec.scala 26 | :snippet: get-method 27 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/method-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _MethodDirectives: 2 | 3 | MethodDirectives 4 | ================ 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | delete 10 | extractMethod 11 | get 12 | head 13 | method 14 | options 15 | overrideMethodWithParameter 16 | patch 17 | post 18 | put 19 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/method-directives/put.rst: -------------------------------------------------------------------------------- 1 | .. _-put-: 2 | 3 | put 4 | === 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/MethodDirectives.scala 10 | :snippet: put 11 | 12 | Description 13 | ----------- 14 | Matches requests with HTTP method ``PUT``. 15 | 16 | This directive filters the incoming request by its HTTP method. Only requests with 17 | method ``PUT`` are passed on to the inner route. All others are rejected with a 18 | ``MethodRejection``, which is translated into a ``405 Method Not Allowed`` response 19 | by the default :ref:`RejectionHandler `. 20 | 21 | Example 22 | ------- 23 | 24 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/MethodDirectivesExamplesSpec.scala 25 | :snippet: put-method 26 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/misc-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _MiscDirectives: 2 | 3 | MiscDirectives 4 | ============== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | extractClientIP 10 | rejectEmptyResponse 11 | requestEntityEmpty 12 | requestEntityPresent 13 | selectPreferredLanguage 14 | validate 15 | withoutSizeLimit 16 | withSizeLimit -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/misc-directives/requestEntityEmpty.rst: -------------------------------------------------------------------------------- 1 | .. _-requestEntityEmpty-: 2 | 3 | requestEntityEmpty 4 | ================== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/MiscDirectives.scala 10 | :snippet: requestEntityEmpty 11 | 12 | 13 | Description 14 | ----------- 15 | A filter that checks if the request entity is empty and only then passes processing to the inner route. 16 | Otherwise, the request is rejected. 17 | 18 | 19 | See also :ref:`-requestEntityPresent-` for the opposite effect. 20 | 21 | 22 | Example 23 | ------- 24 | 25 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/MiscDirectivesExamplesSpec.scala 26 | :snippet: requestEntityEmptyPresent-example 27 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/misc-directives/requestEntityPresent.rst: -------------------------------------------------------------------------------- 1 | .. _-requestEntityPresent-: 2 | 3 | requestEntityPresent 4 | ==================== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/MiscDirectives.scala 10 | :snippet: requestEntityPresent 11 | 12 | 13 | Description 14 | ----------- 15 | A simple filter that checks if the request entity is present and only then passes processing to the inner route. 16 | Otherwise, the request is rejected. 17 | 18 | See also :ref:`-requestEntityEmpty-` for the opposite effect. 19 | 20 | 21 | Example 22 | ------- 23 | 24 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/MiscDirectivesExamplesSpec.scala 25 | :snippet: requestEntityEmptyPresent-example 26 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/misc-directives/validate.rst: -------------------------------------------------------------------------------- 1 | .. _-validate-: 2 | 3 | validate 4 | ======== 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/MiscDirectives.scala 10 | :snippet: validate 11 | 12 | Description 13 | ----------- 14 | Allows validating a precondition before handling a route. 15 | 16 | Checks an arbitrary condition and passes control to the inner route if it returns ``true``. 17 | Otherwise, rejects the request with a ``ValidationRejection`` containing the given error message. 18 | 19 | Example 20 | ------- 21 | 22 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/MiscDirectivesExamplesSpec.scala 23 | :snippet: validate-example 24 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/parameter-directives/parameter.rst: -------------------------------------------------------------------------------- 1 | .. _-parameter-: 2 | 3 | parameter 4 | ========= 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/ParameterDirectives.scala 10 | :snippet: parameter 11 | 12 | Description 13 | ----------- 14 | Extracts a *query* parameter value from the request. 15 | 16 | See :ref:`-parameters-scala-` for a detailed description of this directive. 17 | 18 | See :ref:`which-parameter-directive` to understand when to use which directive. 19 | 20 | Example 21 | ------- 22 | 23 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/ParameterDirectivesExamplesSpec.scala 24 | :snippet: example-1 25 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/parameter-directives/parameterMap.rst: -------------------------------------------------------------------------------- 1 | .. _-parameterMap-: 2 | 3 | parameterMap 4 | ============ 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/ParameterDirectives.scala 10 | :snippet: parameterMap 11 | 12 | Description 13 | ----------- 14 | Extracts all parameters at once as a ``Map[String, String]`` mapping parameter names to parameter values. 15 | 16 | If a query contains a parameter value several times, the map will contain the last one. 17 | 18 | See also :ref:`which-parameter-directive` to understand when to use which directive. 19 | 20 | Example 21 | ------- 22 | 23 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/ParameterDirectivesExamplesSpec.scala 24 | :snippet: parameterMap 25 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/parameter-directives/parameterSeq.rst: -------------------------------------------------------------------------------- 1 | .. _-parameterSeq-: 2 | 3 | parameterSeq 4 | ============ 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/ParameterDirectives.scala 10 | :snippet: parameterSeq 11 | 12 | Description 13 | ----------- 14 | Extracts all parameters at once in the original order as (name, value) tuples of type ``(String, String)``. 15 | 16 | This directive can be used if the exact order of parameters is important or if parameters can occur several times. 17 | 18 | See :ref:`which-parameter-directive` to understand when to use which directive. 19 | 20 | Example 21 | ------- 22 | 23 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/ParameterDirectivesExamplesSpec.scala 24 | :snippet: parameterSeq 25 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/path-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _PathDirectives: 2 | 3 | PathDirectives 4 | ============== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | path 10 | pathEnd 11 | pathEndOrSingleSlash 12 | pathPrefix 13 | pathPrefixTest 14 | pathSingleSlash 15 | pathSuffix 16 | pathSuffixTest 17 | rawPathPrefix 18 | rawPathPrefixTest 19 | redirectToNoTrailingSlashIfPresent 20 | redirectToTrailingSlashIfMissing 21 | ../../path-matchers 22 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/range-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _RangeDirectives: 2 | 3 | RangeDirectives 4 | =============== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | withRangeSupport -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/respond-with-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _RespondWithDirectives: 2 | 3 | RespondWithDirectives 4 | ===================== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | respondWithDefaultHeader 10 | respondWithDefaultHeaders 11 | respondWithHeader 12 | respondWithHeaders 13 | respondWithHeaders -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/scheme-directives/extractScheme.rst: -------------------------------------------------------------------------------- 1 | .. _-extractScheme-: 2 | 3 | extractScheme 4 | ============= 5 | 6 | Signature 7 | --------- 8 | 9 | .. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/SchemeDirectives.scala 10 | :snippet: extractScheme 11 | 12 | Description 13 | ----------- 14 | Extracts the Uri scheme (i.e. "``http``", "``https``", etc.) for an incoming request. 15 | 16 | For rejecting a request if it doesn't match a specified scheme name, see the :ref:`-scheme-` directive. 17 | 18 | Example 19 | ------- 20 | 21 | .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/SchemeDirectivesExamplesSpec.scala 22 | :snippet: example-1 23 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/scheme-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _SchemeDirectives: 2 | 3 | SchemeDirectives 4 | ================ 5 | 6 | Scheme directives can be used to extract the Uri scheme (i.e. "http", "https", etc.) 7 | from requests or to reject any request that does not match a specified scheme name. 8 | 9 | .. toctree:: 10 | :maxdepth: 1 11 | 12 | extractScheme 13 | scheme 14 | -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/timeout-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _TimeoutDirectives: 2 | 3 | TimeoutDirectives 4 | ================= 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | withRequestTimeout 10 | withoutRequestTimeout 11 | withRequestTimeoutResponse -------------------------------------------------------------------------------- /rst/scala/http/routing-dsl/directives/websocket-directives/index.rst: -------------------------------------------------------------------------------- 1 | .. _WebSocketDirectives: 2 | 3 | WebSocketDirectives 4 | =================== 5 | 6 | .. toctree:: 7 | :maxdepth: 1 8 | 9 | handleWebSocketMessages 10 | handleWebSocketMessagesForProtocol -------------------------------------------------------------------------------- /rst/scala/index-actors.rst: -------------------------------------------------------------------------------- 1 | Actors 2 | ====== 3 | 4 | .. toctree:: 5 | :maxdepth: 2 6 | 7 | actors 8 | typed 9 | fault-tolerance 10 | dispatchers 11 | mailboxes 12 | routing 13 | fsm 14 | persistence 15 | persistence-schema-evolution 16 | persistence-query 17 | persistence-query-leveldb 18 | testing 19 | actordsl 20 | typed-actors 21 | -------------------------------------------------------------------------------- /rst/scala/index-futures.rst: -------------------------------------------------------------------------------- 1 | Futures and Agents 2 | ================== 3 | 4 | .. toctree:: 5 | :maxdepth: 2 6 | 7 | futures 8 | agents 9 | -------------------------------------------------------------------------------- /rst/scala/index-network.rst: -------------------------------------------------------------------------------- 1 | Networking 2 | ========== 3 | 4 | .. toctree:: 5 | :maxdepth: 2 6 | 7 | ../common/cluster 8 | cluster-usage 9 | cluster-singleton 10 | distributed-pub-sub 11 | cluster-client 12 | cluster-sharding 13 | cluster-metrics 14 | distributed-data 15 | remoting 16 | remoting-artery 17 | serialization 18 | io 19 | io-tcp 20 | io-udp 21 | camel 22 | -------------------------------------------------------------------------------- /rst/scala/index-utilities.rst: -------------------------------------------------------------------------------- 1 | Utilities 2 | ========= 3 | 4 | .. toctree:: 5 | :maxdepth: 2 6 | 7 | event-bus 8 | logging 9 | scheduler 10 | ../common/duration 11 | ../common/circuitbreaker 12 | extending-akka 13 | ../intro/deployment-scenarios 14 | 15 | -------------------------------------------------------------------------------- /rst/scala/stream/index.rst: -------------------------------------------------------------------------------- 1 | .. _streams-scala: 2 | 3 | Streams 4 | ======= 5 | 6 | .. toctree:: 7 | :maxdepth: 2 8 | 9 | stream-introduction 10 | stream-quickstart 11 | ../../general/stream/stream-design 12 | stream-flows-and-basics 13 | stream-graphs 14 | stream-composition 15 | stream-rate 16 | stream-dynamic 17 | stream-customize 18 | stream-integrations 19 | stream-error 20 | stream-io 21 | stream-parallelism 22 | stream-testkit 23 | stages-overview 24 | stream-cookbook 25 | ../../general/stream/stream-configuration 26 | migration-guide-1.0-2.x-scala 27 | migration-guide-2.0-2.4-scala 28 | -------------------------------------------------------------------------------- /rst/scala/stream/migration-guide-1.0-2.x-scala.rst: -------------------------------------------------------------------------------- 1 | .. _migration-2.0-scala: 2 | 3 | ########################## 4 | Migration Guide 1.0 to 2.x 5 | ########################## 6 | 7 | For this migration guide see `the documentation for Akka Streams 2.0`_. 8 | 9 | .. _`the documentation for Akka Streams 2.0`: http://doc.akka.io/docs/akka-stream-and-http-experimental/2.0.2/scala/migration-guide-1.0-2.x-scala.html 10 | -------------------------------------------------------------------------------- /rst/scala/testkit-example.rst: -------------------------------------------------------------------------------- 1 | .. _testkit-example: 2 | 3 | ######################## 4 | TestKit Example 5 | ######################## 6 | 7 | Ray Roestenburg's example code from `his blog `_ adapted to work with Akka 2.x. 8 | 9 | .. includecode:: code/docs/testkit/TestKitUsageSpec.scala#testkit-usage 10 | 11 | -------------------------------------------------------------------------------- /src/main/protobuf/FlightAppModels.proto: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright (C) 2014-2015 Lightbend Inc. 3 | */ 4 | package docs.persistence; 5 | 6 | //#protobuf-read-optional-proto 7 | // FlightAppModels.proto 8 | option java_package = "docs.persistence.proto"; 9 | option optimize_for = SPEED; 10 | 11 | message SeatReserved { 12 | required string letter = 1; 13 | required uint32 row = 2; 14 | optional string seatType = 3; // the new field 15 | } 16 | //#protobuf-read-optional-proto 17 | -------------------------------------------------------------------------------- /src/main/protobuf/TwoPhaseSetMessages.proto: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright (C) 2014-2015 Lightbend Inc. 3 | */ 4 | package docs.ddata; 5 | 6 | //#twophaseset 7 | option java_package = "docs.ddata.protobuf.msg"; 8 | option optimize_for = SPEED; 9 | 10 | message TwoPhaseSet { 11 | repeated string adds = 1; 12 | repeated string removals = 2; 13 | } 14 | //#twophaseset 15 | 16 | //#twophaseset2 17 | message TwoPhaseSet2 { 18 | optional bytes adds = 1; 19 | optional bytes removals = 2; 20 | } 21 | //#twophaseset2 22 | 23 | 24 | 25 | -------------------------------------------------------------------------------- /src/test/resources/application.conf: -------------------------------------------------------------------------------- 1 | akka.loggers = ["akka.testkit.TestEventListener"] 2 | --------------------------------------------------------------------------------