Before you start adding any extension code or configs, make sure that you can start the Deployer via Eclipse.  It will significantly boost your productivity.

Once you can hit the default /httpupload URL, set up a Publishing Target in your dev/test Tridion instance that points to your Eclipse Deployer:

Make sure you get stuff publishing successfully before you go forward with configuring/building Storage Extensions.  Another approach is to follow Jaime’s suggestion, which is to place a test package into the Deployer’s incoming directory and work independently from the CM.  Read more about that here: http://sdltridionworld.com/articles/sdltridion2011/tutorials/Deployer_Extensions_With_Eclipse_2.aspx.

Just to show what is possible, here is the publisher configured to point to my Eclipse Http Upload with a breakpoint hit in my custom Storage Extension when publishing a test.html page:

Before I jump into the code, I have to give Mihai some credit for posting his tutorial. Respek yo!  I conveniently printed all 3 chapters into PDF and was able to get most of this stuff figured out on the plane.  Here is a link to the tutorial: http://sdltridionworld.com/articles/sdltridion2011/tutorials/extending-content-delivery-storage-sdltridion-2011-1.aspx.  Also, please visit his blog after you read this (http://yatb.mitza.net/).  He’s addicted to staring at his Google Analytics console monitoring page hits, so please give him the satisfaction of seeing +1 from your visit.

Another useful article demonstrating a very cool use case is from Will regarding CDN integration.  So have a read: http://sdltridionworld.com/community/2011_extensions/cdn_integration.aspx.  Note, this is written for 2011 GA and the “com.tridion.storage” package name didn’t seem like a pre-requisite requirement in that release.

Alright, enough yammering.  Here is the boilerplate:

package com.tridion.storage.extension;

import java.io.File;
import java.util.Collection;

import com.tridion.broker.StorageException;
import com.tridion.data.CharacterData;
import com.tridion.storage.filesystem.FSEntityManager;
import com.tridion.storage.filesystem.FSPageDAO;

import org.springframework.context.annotation.Scope;
import org.springframework.stereotype.Component;

@Component("BoilerplateFSPageDAO")
@Scope("prototype")
public class BoilerplateFSPageDAO extends FSPageDAO {

	public BoilerplateFSPageDAO(String storageId, String storageName, File storageLocation) {
		super(storageId, storageName, storageLocation);
		// TODO Auto-generated constructor stub
	}
	
	public BoilerplateFSPageDAO(String storageId, String storageName, File storageLocation, FSEntityManager fsEntityManager) {
		super(storageId, storageName, storageLocation);
		// TODO Auto-generated constructor stub
	}


	@Override
	public void create(CharacterData page, String relativePath) throws StorageException {
		// TODO Auto-generated method stub
		super.create(page, relativePath);
	}

	@Override
	public Collection findAll(int publicationId) throws StorageException {
		// TODO Auto-generated method stub
		return super.findAll(publicationId);
	}

	@Override
	public CharacterData findByPrimaryKey(int publicationId, int pageId)
			throws StorageException {
		// TODO Auto-generated method stub
		return super.findByPrimaryKey(publicationId, pageId);
	}
	


	@Override
	public void remove(int publicationId, int pageId, String relativePath) throws StorageException {
		// TODO Auto-generated method stub
		super.remove(publicationId, pageId, relativePath);
		
	}

	@Override
	public void update(CharacterData page, String originalRelativePath, String newRelativePath)
			throws StorageException {
		// TODO Auto-generated method stub
		super.update(page, originalRelativePath, newRelativePath);
	}	
}

Also here is a boilerplate for Component Presentations published to the Broker DB:

package com.tridion.storage.extension;

import javax.persistence.EntityManager;
import javax.persistence.EntityManagerFactory;

import com.tridion.broker.StorageException;
import com.tridion.storage.ComponentPresentation;
import com.tridion.storage.dao.ComponentPresentationDAO;
import com.tridion.storage.persistence.JPAComponentPresentationDAO;
import com.tridion.storage.util.ComponentPresentationTypeEnum;

import org.springframework.context.annotation.Scope;
import org.springframework.stereotype.Component;

@Component("BoilerplateJPAComponentPresentationDAO")
@Scope("prototype")
public class BoilerplateJPAComponentPresentationDAO extends JPAComponentPresentationDAO implements ComponentPresentationDAO {

	

	public BoilerplateJPAComponentPresentationDAO(String storageId,
			EntityManagerFactory entityManagerFactory, String storageType) {
		super(storageId, entityManagerFactory, storageType);
		// TODO Auto-generated constructor stub
	}

	public BoilerplateJPAComponentPresentationDAO(String storageId,
			EntityManagerFactory entityManagerFactory,
			EntityManager entityManager, String storageType) {
		super(storageId, entityManagerFactory, entityManager, storageType);
		// TODO Auto-generated constructor stub
	}

	@Override
	public void create(ComponentPresentation itemToCreate,
			ComponentPresentationTypeEnum componentPresentationType)
			throws StorageException {
		// TODO Auto-generated method stub
		super.create(itemToCreate, componentPresentationType);
	}

	@Override
	public void remove(ComponentPresentation itemToRemove,
			ComponentPresentationTypeEnum componentPresentationType)
			throws StorageException {
		// TODO Auto-generated method stub
		super.remove(itemToRemove, componentPresentationType);
	}

	@Override
	public void remove(int publicationId, int componentId,
			int componentTemplateId,
			ComponentPresentationTypeEnum componentPresentationType)
			throws StorageException {
		// TODO Auto-generated method stub
		super.remove(publicationId, componentId, componentTemplateId,
				componentPresentationType);
	}

	@Override
	public void update(ComponentPresentation itemToUpdate,
			ComponentPresentationTypeEnum componentPresentationType)
			throws StorageException {
		// TODO Auto-generated method stub
		super.update(itemToUpdate, componentPresentationType);
	}
}

Finally here is my bundle XML file. Don’t forget to reference it in cd_storage_conf.xml:

<?xml version="1.0" encoding="UTF-8"?>
<StorageDAOBundles>
	<StorageDAOBundle type="filesystem">
		<StorageDAO typeMapping="Page"
			class="com.tridion.storage.extension.BoilerplateFSPageDAO" />
	</StorageDAOBundle>
	<StorageDAOBundle type="persistence">
		<StorageDAO typeMapping="ComponentPresentation"
			class="com.tridion.storage.extension.BoilerplateJPAComponentPresentationDAO" />
	</StorageDAOBundle>
</StorageDAOBundles>