https://github.com/ptv-logistics/xserveraspproxy
Relay PTV xServer Requests in your ASP.NET Middleware
https://github.com/ptv-logistics/xserveraspproxy
ptv-xserver
Last synced: 3 months ago
JSON representation
Relay PTV xServer Requests in your ASP.NET Middleware
- Host: GitHub
- URL: https://github.com/ptv-logistics/xserveraspproxy
- Owner: ptv-logistics
- Created: 2015-03-25T19:15:49.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2020-06-13T08:19:49.000Z (over 5 years ago)
- Last Synced: 2025-02-16T01:43:51.962Z (8 months ago)
- Topics: ptv-xserver
- Language: HTML
- Homepage:
- Size: 278 KB
- Stars: 0
- Watchers: 13
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# XServerAspProxy
#### Relay PTV xServer Requests in your ASP.NET Middleware
This can be useful when accessing xServer behind a firewall, allow cross-domain and cross-scheme calls,
add some load-balancing or fail-over, tile-caching, etc.
You can also use your own authorization or inject xServer credentials inside the middleware.
For example, you can add your xserver internet token and don't have to expose it in JavaScript.
The web-client can still use xServer in exactly same way as it does for a direct access. See here for more infos: http://xserver.ptvgroup.com/en-uk/cookbook/best-practices/xserver-internet-with-different-frontend-architectures/
The JavaScript sample-code is based on https://github.com/ptv-logistics/PoiLocator, but all calls go
through the XServerProxy.ashx rather than calling xServer internet directly.
For more samples with xServer in combination with ASP.NET, you should also take a look at
https://github.com/ptv-logistics/WebFormsMap or https://github.com/ptv-logistics/SpatialTutorial.
To use this code with xServer internet, you need an xServer internet subscription.
Go to http://xserver.ptvgroup.com/en-uk/products/ptv-xserver-internet/test/ to get a trial token.
## How the sample works
This is a javascript/ASP.NET sample that loads some data from an ASP page and does some geographic visualizations
and operations on it. For map-display and geographic operations PTV xServer is used. Unlike the
other xServer/JavaScript samples, the xServer isn't accessed directly from the client, but through the
middleware that hosts the web page.
## To use this code in your own project
1. Add the the XServerProxy handler code to your ASP.NET project
2. Add a rewrite rule in your [Web.config](https://github.com/ptv-logistics/XServerAspProxy/blob/master/Web.config#L14-L17) (_requires ARR & IIS rewrite module_)
3. Adapt the code for your xServer infrasctructure. I've added sample for
[xServer on-premise](https://github.com/ptv-logistics/XServerAspProxy/blob/master/XServerProxy.ashx.cs#L75-L93)
and [xServer internet](https://github.com/ptv-logistics/XServerAspProxy/blob/master/XServerProxy.ashx.cs#L62-L73)
3. Make your xServer internet requests with the relative url, like */XServerProxy/WMS/WMS* or
*/XServerProxy/xlocate/rs/XLocate/findAddressByText*.