import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
public void setOfflineMap(String mapname) throws FileNotFoundException {
	mFile = new File(Environment.getExternalStorageDirectory(), "/" + mapname);
	
	if (!mFile.exists()) {
		throw new FileNotFoundException();
	}
	
	MapTileModuleProviderBase treasureMapModuleProvider = new MapTileFileArchiveProvider(new SimpleRegisterReceiver(mContext), 
			mTreasureMapTileSource, new IArchiveFile[] { MBTilesFileArchive.getDatabaseFileArchive(mFile) });
	 
	MapTileProviderBase treasureMapProvider = new MapTileProviderArray(mTreasureMapTileSource, null,
			new MapTileModuleProviderBase[] { treasureMapModuleProvider });
	 
	TilesOverlay treasureMapTilesOverlay = new TilesOverlay(treasureMapProvider, mContext);
	treasureMapTilesOverlay.setLoadingBackgroundColor(Color.TRANSPARENT);
	 
	mMap.getOverlays().add(treasureMapTilesOverlay);	
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
@Override
public void detach() {

	synchronized (mTileProviderList) {
		for (final MapTileModuleProviderBase tileProvider : mTileProviderList) {
			tileProvider.detach();

		}
	}

	mTileCache.clear();
	synchronized (mWorking) {
		mWorking.clear();
	}
	clearTileCache();
	if (mRegisterReceiver!=null) {
		mRegisterReceiver.destroy();
		mRegisterReceiver = null;
	}
	super.detach();
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
@Override
public void mapTileRequestExpiredTile(MapTileRequestState aState, Drawable aDrawable) {
	// Call through to the super first so aState.getCurrentProvider() still contains the proper
	// provider.
	super.mapTileRequestExpiredTile(aState, aDrawable);

	// Continue through the provider chain
	final MapTileModuleProviderBase nextProvider = findNextAppropriateProvider(aState);
	if (nextProvider != null) {
		nextProvider.loadMapTileAsync(aState);
	} else {
		synchronized (mWorking) {
			mWorking.remove(aState.getMapTile());
		}
	}
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
/**
 * We want to not use a provider that doesn't exist anymore in the chain, and we want to not use
 * a provider that requires a data connection when one is not available.
 */
protected MapTileModuleProviderBase findNextAppropriateProvider(final MapTileRequestState aState) {
	MapTileModuleProviderBase provider = null;
	boolean providerDoesntExist = false, providerCantGetDataConnection = false, providerCantServiceZoomlevel = false;
	// The logic of the while statement is
	// "Keep looping until you get null, or a provider that still exists
	// and has a data connection if it needs one and can service the zoom level,"
	do {
		provider = aState.getNextProvider();
		// Perform some checks to see if we can use this provider
		// If any of these are true, then that disqualifies the provider for this tile request.
		if (provider != null) {
			providerDoesntExist = !this.getProviderExists(provider);
			providerCantGetDataConnection = !useDataConnection()
					&& provider.getUsesDataConnection();
			int zoomLevel = aState.getMapTile().getZoomLevel();
			providerCantServiceZoomlevel = zoomLevel > provider.getMaximumZoomLevel()
					|| zoomLevel < provider.getMinimumZoomLevel();
		}
	} while ((provider != null)
			&& (providerDoesntExist || providerCantGetDataConnection || providerCantServiceZoomlevel));
	return provider;
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
@Override
public void mapTileRequestExpiredTile(MapTileRequestState aState, Drawable aDrawable) {
    // Call through to the super first so aState.getCurrentProvider() still contains the proper
    // provider.
    super.mapTileRequestExpiredTile(aState, aDrawable);

    // Continue through the provider chain
    final MapTileModuleProviderBase nextProvider = findNextAppropriateProvider(aState);
    if (nextProvider != null) {
        nextProvider.loadMapTileAsync(aState);
    } else {
        //synchronized (mWorking) {
            mWorking.remove(aState.getMapTile());
        //}
    }
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
/**
 * We want to not use a provider that doesn't exist anymore in the chain, and we want to not use
 * a provider that requires a data connection when one is not available.
 */
protected MapTileModuleProviderBase findNextAppropriateProvider(final MapTileRequestState aState) {
    MapTileModuleProviderBase provider = null;
    boolean providerDoesntExist = false, providerCantGetDataConnection = false, providerCantServiceZoomlevel = false;
    // The logic of the while statement is
    // "Keep looping until you get null, or a provider that still exists
    // and has a data connection if it needs one and can service the zoom level,"
    do {
        provider = aState.getNextProvider();
        // Perform some checks to see if we can use this provider
        // If any of these are true, then that disqualifies the provider for this tile request.
        if (provider != null) {
            providerDoesntExist = !this.getProviderExists(provider);
            providerCantGetDataConnection = !useDataConnection()
                    && provider.getUsesDataConnection();
            int zoomLevel = aState.getMapTile().getZoomLevel();
            providerCantServiceZoomlevel = zoomLevel > provider.getMaximumZoomLevel()
                    || zoomLevel < provider.getMinimumZoomLevel();
        }
    } while ((provider != null)
            && (providerDoesntExist || providerCantGetDataConnection || providerCantServiceZoomlevel));
    return provider;
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
/**
 * Build a new TileProvider that looks into the local filesystem for tiles.
 *
 * @param mapName The name of the map which is stored in the assets/<mapName> directory
 * @return the tile provider
 */
public MapTileProviderBase buildAssetTileProvider(final String mapName) {
    final NicTileSource tileSource = getTileSource(mapName);
    final IRegisterReceiver registerReceiver = new SimpleRegisterReceiver(context);
    final AssetTileProvider assetProvider = new AssetTileProvider(
            registerReceiver, tileSource, context.getAssets()
    );

    final MapTileProviderArray mapTileProviderArray = new MapTileProviderArray(tileSource, registerReceiver,
            new MapTileModuleProviderBase[]{
                    //here you can configure more than one provider...
                    assetProvider
            });
    return mapTileProviderArray;
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
/**
 * Build a new TileProvider that download the tiles from a server. These tiles
 * will be stored (cached) in the local file system.
 *
 * @param urlSchema the url schema for the map tiles
 * @param mapName   The name of the requested map.
 * @return the tile provider
 */
public MapTileProviderBase buildWebTileProvider(final String urlSchema, final String mapName) {
    final ITileSource tileSource = getNicTileSource(urlSchema, mapName);
    final MapTileDownloader downloaderProvider = getMapTileDownloader(tileSource);
    final IRegisterReceiver registerReceiver = new SimpleRegisterReceiver(context);
    final MapTileFilesystemProvider fileSystemProvider =
            new MapTileFilesystemProvider(registerReceiver, tileSource);
    final MapTileProviderArray mapTileProviderArray = new MapTileProviderArray(tileSource, registerReceiver,
            new MapTileModuleProviderBase[]{
                    fileSystemProvider,    //erst wird der cache verwendet
                    downloaderProvider    //...und wenn es nötig ist im netz
            });
    return mapTileProviderArray;
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
/**
 * Creates an {@link MapTileProviderArray} with the specified tile providers.
 *
 * @param aRegisterReceiver
 *            a {@link IRegisterReceiver}
 * @param pTileProviderArray
 *            an array of {@link MapTileModuleProviderBase}
 */
public MapTileProviderArray(final ITileSource pTileSource,
		final IRegisterReceiver aRegisterReceiver,
		final MapTileModuleProviderBase[] pTileProviderArray) {
	super(pTileSource);

	mWorking = new HashMap<MapTile, MapTileRequestState>();
	mRegisterReceiver=aRegisterReceiver;
	mTileProviderList = new ArrayList<MapTileModuleProviderBase>();
	Collections.addAll(mTileProviderList, pTileProviderArray);
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
@Override
public Drawable getMapTile(final MapTile pTile) {
	final Drawable tile = mTileCache.getMapTile(pTile);
	if (tile != null) {
		if (ExpirableBitmapDrawable.getState(tile) == ExpirableBitmapDrawable.UP_TO_DATE) {
			return tile; // best scenario ever
		}
		if (isDowngradedMode()) {
			return tile; // best we can, considering
		}
	}
	if (mWorking.containsKey(pTile)) { // already in progress
		return tile;
	}

	if (Configuration.getInstance().isDebugTileProviders()) {
		Log.d(IMapView.LOGTAG,"MapTileProviderArray.getMapTile() requested but not in cache, trying from async providers: "
				+ pTile);
	}

	final MapTileRequestState state = new MapTileRequestState(pTile, mTileProviderList, this);

	synchronized (mWorking) {
		// Check again
		if (mWorking.containsKey(pTile)) {
			return tile;
		}
		mWorking.put(pTile, state);
	}

	final MapTileModuleProviderBase provider = findNextAppropriateProvider(state);
	if (provider != null) {
		provider.loadMapTileAsync(state);
	} else {
		mapTileRequestFailed(state);
	}
	return tile;
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
@Override
public void mapTileRequestFailed(final MapTileRequestState aState) {
	final MapTileModuleProviderBase nextProvider = findNextAppropriateProvider(aState);
	if (nextProvider != null) {
		nextProvider.loadMapTileAsync(aState);
	} else {
		synchronized (mWorking) {
			mWorking.remove(aState.getMapTile());
		}
		super.mapTileRequestFailed(aState);
	}
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
@Override
public int getMinimumZoomLevel() {
	int result = microsoft.mappoint.TileSystem.getMaximumZoomLevel();
	synchronized (mTileProviderList) {
		for (final MapTileModuleProviderBase tileProvider : mTileProviderList) {
			if (tileProvider.getMinimumZoomLevel() < result) {
				result = tileProvider.getMinimumZoomLevel();
			}
		}
	}
	return result;
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
@Override
public int getMaximumZoomLevel() {
	int result = OpenStreetMapTileProviderConstants.MINIMUM_ZOOMLEVEL;
	synchronized (mTileProviderList) {
		for (final MapTileModuleProviderBase tileProvider : mTileProviderList) {
			if (tileProvider.getMaximumZoomLevel() > result) {
				result = tileProvider.getMaximumZoomLevel();
			}
		}
	}
	return result;
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
@Override
public void setTileSource(final ITileSource aTileSource) {
	super.setTileSource(aTileSource);

	synchronized (mTileProviderList) {
		for (final MapTileModuleProviderBase tileProvider : mTileProviderList) {
			tileProvider.setTileSource(aTileSource);
			clearTileCache();
		}
	}
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
/**
 * @deprecated use {@link MapTileRequestState#MapTileRequestState(MapTile, List, IMapTileProviderCallback)}  instead
 */
@Deprecated
public MapTileRequestState(final MapTile mapTile,
						   final MapTileModuleProviderBase[] providers,
						   final IMapTileProviderCallback callback) {
	mProviderQueue = new ArrayList<>();
	Collections.addAll(mProviderQueue, providers);
	mMapTile = mapTile;
	mCallback = callback;
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
@Override
public void addOverlays() {
    this.mMapView.setUseDataConnection(false);
    MapTileAssetsProvider prov = new MapTileAssetsProvider(new SimpleRegisterReceiver(getContext()  ), getActivity().getAssets());

    this.mMapView.setTileProvider(new MapTileProviderArray(TileSourceFactory.MAPNIK, new SimpleRegisterReceiver(getContext()), new MapTileModuleProviderBase[]{ prov }));
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
@Override
public void addOverlays() {
    mMapView.setUseDataConnection(false);

    final ScaleBarOverlay scaleBarOverlay = new ScaleBarOverlay(mMapView);
    scaleBarOverlay.setCentred(true);
    scaleBarOverlay.setScaleBarOffset(200, 10);
    mMapView.getOverlays().add(scaleBarOverlay);

    final ITileSource tileSource = new XYTileSource(
            "Abstract", 0, 29, 256, ".png", new String[]{"http://localhost/"}, "abstract data");
    mMapView.setUseDataConnection(false);

    final MapTileAssetsProvider assetsProvider = new MapTileAssetsProvider(new SimpleRegisterReceiver(getContext()), getActivity().getAssets(), tileSource);

    final MapTileApproximater approximationProvider = new MapTileApproximater();
    approximationProvider.addProvider(assetsProvider);

    final MapTileProviderArray array = new MapTileProviderArray(
            tileSource, new SimpleRegisterReceiver(getContext()),
            new MapTileModuleProviderBase[]{assetsProvider, approximationProvider});

    mMapView.setTileProvider(array);

    mMapView.getController().setZoom(29.);
    // cf. https://fr.wikipedia.org/wiki/Point_z%C3%A9ro_des_routes_de_France
    // In English: starting point of all French roads
    mMapView.setExpectedCenter(new GeoPoint(48.85340215825712, 2.348784611094743));
    mMapView.invalidate();
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
@Override
public void detach() {
        for (final MapTileModuleProviderBase tileProvider : mTileProviderList) {
            tileProvider.detach();
        }
    mWorking.clear();
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
@Override
public void mapTileRequestFailed(final MapTileRequestState pState) {
	final MapTileModuleProviderBase nextProvider = findNextAppropriateProvider(pState);
	if (nextProvider != null) {
		nextProvider.loadMapTileAsync(pState);
	} else {
		final MapTile tile = pState.getMapTile();
		// synchronized (mWorking) {
		mWorking.remove(tile);
		// }
		super.mapTileRequestFailed(pState);
	}
}
 

import org.osmdroid.tileprovider.modules.MapTileModuleProviderBase; //导入依赖的package包/类
@Override
public int getMinimumZoomLevel() {
	int result = MAXIMUM_ZOOMLEVEL;
	//synchronized (mTileProviderList) {
		for (final MapTileModuleProviderBase tileProvider : mTileProviderList) {
			if (tileProvider.getMinimumZoomLevel() < result) {
				result = tileProvider.getMinimumZoomLevel();
			}
		}
	//}
	return result;
}