Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update execution-and-routing.md #99

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Update execution-and-routing.md #99

wants to merge 1 commit into from

Conversation

awoods
Copy link
Member

@awoods awoods commented Jan 16, 2017

Minor grammar edit.

Minor grammar edit.
@@ -123,7 +123,7 @@ The generic endpoint proxy sends the request to the service:
Accept: */*
User-Agent: whatever
Apix-Ldp-Resource: http://fedora01.backend.local/repository/foo/
Apix-Exposed-Uri: http://archive.example.org/services/foo/svc:Thumbnail/
Apix-Exposed-Uri: http://archive.example.org/services/foo/svc:Thumbnail/small
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually, the former is correct. Apix-Exposed-Uri is just the exposed endpoint, so it'll never change. The use case in the text is "a service may use this as a base URI when formulating a response that contains hypertext or links". So if a service generates links to resources within itself (e.g. small, or a/b/c/d, it can represent those links as relative URIs as -is, or use Apix-Exposed-Uri as a baseuri to construct absolute URIs like http://archive.example.org/services/foo/svc:Thumbnail/a/b/c/d.

As an example, suppose a service generates RDF as N-triples. The N-triples format requires absolute URIs, so they'd need to be constructed as ${Apix-Exposed-Uri}/relative/uri before serializing.

@awoods
Copy link
Member Author

awoods commented Jan 18, 2017

Thanks for the explanation, @birkland.
I have removed that commit from this PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants